Skip to main content
Version: Next

Cosmos SDK REST API

Endpoints the node exposes under /cosmos/*.

auth​

MethodPathSummary
GET/cosmos/auth/v1beta1/account_info/{address}AccountInfo queries account info which is common to all account types.
GET/cosmos/auth/v1beta1/accountsAccounts returns all the existing accounts.
GET/cosmos/auth/v1beta1/accounts/{address}Account returns account details based on address.
GET/cosmos/auth/v1beta1/address_by_id/{account_id}AccountAddressByID returns account address based on account number.
GET/cosmos/auth/v1beta1/bech32Bech32Prefix queries bech32Prefix
GET/cosmos/auth/v1beta1/bech32/{address_bytes}AddressBytesToString converts Account Address bytes to string
GET/cosmos/auth/v1beta1/bech32/{address_string}AddressStringToBytes converts Address string to bytes
GET/cosmos/auth/v1beta1/module_accountsModuleAccounts returns all the existing module accounts.
GET/cosmos/auth/v1beta1/module_accounts/{name}ModuleAccountByName returns the module account info by module name
GET/cosmos/auth/v1beta1/paramsParams queries all parameters.

authz​

MethodPathSummary
GET/cosmos/authz/v1beta1/grantsReturns list of Authorization, granted to the grantee by the granter.
GET/cosmos/authz/v1beta1/grants/grantee/{grantee}GranteeGrants returns a list of GrantAuthorization by grantee.
GET/cosmos/authz/v1beta1/grants/granter/{granter}GranterGrants returns list of GrantAuthorization, granted by granter.

bank​

MethodPathSummary
GET/cosmos/bank/v1beta1/balances/{address}AllBalances queries the balance of all coins for a single account.
GET/cosmos/bank/v1beta1/balances/{address}/by_denomBalance queries the balance of a single coin for a single account.
GET/cosmos/bank/v1beta1/denom_owners/{denom}DenomOwners queries for all account addresses that own a particular token denomination.
GET/cosmos/bank/v1beta1/denom_owners_by_queryDenomOwnersByQuery queries for all account addresses that own a particular token denomination.
GET/cosmos/bank/v1beta1/denoms_metadataDenomsMetadata queries the client metadata for all registered coin denominations.
GET/cosmos/bank/v1beta1/denoms_metadata/{denom}DenomMetadata queries the client metadata of a given coin denomination.
GET/cosmos/bank/v1beta1/denoms_metadata_by_query_stringDenomMetadataByQueryString queries the client metadata of a given coin denomination.
GET/cosmos/bank/v1beta1/paramsParams queries the parameters of x/bank module.
GET/cosmos/bank/v1beta1/send_enabledSendEnabled queries for SendEnabled entries.
GET/cosmos/bank/v1beta1/spendable_balances/{address}SpendableBalances queries the spendable balance of all coins for a single account.
GET/cosmos/bank/v1beta1/spendable_balances/{address}/by_denomSpendableBalanceByDenom queries the spendable balance of a single denom for a single account.
GET/cosmos/bank/v1beta1/supplyTotalSupply queries the total supply of all coins.
GET/cosmos/bank/v1beta1/supply/by_denomSupplyOf queries the supply of a single coin.

base​

MethodPathSummary
GET/cosmos/base/node/v1beta1/configConfig queries for the operator configuration.
GET/cosmos/base/node/v1beta1/statusStatus queries for the node status.
GET/cosmos/base/reflection/v1beta1/app_descriptor/authnGetAuthnDescriptor returns information on how to authenticate transactions in the application NOTE: this RPC is still experimental and might be subject to breaking changes or removal in future releases of the cosmos-sdk.
GET/cosmos/base/reflection/v1beta1/app_descriptor/chainGetChainDescriptor returns the description of the chain
GET/cosmos/base/reflection/v1beta1/app_descriptor/codecGetCodecDescriptor returns the descriptor of the codec of the application
GET/cosmos/base/reflection/v1beta1/app_descriptor/configurationGetConfigurationDescriptor returns the descriptor for the sdk.Config of the application
GET/cosmos/base/reflection/v1beta1/app_descriptor/query_servicesGetQueryServicesDescriptor returns the available gRPC queryable services of the application
GET/cosmos/base/reflection/v1beta1/app_descriptor/tx_descriptorGetTxDescriptor returns information on the used transaction object and available msgs that can be used
GET/cosmos/base/reflection/v1beta1/interfacesListAllInterfaces lists all the interfaces registered in the interface registry.
GET/cosmos/base/reflection/v1beta1/interfaces/{interface_name}/implementationsListImplementations list all the concrete types that implement a given interface.
GET/cosmos/base/tendermint/v1beta1/abci_queryABCIQuery defines a query handler that supports ABCI queries directly to the application, bypassing Tendermint completely. The ABCI query must contain a valid and supported path, including app, custom, p2p, and store.
GET/cosmos/base/tendermint/v1beta1/block_results/latestGetLatestBlockResults returns the block results for the latest block. Block results contain finalize_block_events which include consensus-level events like slashing, jailing, and validator set updates.
GET/cosmos/base/tendermint/v1beta1/block_results/{height}GetBlockResults queries block results for given height.
GET/cosmos/base/tendermint/v1beta1/blocks/latestGetLatestBlock returns the latest block.
GET/cosmos/base/tendermint/v1beta1/blocks/{height}GetBlockByHeight queries block for given height.
GET/cosmos/base/tendermint/v1beta1/node_infoGetNodeInfo queries the current node info.
GET/cosmos/base/tendermint/v1beta1/syncingGetSyncing queries node syncing.
GET/cosmos/base/tendermint/v1beta1/validatorsets/latestGetLatestValidatorSet queries latest validator-set.
GET/cosmos/base/tendermint/v1beta1/validatorsets/{height}GetValidatorSetByHeight queries validator-set at a given height.

circuit​

MethodPathSummary
GET/cosmos/circuit/v1/accountsAccount returns account permissions.
GET/cosmos/circuit/v1/accounts/{address}Account returns account permissions.
GET/cosmos/circuit/v1/disable_listDisabledList returns a list of disabled message urls

consensus​

MethodPathSummary
GET/cosmos/consensus/v1/paramsParams queries the parameters of x/consensus module.

distribution​

MethodPathSummary
GET/cosmos/distribution/v1beta1/community_poolCommunityPool queries the community pool coins.
GET/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewardsDelegationTotalRewards queries the total rewards accrued by each validator.
GET/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}DelegationRewards queries the total rewards accrued by a delegation.
GET/cosmos/distribution/v1beta1/delegators/{delegator_address}/starting_info/{validator_address}DelegatorStartingInfo queries the starting info for a delegator.
GET/cosmos/distribution/v1beta1/delegators/{delegator_address}/validatorsDelegatorValidators queries the validators of a delegator.
GET/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_addressDelegatorWithdrawAddress queries withdraw address of a delegator.
GET/cosmos/distribution/v1beta1/paramsParams queries params of the distribution module.
GET/cosmos/distribution/v1beta1/validators/{validator_address}ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator
GET/cosmos/distribution/v1beta1/validators/{validator_address}/commissionValidatorCommission queries accumulated commission for a validator.
GET/cosmos/distribution/v1beta1/validators/{validator_address}/current_rewardsValidatorCurrentRewards queries current rewards for a validator.
GET/cosmos/distribution/v1beta1/validators/{validator_address}/historical_rewards/{period}ValidatorHistoricalRewards queries historical rewards for a validator at a specific period.
GET/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewardsValidatorOutstandingRewards queries rewards of a validator address.
GET/cosmos/distribution/v1beta1/validators/{validator_address}/slashesValidatorSlashes queries slash events of a validator.

epochs​

MethodPathSummary
GET/cosmos/epochs/v1beta1/current_epochCurrentEpoch provide current epoch of specified identifier
GET/cosmos/epochs/v1beta1/epochsEpochInfos provide running epochInfos

evidence​

MethodPathSummary
GET/cosmos/evidence/v1beta1/evidenceAllEvidence queries all evidence.
GET/cosmos/evidence/v1beta1/evidence/{hash}Evidence queries evidence based on evidence hash.

feegrant​

MethodPathSummary
GET/cosmos/feegrant/v1beta1/allowance/{granter}/{grantee}Allowance returns granted allowance to the grantee by the granter.
GET/cosmos/feegrant/v1beta1/allowances/{grantee}Allowances returns all the grants for the given grantee address.
GET/cosmos/feegrant/v1beta1/issued/{granter}AllowancesByGranter returns all the grants given by an address

gov​

MethodPathSummary
GET/cosmos/gov/v1/constitutionConstitution queries the chain's constitution.
GET/cosmos/gov/v1/params/{params_type}Params queries all parameters of the gov module.
GET/cosmos/gov/v1/proposalsProposals queries all proposals based on given status.
GET/cosmos/gov/v1/proposals/{proposal_id}Proposal queries proposal details based on ProposalID.
GET/cosmos/gov/v1/proposals/{proposal_id}/depositsDeposits queries all deposits of a single proposal.
GET/cosmos/gov/v1/proposals/{proposal_id}/deposits/{depositor}Deposit queries single deposit information based on proposalID, depositAddr.
GET/cosmos/gov/v1/proposals/{proposal_id}/tallyTallyResult queries the tally of a proposal vote.
GET/cosmos/gov/v1/proposals/{proposal_id}/votesVotes queries votes of a given proposal.
GET/cosmos/gov/v1/proposals/{proposal_id}/votes/{voter}Vote queries voted information based on proposalID, voterAddr.
GET/cosmos/gov/v1beta1/params/{params_type}Params queries all parameters of the gov module.
GET/cosmos/gov/v1beta1/proposalsProposals queries all proposals based on given status.
GET/cosmos/gov/v1beta1/proposals/{proposal_id}Proposal queries proposal details based on ProposalID.
GET/cosmos/gov/v1beta1/proposals/{proposal_id}/depositsDeposits queries all deposits of a single proposal.
GET/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}Deposit queries single deposit information based on proposalID, depositor address.
GET/cosmos/gov/v1beta1/proposals/{proposal_id}/tallyTallyResult queries the tally of a proposal vote.
GET/cosmos/gov/v1beta1/proposals/{proposal_id}/votesVotes queries votes of a given proposal.
GET/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}Vote queries voted information based on proposalID, voterAddr.

mint​

MethodPathSummary
GET/cosmos/mint/v1beta1/annual_provisionsAnnualProvisions current minting annual provisions value.
GET/cosmos/mint/v1beta1/inflationInflation returns the current minting inflation value.
GET/cosmos/mint/v1beta1/paramsParams returns the total set of minting parameters.

nft​

MethodPathSummary
GET/cosmos/nft/v1beta1/balance/{owner}/{class_id}Balance queries the number of NFTs of a given class owned by the owner, same as balanceOf in ERC721
GET/cosmos/nft/v1beta1/classesClasses queries all NFT classes
GET/cosmos/nft/v1beta1/classes/{class_id}Class queries an NFT class based on its id
GET/cosmos/nft/v1beta1/nftsNFTs queries all NFTs of a given class or owner,choose at least one of the two, similar to tokenByIndex in ERC721Enumerable
GET/cosmos/nft/v1beta1/nfts/{class_id}/{id}NFT queries an NFT based on its class and id.
GET/cosmos/nft/v1beta1/owner/{class_id}/{id}Owner queries the owner of the NFT based on its class and id, same as ownerOf in ERC721
GET/cosmos/nft/v1beta1/supply/{class_id}Supply queries the number of NFTs from the given class, same as totalSupply of ERC721.

slashing​

MethodPathSummary
GET/cosmos/slashing/v1beta1/paramsParams queries the parameters of slashing module
GET/cosmos/slashing/v1beta1/signing_infosSigningInfos queries signing info of all validators
GET/cosmos/slashing/v1beta1/signing_infos/{cons_address}SigningInfo queries the signing info of given cons address

staking​

MethodPathSummary
GET/cosmos/staking/v1beta1/delegations/{delegator_addr}DelegatorDelegations queries all delegations of a given delegator address.
GET/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegationsRedelegations queries redelegations of given address.
GET/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegationsDelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.
GET/cosmos/staking/v1beta1/delegators/{delegator_addr}/validatorsDelegatorValidators queries all validators info for given delegator address.
GET/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}DelegatorValidator queries validator info for given delegator validator pair.
GET/cosmos/staking/v1beta1/historical_info/{height}HistoricalInfo queries the historical info for given height.
GET/cosmos/staking/v1beta1/paramsParameters queries the staking parameters.
GET/cosmos/staking/v1beta1/poolPool queries the pool info.
GET/cosmos/staking/v1beta1/validatorsValidators queries all validators that match the given status.
GET/cosmos/staking/v1beta1/validators/{validator_addr}Validator queries validator info for given validator address.
GET/cosmos/staking/v1beta1/validators/{validator_addr}/delegationsValidatorDelegations queries delegate info for given validator.
GET/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}Delegation queries delegate info for given validator delegator pair.
GET/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegationUnbondingDelegation queries unbonding info for given validator delegator pair.
GET/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegationsValidatorUnbondingDelegations queries unbonding delegations of a validator.

tx​

MethodPathSummary
POST/cosmos/tx/v1beta1/decodeTxDecode decodes the transaction.
POST/cosmos/tx/v1beta1/decode/aminoTxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.
POST/cosmos/tx/v1beta1/encodeTxEncode encodes the transaction.
POST/cosmos/tx/v1beta1/encode/aminoTxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.
POST/cosmos/tx/v1beta1/simulateSimulate simulates executing a transaction for estimating gas usage.
GET/cosmos/tx/v1beta1/txsGetTxsEvent fetches txs by event.
POST/cosmos/tx/v1beta1/txsBroadcastTx broadcast transaction.
GET/cosmos/tx/v1beta1/txs/block/{height}GetBlockWithTxs fetches a block with decoded txs.
GET/cosmos/tx/v1beta1/txs/{hash}GetTx fetches a tx by hash.

upgrade​

MethodPathSummary
GET/cosmos/upgrade/v1beta1/applied_plan/{name}AppliedPlan queries a previously applied upgrade plan by its name.
GET/cosmos/upgrade/v1beta1/authorityReturns the account with authority to conduct upgrades
GET/cosmos/upgrade/v1beta1/current_planCurrentPlan queries the current upgrade plan.
GET/cosmos/upgrade/v1beta1/module_versionsModuleVersions queries the list of module versions from state.
GET/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}UpgradedConsensusState queries the consensus state that will serve as a trusted kernel for the next version of this chain. It will only be stored at the last height of this chain. UpgradedConsensusState RPC not supported with legacy querier This rpc is deprecated now that IBC has its own replacement (https://github.com/cosmos/ibc-go/blob/2c880a22e9f9cc75f62b527ca94aa75ce1106001/proto/ibc/core/client/v1/query.proto#L54)