Cosmos RPC Proxy

JSON-RPC 2.0 proxy to the Cosmos RPC of a supported Cosmos chain. The request and response follow the standard JSON-RPC 2.0 specification.

Only a limited set of RPC methods is supported:

• status — fetch the node status. params must be {}.
• abci_query — query application state. params must include data (string), path (string), and prove (boolean). Allowed path values:
  • /cosmos.auth.v1beta1.Query/Account
  • /cosmos.bank.v1beta1.Query/AllBalances
  • /cosmos.tx.v1beta1.Service/Simulate
• broadcast_tx_sync — broadcast a signed transaction. params must contain a single tx field (string).
• tx_search — search for transactions. params must include page (string, only "1" is allowed) and query (string, must match tx.hash='<64-hex>').

Any other method or unsupported parameter shape returns a 400 error.

POST /api/rpc/{chainId}

Cosmos RPC Proxy

cURL

curl --request POST \
  --url https://router-api.initia.xyz/api/rpc/{chainId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "method": "abci_query",
  "params": {
    "data": "0a14...",
    "path": "/cosmos.bank.v1beta1.Query/AllBalances",
    "prove": false
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

Path Parameters

chainId · string · required

Cosmos chain ID to proxy the RPC call to.

Body

application/json

id · integer · required

JSON-RPC request ID.

method · enum<string> · required

RPC method name.

Available options: status, abci_query, broadcast_tx_sync, tx_search

params · object · required

RPC method parameters. The expected shape depends on method.

Response

200

application/json

Successful response

jsonrpc · string

JSON-RPC protocol version.

id · integer

Echoed request ID.

result · object

RPC method result.