Cosmos SDK REST API
Endpoints the node exposes under /cosmos/*.
auth
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/auth/v1beta1/account_info/{address} | AccountInfo queries account info which is common to all account types. |
| GET | /cosmos/auth/v1beta1/accounts | Accounts 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/bech32 | Bech32Prefix 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_accounts | ModuleAccounts 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/params | Params queries all parameters. |
authz
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/authz/v1beta1/grants | Returns 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
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/bank/v1beta1/balances/{address} | AllBalances queries the balance of all coins for a single account. |
| GET | /cosmos/bank/v1beta1/balances/{address}/by_denom | Balance 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_query | DenomOwnersByQuery queries for all account addresses that own a particular token denomination. |
| GET | /cosmos/bank/v1beta1/denoms_metadata | DenomsMetadata 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_string | DenomMetadataByQueryString queries the client metadata of a given coin denomination. |
| GET | /cosmos/bank/v1beta1/params | Params queries the parameters of x/bank module. |
| GET | /cosmos/bank/v1beta1/send_enabled | SendEnabled 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_denom | SpendableBalanceByDenom queries the spendable balance of a single denom for a single account. |
| GET | /cosmos/bank/v1beta1/supply | TotalSupply queries the total supply of all coins. |
| GET | /cosmos/bank/v1beta1/supply/by_denom | SupplyOf queries the supply of a single coin. |
base
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/base/node/v1beta1/config | Config queries for the operator configuration. |
| GET | /cosmos/base/node/v1beta1/status | Status queries for the node status. |
| GET | /cosmos/base/reflection/v1beta1/app_descriptor/authn | GetAuthnDescriptor 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/chain | GetChainDescriptor returns the description of the chain |
| GET | /cosmos/base/reflection/v1beta1/app_descriptor/codec | GetCodecDescriptor returns the descriptor of the codec of the application |
| GET | /cosmos/base/reflection/v1beta1/app_descriptor/configuration | GetConfigurationDescriptor returns the descriptor for the sdk.Config of the application |
| GET | /cosmos/base/reflection/v1beta1/app_descriptor/query_services | GetQueryServicesDescriptor returns the available gRPC queryable services of the application |
| GET | /cosmos/base/reflection/v1beta1/app_descriptor/tx_descriptor | GetTxDescriptor returns information on the used transaction object and available msgs that can be used |
| GET | /cosmos/base/reflection/v1beta1/interfaces | ListAllInterfaces lists all the interfaces registered in the interface registry. |
| GET | /cosmos/base/reflection/v1beta1/interfaces/{interface_name}/implementations | ListImplementations list all the concrete types that implement a given interface. |
| GET | /cosmos/base/tendermint/v1beta1/abci_query | ABCIQuery 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/latest | GetLatestBlockResults 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/latest | GetLatestBlock returns the latest block. |
| GET | /cosmos/base/tendermint/v1beta1/blocks/{height} | GetBlockByHeight queries block for given height. |
| GET | /cosmos/base/tendermint/v1beta1/node_info | GetNodeInfo queries the current node info. |
| GET | /cosmos/base/tendermint/v1beta1/syncing | GetSyncing queries node syncing. |
| GET | /cosmos/base/tendermint/v1beta1/validatorsets/latest | GetLatestValidatorSet queries latest validator-set. |
| GET | /cosmos/base/tendermint/v1beta1/validatorsets/{height} | GetValidatorSetByHeight queries validator-set at a given height. |
consensus
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/consensus/v1/params | Params queries the parameters of x/consensus module. |
distribution
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/distribution/v1beta1/community_pool | CommunityPool queries the community pool coins. |
| GET | /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards | DelegationTotalRewards 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}/validators | DelegatorValidators queries the validators of a delegator. |
| GET | /cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address | DelegatorWithdrawAddress queries withdraw address of a delegator. |
| GET | /cosmos/distribution/v1beta1/params | Params 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}/commission | ValidatorCommission queries accumulated commission for a validator. |
| GET | /cosmos/distribution/v1beta1/validators/{validator_address}/current_rewards | ValidatorCurrentRewards 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_rewards | ValidatorOutstandingRewards queries rewards of a validator address. |
| GET | /cosmos/distribution/v1beta1/validators/{validator_address}/slashes | ValidatorSlashes queries slash events of a validator. |
epochs
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/epochs/v1beta1/current_epoch | CurrentEpoch provide current epoch of specified identifier |
| GET | /cosmos/epochs/v1beta1/epochs | EpochInfos provide running epochInfos |
evidence
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/evidence/v1beta1/evidence | AllEvidence queries all evidence. |
| GET | /cosmos/evidence/v1beta1/evidence/{hash} | Evidence queries evidence based on evidence hash. |
feegrant
| Method | Path | Summary |
|---|---|---|
| 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
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/gov/v1/constitution | Constitution queries the chain's constitution. |
| GET | /cosmos/gov/v1/params/{params_type} | Params queries all parameters of the gov module. |
| GET | /cosmos/gov/v1/proposals | Proposals 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}/deposits | Deposits 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}/tally | TallyResult queries the tally of a proposal vote. |
| GET | /cosmos/gov/v1/proposals/{proposal_id}/votes | Votes 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/proposals | Proposals 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}/deposits | Deposits 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}/tally | TallyResult queries the tally of a proposal vote. |
| GET | /cosmos/gov/v1beta1/proposals/{proposal_id}/votes | Votes queries votes of a given proposal. |
| GET | /cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter} | Vote queries voted information based on proposalID, voterAddr. |
mint
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/mint/v1beta1/annual_provisions | AnnualProvisions current minting annual provisions value. |
| GET | /cosmos/mint/v1beta1/inflation | Inflation returns the current minting inflation value. |
| GET | /cosmos/mint/v1beta1/params | Params returns the total set of minting parameters. |
slashing
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/slashing/v1beta1/params | Params queries the parameters of slashing module |
| GET | /cosmos/slashing/v1beta1/signing_infos | SigningInfos queries signing info of all validators |
| GET | /cosmos/slashing/v1beta1/signing_infos/{cons_address} | SigningInfo queries the signing info of given cons address |
staking
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/staking/v1beta1/delegations/{delegator_addr} | DelegatorDelegations queries all delegations of a given delegator address. |
| GET | /cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations | Redelegations queries redelegations of given address. |
| GET | /cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations | DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address. |
| GET | /cosmos/staking/v1beta1/delegators/{delegator_addr}/validators | DelegatorValidators 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/params | Parameters queries the staking parameters. |
| GET | /cosmos/staking/v1beta1/pool | Pool queries the pool info. |
| GET | /cosmos/staking/v1beta1/validators | Validators 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}/delegations | ValidatorDelegations 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_delegation | UnbondingDelegation queries unbonding info for given validator delegator pair. |
| GET | /cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations | ValidatorUnbondingDelegations queries unbonding delegations of a validator. |
tx
| Method | Path | Summary |
|---|---|---|
| POST | /cosmos/tx/v1beta1/decode | TxDecode decodes the transaction. |
| POST | /cosmos/tx/v1beta1/decode/amino | TxDecodeAmino decodes an Amino transaction from encoded bytes to JSON. |
| POST | /cosmos/tx/v1beta1/encode | TxEncode encodes the transaction. |
| POST | /cosmos/tx/v1beta1/encode/amino | TxEncodeAmino encodes an Amino transaction from JSON to encoded bytes. |
| POST | /cosmos/tx/v1beta1/simulate | Simulate simulates executing a transaction for estimating gas usage. |
| GET | /cosmos/tx/v1beta1/txs | GetTxsEvent fetches txs by event. |
| POST | /cosmos/tx/v1beta1/txs | BroadcastTx 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
| Method | Path | Summary |
|---|---|---|
| GET | /cosmos/upgrade/v1beta1/applied_plan/{name} | AppliedPlan queries a previously applied upgrade plan by its name. |
| GET | /cosmos/upgrade/v1beta1/authority | Returns the account with authority to conduct upgrades |
| GET | /cosmos/upgrade/v1beta1/current_plan | CurrentPlan queries the current upgrade plan. |
| GET | /cosmos/upgrade/v1beta1/module_versions | ModuleVersions 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) |