Cosmos - JSON-RPC

JSON-RPC methods supported on Cosmos Mainnet and Cosmos Testnet through Tatum RPC Gateway, with base URLs and an example request.

Call Cosmos JSON-RPC methods through Tatum RPC Gateway. Send an HTTP POST request with a JSON-RPC 2.0 body to the network's base URL, with your API key in the x-api-key header. See Authentication.

Base URLs

NetworkBase URL
Cosmos Mainnethttps://cosmos-mainnet.gateway.tatum.io/tendermint
Cosmos Testnethttps://cosmos-testnet.gateway.tatum.io/tendermint

Example request

curl 'https://cosmos-mainnet.gateway.tatum.io/tendermint' \
  --header 'content-type: application/json' \
  --header 'x-api-key: {YOUR_API_KEY}' \
  --data '{"jsonrpc":"2.0","method":"status","params":[],"id":1}'

Methods

22 methods. Parameters and responses are described in the CometBFT RPC specification.

MethodDescription
abci_infoReturns information about the application.
abci_queryQueries the application for data at a given path.
blockReturns the block at a given height, or the latest block.
block_resultsReturns the results of the transactions and events in the block at a given height.
blockchainReturns block metadata for a range of heights.
broadcast_tx_asyncSubmits a transaction and returns immediately, without waiting for CheckTx.
broadcast_tx_commitSubmits a transaction and waits until it is committed in a block.
broadcast_tx_syncSubmits a transaction and returns the result of CheckTx.
commitReturns the signed header (commit) at a given height.
consensus_paramsReturns the consensus parameters at a given height.
consensus_stateReturns a summary of the current consensus state.
dump_consensus_stateReturns the full consensus state, including the state of each peer.
genesisReturns the genesis document.
genesis_chunkedReturns the genesis document in base64-encoded chunks.
healthReturns an empty result if the node is running.
net_infoReturns network information, including the node's peers.
num_unconfirmed_txsReturns the number of unconfirmed transactions in the mempool.
statusReturns the node status, including sync info and the latest block.
txReturns a transaction by its hash.
tx_searchSearches transactions by event query.
unconfirmed_txsLists unconfirmed transactions in the mempool.
validatorsReturns the validator set at a given height.

The gateway lists its supported methods at runtime:

Method unavailable?

If you need a method we don't support yet, contact support.