REST API endpoints supported on Cosmos Mainnet and Cosmos Testnet through Tatum RPC Gateway, with base URLs and an example request.
Call Cosmos REST endpoints through Tatum RPC Gateway. Append the endpoint path to the network's base URL and send your API key in the x-api-key header. See Authentication.
Cosmos has 2 REST API interfaces, each with its own base URLs and endpoints: Cosmos SDK REST API and Tendermint RPC over HTTP.
Cosmos SDK REST API
Base URLs
| Network | Base URL |
|---|---|
| Cosmos Mainnet | https://cosmos-mainnet.gateway.tatum.io/cosmos |
| Cosmos Testnet | https://cosmos-testnet.gateway.tatum.io/cosmos |
Example request
curl 'https://cosmos-mainnet.gateway.tatum.io/cosmos/base/tendermint/v1beta1/blocks/latest' \
--header 'x-api-key: {YOUR_API_KEY}'Endpoints
75 endpoints. Parameters and responses are described in the Cosmos SDK gRPC, REST and CometBFT endpoints documentation.
| Endpoint | Description |
|---|---|
GET /auth/v1beta1/account_info/{account} | Returns the account info common to all account types for an address. |
GET /auth/v1beta1/accounts | Lists all existing accounts. |
GET /auth/v1beta1/accounts/{account} | Returns the account details for an address. |
GET /auth/v1beta1/address_by_id/{account} | Returns the account address for an account number. |
GET /auth/v1beta1/bech32 | Returns the chain's Bech32 address prefix. |
GET /auth/v1beta1/module_accounts | Lists all existing module accounts. |
GET /auth/v1beta1/params | Returns the parameters of the auth module. |
GET /authz/v1beta1/grants | Lists the authorizations a granter has given to a grantee. |
GET /authz/v1beta1/grants/grantee/{grantee} | Lists the authorizations granted to a grantee. |
GET /authz/v1beta1/grants/granter/{granter} | Lists the authorizations granted by a granter. |
GET /bank/v1beta1/balances/{account} | Returns the balances of all coins held by an account. |
GET /bank/v1beta1/balances/{account}/by_denom | Returns the balance of a single coin denomination for an account. |
GET /bank/v1beta1/denoms_metadata | Returns the metadata of all registered coin denominations. |
GET /bank/v1beta1/denoms_metadata/{denom} | Returns the metadata of a coin denomination. |
GET /bank/v1beta1/params | Returns the parameters of the bank module. |
GET /bank/v1beta1/spendable_balances/{address} | Returns the spendable balance of each coin held by an account. |
GET /bank/v1beta1/supply | Returns the total supply of all coins. |
GET /bank/v1beta1/supply/{denom} | Returns the total supply of a single coin denomination. |
GET /bank/v1beta1/supply/by_denom | Returns the total supply of a single coin denomination. |
GET /base/tendermint/v1beta1/blocks/{height} | Returns the block at a given height. |
GET /base/tendermint/v1beta1/blocks/latest | Returns the latest block. |
GET /base/tendermint/v1beta1/node_info | Returns information about the node. |
GET /base/tendermint/v1beta1/syncing | Returns whether the node is syncing. |
GET /base/tendermint/v1beta1/validatorsets/{height} | Returns the validator set at a given height. |
GET /base/tendermint/v1beta1/validatorsets/latest | Returns the latest validator set. |
GET /distribution/v1beta1/community_pool | Returns the coins in the community pool. |
GET /distribution/v1beta1/delegators/{delegator_address}/rewards | Returns the total rewards a delegator has accrued from each validator. |
GET /distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address} | Returns the rewards accrued by a delegation to a validator. |
GET /distribution/v1beta1/delegators/{delegator_address}/validators | Lists the validators a delegator is bonded to. |
GET /distribution/v1beta1/delegators/{delegator_address}/withdraw_address | Returns the reward withdraw address of a delegator. |
GET /distribution/v1beta1/params | Returns the parameters of the distribution module. |
GET /distribution/v1beta1/validators/{validator_address}/commission | Returns the accumulated commission of a validator. |
GET /distribution/v1beta1/validators/{validator_address}/outstanding_rewards | Returns the outstanding rewards of a validator. |
GET /distribution/v1beta1/validators/{validator_address}/slashes | Lists the slash events of a validator. |
GET /evidence/v1beta1/evidence | Lists all submitted evidence of misbehavior. |
GET /evidence/v1beta1/evidence/{hash} | Returns the evidence with a given hash. |
GET /feegrant/v1beta1/allowance/{granter}/{grantee} | Returns the fee allowance a granter has given to a grantee. |
GET /feegrant/v1beta1/allowances/{grantee} | Lists all fee allowances granted to a grantee. |
GET /feegrant/v1beta1/issued/{granter} | Lists all fee allowances issued by a granter. |
GET /gov/v1beta1/params/{params_type} | Returns the governance parameters of a given type (voting, deposit or tallying). |
GET /gov/v1beta1/proposals | Lists governance proposals, optionally filtered by status. |
GET /gov/v1beta1/proposals/{proposal_id} | Returns the details of a governance proposal. |
GET /gov/v1beta1/proposals/{proposal_id}/deposits | Lists the deposits on a governance proposal. |
GET /gov/v1beta1/proposals/{proposal_id}/deposits/{depositor} | Returns a depositor's deposit on a governance proposal. |
GET /gov/v1beta1/proposals/{proposal_id}/tally | Returns the vote tally of a governance proposal. |
GET /gov/v1beta1/proposals/{proposal_id}/votes | Lists the votes on a governance proposal. |
GET /gov/v1beta1/proposals/{proposal_id}/votes/{voter} | Returns a voter's vote on a governance proposal. |
GET /mint/v1beta1/annual_provisions | Returns the current annual provisions of minted tokens. |
GET /mint/v1beta1/inflation | Returns the current minting inflation rate. |
GET /mint/v1beta1/params | Returns the parameters of the mint module. |
GET /slashing/v1beta1/params | Returns the parameters of the slashing module. |
GET /slashing/v1beta1/signing_infos | Returns the signing info of all validators. |
GET /slashing/v1beta1/signing_infos/{cons_address} | Returns the signing info of a validator by consensus address. |
GET /staking/v1beta1/delegations/{delegator_addr} | Lists all delegations of a delegator. |
GET /staking/v1beta1/delegators/{delegator_addr}/redelegations | Lists the redelegations of a delegator. |
GET /staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations | Lists the unbonding delegations of a delegator. |
GET /staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr} | Returns a validator that a delegator is delegating to. |
GET /staking/v1beta1/historical_info/{height} | Returns the historical staking info at a given height. |
GET /staking/v1beta1/params | Returns the parameters of the staking module. |
GET /staking/v1beta1/pool | Returns the bonded and not-bonded token amounts of the staking pool. |
GET /staking/v1beta1/validators | Lists validators, optionally filtered by status. |
GET /staking/v1beta1/validators/{validator_addr} | Returns the details of a validator. |
GET /staking/v1beta1/validators/{validator_addr}/delegations | Lists the delegations to a validator. |
GET /staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr} | Returns a delegator's delegation to a validator. |
GET /staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation | Returns a delegator's unbonding delegation from a validator. |
GET /staking/v1beta1/validators/{validator_addr}/unbonding_delegations | Lists the unbonding delegations of a validator. |
GET /tx/v1beta1/txs/{hash} | Returns a transaction by its hash. |
GET /tx/v1beta1/txs/block/{block_number} | Returns the block at a given height with its decoded transactions. |
GET /upgrade/v1beta1/applied_plan/{name} | Returns the height at which a past upgrade plan was applied. |
GET /upgrade/v1beta1/authority | Returns the account authorized to perform upgrades. |
GET /upgrade/v1beta1/current_plan | Returns the currently scheduled upgrade plan. |
GET /upgrade/v1beta1/module_versions | Lists the module versions stored in state. |
GET /upgrade/v1beta1/upgraded_consensus_state/{last_height} | Returns the consensus state that serves as a trusted kernel for the next chain version. |
POST /tx/v1beta1/simulate | Simulates a transaction and returns its estimated gas usage. |
POST /tx/v1beta1/txs | Broadcasts a signed transaction to the network. |
The gateway lists its supported endpoints at runtime:
Tendermint RPC over HTTP
Base URLs
| Network | Base URL |
|---|---|
| Cosmos Mainnet | https://cosmos-mainnet.gateway.tatum.io/tendermint |
| Cosmos Testnet | https://cosmos-testnet.gateway.tatum.io/tendermint |
Example request
curl 'https://cosmos-mainnet.gateway.tatum.io/tendermint/status' \
--header 'x-api-key: {YOUR_API_KEY}'Endpoints
44 endpoints. Parameters and responses are described in the CometBFT RPC specification.
| Endpoint | Description |
|---|---|
GET /abci_info | Returns information about the application. |
GET /abci_query | Queries the application for data at a given path. |
GET /block | Returns the block at a given height, or the latest block. |
GET /block_results | Returns the results of the transactions and events in the block at a given height. |
GET /blockchain | Returns block metadata for a range of heights. |
GET /broadcast_tx_async | Submits a transaction and returns immediately, without waiting for CheckTx. |
GET /broadcast_tx_commit | Submits a transaction and waits until it is committed in a block. |
GET /broadcast_tx_sync | Submits a transaction and returns the result of CheckTx. |
GET /commit | Returns the signed header (commit) at a given height. |
GET /consensus_params | Returns the consensus parameters at a given height. |
GET /consensus_state | Returns a summary of the current consensus state. |
GET /dump_consensus_state | Returns the full consensus state, including the state of each peer. |
GET /genesis | Returns the genesis document. |
GET /genesis_chunked | Returns the genesis document in base64-encoded chunks. |
GET /health | Returns an empty result if the node is running. |
GET /net_info | Returns network information, including the node's peers. |
GET /num_unconfirmed_txs | Returns the number of unconfirmed transactions in the mempool. |
GET /status | Returns the node status, including sync info and the latest block. |
GET /tx | Returns a transaction by its hash. |
GET /tx_search | Searches transactions by event query. |
GET /unconfirmed_txs | Lists unconfirmed transactions in the mempool. |
GET /validators | Returns the validator set at a given height. |
POST /abci_info | Returns information about the application. |
POST /abci_query | Queries the application for data at a given path. |
POST /block | Returns the block at a given height, or the latest block. |
POST /block_results | Returns the results of the transactions and events in the block at a given height. |
POST /blockchain | Returns block metadata for a range of heights. |
POST /broadcast_tx_async | Submits a transaction and returns immediately, without waiting for CheckTx. |
POST /broadcast_tx_commit | Submits a transaction and waits until it is committed in a block. |
POST /broadcast_tx_sync | Submits a transaction and returns the result of CheckTx. |
POST /commit | Returns the signed header (commit) at a given height. |
POST /consensus_params | Returns the consensus parameters at a given height. |
POST /consensus_state | Returns a summary of the current consensus state. |
POST /dump_consensus_state | Returns the full consensus state, including the state of each peer. |
POST /genesis | Returns the genesis document. |
POST /genesis_chunked | Returns the genesis document in base64-encoded chunks. |
POST /health | Returns an empty result if the node is running. |
POST /net_info | Returns network information, including the node's peers. |
POST /num_unconfirmed_txs | Returns the number of unconfirmed transactions in the mempool. |
POST /status | Returns the node status, including sync info and the latest block. |
POST /tx | Returns a transaction by its hash. |
POST /tx_search | Searches transactions by event query. |
POST /unconfirmed_txs | Lists unconfirmed transactions in the mempool. |
POST /validators | Returns the validator set at a given height. |
The gateway lists its supported endpoints at runtime:
Endpoint unavailable?If you need an endpoint we don't support yet, contact support.