API Reference

The RougeChain node exposes a REST API on the configured --api-port (default: 5100).

Base URL

http://127.0.0.1:5100/api

For the public testnet:

https://testnet.rougechain.io/api

Endpoints Overview

System

EndpointMethodDescription
/api/healthGETNode health check
/api/statsGETNetwork statistics

Blockchain

EndpointMethodDescription
/api/blocksGETGet all blocks
/api/blocks/summaryGETBlock summary for charts
/api/txsGETGet transactions

Wallet

EndpointMethodDescription
/api/wallet/createPOSTCreate new wallet
/api/balance/:publicKeyGETGet balance
/api/faucetPOSTRequest testnet tokens
/api/tx/submitPOSTSubmit transaction

Staking

EndpointMethodDescription
/api/validatorsGETList validators
/api/stake/submitPOSTStake tokens
/api/unstake/submitPOSTUnstake tokens

Tokens

EndpointMethodDescription
/api/token/createPOSTCreate custom token
/api/burn-addressGETGet official burn address
/api/burnedGETGet burned token stats

AMM/DEX

EndpointMethodDescription
/api/poolsGETList liquidity pools
/api/pool/:pool_idGETGet pool details
/api/pool/:pool_id/pricesGETGet price history
/api/pool/:pool_id/eventsGETGet pool events
/api/pool/:pool_id/statsGETGet pool statistics
/api/pool/createPOSTCreate liquidity pool
/api/pool/add-liquidityPOSTAdd liquidity
/api/pool/remove-liquidityPOSTRemove liquidity
/api/swap/quotePOSTGet swap quote
/api/swap/executePOSTExecute swap

Secure v2 API (Client-Side Signing)

All v2 endpoints accept pre-signed transactions. Private keys never leave the client.

EndpointMethodDescription
/api/v2/transferPOSTTransfer tokens
/api/v2/token/createPOSTCreate token
/api/v2/pool/createPOSTCreate pool
/api/v2/pool/add-liquidityPOSTAdd liquidity
/api/v2/pool/remove-liquidityPOSTRemove liquidity
/api/v2/swap/executePOSTExecute swap
/api/v2/stakePOSTStake tokens
/api/v2/unstakePOSTUnstake tokens
/api/v2/faucetPOSTRequest faucet

P2P

EndpointMethodDescription
/api/peersGETList known peers
/api/peers/registerPOSTRegister as peer
/api/blocks/importPOSTImport block from peer
/api/tx/broadcastPOSTReceive broadcasted tx

Messenger

EndpointMethodDescription
/api/messenger/walletsGETList messenger wallets
/api/messenger/wallets/registerPOSTRegister wallet
/api/messenger/conversationsGET/POSTConversations
/api/messenger/messagesGET/POSTMessages
/api/messenger/messages/readPOSTMark message as read (self-destruct)

Mail

EndpointMethodDescription
/api/names/registerPOSTRegister a mail name
/api/names/lookupGETLook up a name's public keys
/api/names/reverseGETReverse lookup (public key → name)
/api/mail/sendPOSTSend encrypted mail
/api/mail/inboxGETGet inbox
/api/mail/sentGETGet sent mail
/api/mail/trashGETGet trashed mail
/api/mail/message/:idGETGet single mail item
/api/mail/readPOSTMark mail as read
/api/mail/movePOSTMove mail to folder
/api/mail/:idDELETEDelete mail permanently

Authentication

Some endpoints require an API key (if configured on the node):

curl -H "X-API-Key: your-api-key" https://testnet.rougechain.io/api/stats

Rate Limiting

Default limits:

  • Read endpoints: 120 requests/minute
  • Write endpoints: 30 requests/minute

Rate limit headers are included in responses:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115