Cosmos REST Methods

📘

See the Cosmos RPC API connection guide.

auth

MethodNotesCompute Unit Value
GET /cosmos/auth/v1beta1/accountsReturns accounts with pagination.50
GET /cosmos/auth/v1beta1/paramsReturns the authentication module parameters.10

bank

MethodNotesCompute Unit Value
GET /cosmos/bank/v1beta1/balances/{address}Returns all balances held by an address.10
GET /cosmos/bank/v1beta1/balances/{address}/{denom}Returns an address's balance for one denomination.5
GET /cosmos/bank/v1beta1/paramsReturns bank module parameters.10
GET /cosmos/bank/v1beta1/supplyReturns the total supply of all denominations.5
GET /cosmos/bank/v1beta1/supply/{bydenom}Returns the total supply of one denomination.5

distribution

MethodNotesCompute Unit Value
GET /cosmos/distribution/v1beta1/community_poolReturns the community pool balance.10
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewardsReturns all outstanding rewards for a delegator.10
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}Returns a delegator's rewards from one validator.10
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/validatorsReturns validators that have paid rewards to a delegator.10
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_addressReturns a delegator's reward withdrawal address.10
GET /cosmos/distribution/v1beta1/paramsReturns distribution module parameters.10
GET /cosmos/distribution/v1beta1/validators/{validator_address}/commissionReturns a validator's accumulated commission.10
GET /cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewardsReturns a validator's outstanding rewards.10
GET /cosmos/distribution/v1beta1/validators/{validator_address}/slashesReturns slashing events for a validator.10

gov

MethodNotesCompute Unit Value
GET /cosmos/gov/v1beta1/params/{params_type}Returns governance parameters for the requested parameter type.10
GET /cosmos/gov/v1beta1/proposalsReturns governance proposals with optional filters.10
GET /cosmos/gov/v1beta1/proposals/{proposal_id}Returns one governance proposal.10
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/depositsReturns deposits for a proposal.10
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}Returns one depositor's deposit for a proposal.10
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/tallyReturns the tally result for a proposal.10
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/votesReturns votes for a proposal.10
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}Returns one voter's vote on a proposal.10

mint

MethodNotesCompute Unit Value
GET /cosmos/mint/v1beta1/paramsReturns mint module parameters.10

params

MethodNotesCompute Unit Value
GET /cosmos/params/v1beta1/paramsReturns a subspace parameter value.10

slashing

MethodNotesCompute Unit Value
GET /cosmos/slashing/v1beta1/paramsReturns slashing module parameters.10

staking

MethodNotesCompute Unit Value
GET /cosmos/staking/v1beta1/delegations/{delegator_addr}Returns all delegations for a delegator.10
GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegationsReturns redelegations made by a delegator.10
GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegationsReturns unbonding delegations for a delegator.10
GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/validatorsReturns validators delegated to by an address.10
GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}Returns a delegator's delegation to one validator.10
GET /cosmos/staking/v1beta1/historical_info/{height}Returns historical staking information at a block height.10
GET /cosmos/staking/v1beta1/paramsReturns staking module parameters.10
GET /cosmos/staking/v1beta1/poolReturns the current staking pool.10
GET /cosmos/staking/v1beta1/validatorsReturns validators with optional status filters.10
GET /cosmos/staking/v1beta1/validators/{validator_addr}Returns one validator.10
GET /cosmos/staking/v1beta1/validators/{validator_addr}/delegationsReturns delegations to a validator.10
GET /cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegationReturns an unbonding delegation for a validator and delegator.10
GET /cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegationsReturns unbonding delegations from a validator.10

base tendermint

MethodNotesCompute Unit Value
GET /cosmos/base/tendermint/v1beta1/blocks/latestReturns the latest block.10
GET /cosmos/base/tendermint/v1beta1/blocks/{height}Returns a block at a specified height.10
GET /cosmos/base/tendermint/v1beta1/node_infoReturns node information.1
GET /cosmos/base/tendermint/v1beta1/syncingReturns whether the node is syncing.1
GET /cosmos/base/tendermint/v1beta1/validatorsets/latestReturns the latest validator set.10
GET /cosmos/base/tendermint/v1beta1/validatorsets/{height}Returns the validator set at a specified height.10