Cosmos - REST API

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

NetworkBase URL
Cosmos Mainnethttps://cosmos-mainnet.gateway.tatum.io/cosmos
Cosmos Testnethttps://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.

EndpointDescription
GET /auth/v1beta1/account_info/{account}Returns the account info common to all account types for an address.
GET /auth/v1beta1/accountsLists 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/bech32Returns the chain's Bech32 address prefix.
GET /auth/v1beta1/module_accountsLists all existing module accounts.
GET /auth/v1beta1/paramsReturns the parameters of the auth module.
GET /authz/v1beta1/grantsLists 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_denomReturns the balance of a single coin denomination for an account.
GET /bank/v1beta1/denoms_metadataReturns the metadata of all registered coin denominations.
GET /bank/v1beta1/denoms_metadata/{denom}Returns the metadata of a coin denomination.
GET /bank/v1beta1/paramsReturns 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/supplyReturns 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_denomReturns 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/latestReturns the latest block.
GET /base/tendermint/v1beta1/node_infoReturns information about the node.
GET /base/tendermint/v1beta1/syncingReturns whether the node is syncing.
GET /base/tendermint/v1beta1/validatorsets/{height}Returns the validator set at a given height.
GET /base/tendermint/v1beta1/validatorsets/latestReturns the latest validator set.
GET /distribution/v1beta1/community_poolReturns the coins in the community pool.
GET /distribution/v1beta1/delegators/{delegator_address}/rewardsReturns 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}/validatorsLists the validators a delegator is bonded to.
GET /distribution/v1beta1/delegators/{delegator_address}/withdraw_addressReturns the reward withdraw address of a delegator.
GET /distribution/v1beta1/paramsReturns the parameters of the distribution module.
GET /distribution/v1beta1/validators/{validator_address}/commissionReturns the accumulated commission of a validator.
GET /distribution/v1beta1/validators/{validator_address}/outstanding_rewardsReturns the outstanding rewards of a validator.
GET /distribution/v1beta1/validators/{validator_address}/slashesLists the slash events of a validator.
GET /evidence/v1beta1/evidenceLists 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/proposalsLists 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}/depositsLists 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}/tallyReturns the vote tally of a governance proposal.
GET /gov/v1beta1/proposals/{proposal_id}/votesLists 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_provisionsReturns the current annual provisions of minted tokens.
GET /mint/v1beta1/inflationReturns the current minting inflation rate.
GET /mint/v1beta1/paramsReturns the parameters of the mint module.
GET /slashing/v1beta1/paramsReturns the parameters of the slashing module.
GET /slashing/v1beta1/signing_infosReturns 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}/redelegationsLists the redelegations of a delegator.
GET /staking/v1beta1/delegators/{delegator_addr}/unbonding_delegationsLists 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/paramsReturns the parameters of the staking module.
GET /staking/v1beta1/poolReturns the bonded and not-bonded token amounts of the staking pool.
GET /staking/v1beta1/validatorsLists validators, optionally filtered by status.
GET /staking/v1beta1/validators/{validator_addr}Returns the details of a validator.
GET /staking/v1beta1/validators/{validator_addr}/delegationsLists 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_delegationReturns a delegator's unbonding delegation from a validator.
GET /staking/v1beta1/validators/{validator_addr}/unbonding_delegationsLists 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/authorityReturns the account authorized to perform upgrades.
GET /upgrade/v1beta1/current_planReturns the currently scheduled upgrade plan.
GET /upgrade/v1beta1/module_versionsLists 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/simulateSimulates a transaction and returns its estimated gas usage.
POST /tx/v1beta1/txsBroadcasts a signed transaction to the network.

The gateway lists its supported endpoints at runtime:

Tendermint RPC over HTTP

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/status' \
  --header 'x-api-key: {YOUR_API_KEY}'

Endpoints

44 endpoints. Parameters and responses are described in the CometBFT RPC specification.

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