Cosmos SDK gRPC Gateway API
A REST interface for state queries.
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
A REST interface for state queries.
Endpoints 109
Query
- GETAccountInfo queries account info which is common to all account types.
/cosmos/auth/v1beta1/account_info/:address - GETAccounts returns all the existing accounts.
/cosmos/auth/v1beta1/accountsWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETAccount returns account details based on address.
/cosmos/auth/v1beta1/accounts/:address - GETAccountAddressByID returns account address based on account number.
/cosmos/auth/v1beta1/address_by_id/:accountId - GETBech32Prefix queries bech32Prefix
/cosmos/auth/v1beta1/bech32 - GETAddressBytesToString converts Account Address bytes to string
/cosmos/auth/v1beta1/bech32/:addressBytes - GETAddressStringToBytes converts Address string to bytes
/cosmos/auth/v1beta1/bech32/:addressString - GETModuleAccounts returns all the existing module accounts.
/cosmos/auth/v1beta1/module_accounts - GETModuleAccountByName returns the module account info by module name
/cosmos/auth/v1beta1/module_accounts/:name - GETParams queries all parameters.
/cosmos/auth/v1beta1/params - GETReturns list of `Authorization`, granted to the grantee by the granter.
/cosmos/authz/v1beta1/grants - GETGranteeGrants returns a list of `GrantAuthorization` by grantee.
/cosmos/authz/v1beta1/grants/grantee/:grantee - GETGranterGrants returns list of `GrantAuthorization`, granted by granter.
/cosmos/authz/v1beta1/grants/granter/:granter - GETAllBalances queries the balance of all coins for a single account.
/cosmos/bank/v1beta1/balances/:addressWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETBalance queries the balance of a single coin for a single account.
/cosmos/bank/v1beta1/balances/:address/by_denom - GETDenomOwners queries for all account addresses that own a particular token
denomination.
/cosmos/bank/v1beta1/denom_owners/:denomWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETDenomOwnersByQuery queries for all account addresses that own a particular token
denomination.
/cosmos/bank/v1beta1/denom_owners_by_query - GETDenomsMetadata queries the client metadata for all registered coin
denominations.
/cosmos/bank/v1beta1/denoms_metadata - GETDenomMetadata queries the client metadata of a given coin denomination.
/cosmos/bank/v1beta1/denoms_metadata/:denom - GETDenomMetadataByQueryString queries the client metadata of a given coin denomination.
/cosmos/bank/v1beta1/denoms_metadata_by_query_string - GETParams queries the parameters of x/bank module.
/cosmos/bank/v1beta1/params - GETSendEnabled queries for SendEnabled entries.
/cosmos/bank/v1beta1/send_enabledThis query only returns denominations that have specific SendEnabled settings. Any denomination that does not have a specific setting will use the default… - GETSpendableBalances queries the spendable balance of all coins for a single
account.
/cosmos/bank/v1beta1/spendable_balances/:addressWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETSpendableBalanceByDenom queries the spendable balance of a single denom for
a single account.
/cosmos/bank/v1beta1/spendable_balances/:address/by_denomWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETTotalSupply queries the total supply of all coins.
/cosmos/bank/v1beta1/supplyWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETSupplyOf queries the supply of a single coin.
/cosmos/bank/v1beta1/supply/by_denomWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETParams queries the parameters of x/consensus module.
/cosmos/consensus/v1/params - GETCommunityPool queries the community pool coins.
/cosmos/distribution/v1beta1/community_pool - GETDelegationTotalRewards queries the total rewards accrued by each
validator.
/cosmos/distribution/v1beta1/delegators/:delegatorAddress/rewards - GETDelegationRewards queries the total rewards accrued by a delegation.
/cosmos/distribution/v1beta1/delegators/:delegatorAddress/rewards/:validatorAddress - GETDelegatorStartingInfo queries the starting info for a delegator.
/cosmos/distribution/v1beta1/delegators/:delegatorAddress/starting_info/:validatorAddress - GETDelegatorValidators queries the validators of a delegator.
/cosmos/distribution/v1beta1/delegators/:delegatorAddress/validators - GETDelegatorWithdrawAddress queries withdraw address of a delegator.
/cosmos/distribution/v1beta1/delegators/:delegatorAddress/withdraw_address - GETParams queries params of the distribution module.
/cosmos/distribution/v1beta1/params - GETValidatorDistributionInfo queries validator commission and self-delegation rewards for validator
/cosmos/distribution/v1beta1/validators/:validatorAddress - GETValidatorCommission queries accumulated commission for a validator.
/cosmos/distribution/v1beta1/validators/:validatorAddress/commission - GETValidatorCurrentRewards queries current rewards for a validator.
/cosmos/distribution/v1beta1/validators/:validatorAddress/current_rewards - GETValidatorHistoricalRewards queries historical rewards for a validator at a specific period.
/cosmos/distribution/v1beta1/validators/:validatorAddress/historical_rewards/:period - GETValidatorOutstandingRewards queries rewards of a validator address.
/cosmos/distribution/v1beta1/validators/:validatorAddress/outstanding_rewards - GETValidatorSlashes queries slash events of a validator.
/cosmos/distribution/v1beta1/validators/:validatorAddress/slashes - GETCurrentEpoch provide current epoch of specified identifier
/cosmos/epochs/v1beta1/current_epoch - GETEpochInfos provide running epochInfos
/cosmos/epochs/v1beta1/epochs - GETAllEvidence queries all evidence.
/cosmos/evidence/v1beta1/evidence - GETEvidence queries evidence based on evidence hash.
/cosmos/evidence/v1beta1/evidence/:hash - GETAllowance returns granted allowance to the grantee by the granter.
/cosmos/feegrant/v1beta1/allowance/:granter/:grantee - GETAllowances returns all the grants for the given grantee address.
/cosmos/feegrant/v1beta1/allowances/:grantee - GETAllowancesByGranter returns all the grants given by an address
/cosmos/feegrant/v1beta1/issued/:granter - GETConstitution queries the chain's constitution.
/cosmos/gov/v1/constitution - GETParams queries all parameters of the gov module.
/cosmos/gov/v1/params/:paramsType - GETProposals queries all proposals based on given status.
/cosmos/gov/v1/proposals - GETProposal queries proposal details based on ProposalID.
/cosmos/gov/v1/proposals/:proposalId - GETDeposits queries all deposits of a single proposal.
/cosmos/gov/v1/proposals/:proposalId/deposits - GETDeposit queries single deposit information based on proposalID, depositAddr.
/cosmos/gov/v1/proposals/:proposalId/deposits/:depositor - GETTallyResult queries the tally of a proposal vote.
/cosmos/gov/v1/proposals/:proposalId/tally - GETVotes queries votes of a given proposal.
/cosmos/gov/v1/proposals/:proposalId/votes - GETVote queries voted information based on proposalID, voterAddr.
/cosmos/gov/v1/proposals/:proposalId/votes/:voter - GETParams queries all parameters of the gov module.
/cosmos/gov/v1beta1/params/:paramsType - GETProposals queries all proposals based on given status.
/cosmos/gov/v1beta1/proposals - GETProposal queries proposal details based on ProposalID.
/cosmos/gov/v1beta1/proposals/:proposalId - GETDeposits queries all deposits of a single proposal.
/cosmos/gov/v1beta1/proposals/:proposalId/deposits - GETDeposit queries single deposit information based on proposalID, depositor address.
/cosmos/gov/v1beta1/proposals/:proposalId/deposits/:depositor - GETTallyResult queries the tally of a proposal vote.
/cosmos/gov/v1beta1/proposals/:proposalId/tally - GETVotes queries votes of a given proposal.
/cosmos/gov/v1beta1/proposals/:proposalId/votes - GETVote queries voted information based on proposalID, voterAddr.
/cosmos/gov/v1beta1/proposals/:proposalId/votes/:voter - GETAnnualProvisions current minting annual provisions value.
/cosmos/mint/v1beta1/annual_provisions - GETInflation returns the current minting inflation value.
/cosmos/mint/v1beta1/inflation - GETParams returns the total set of minting parameters.
/cosmos/mint/v1beta1/params - GETParams queries the parameters of slashing module
/cosmos/slashing/v1beta1/params - GETSigningInfos queries signing info of all validators
/cosmos/slashing/v1beta1/signing_infos - GETSigningInfo queries the signing info of given cons address
/cosmos/slashing/v1beta1/signing_infos/:consAddress - GETDelegatorDelegations queries all delegations of a given delegator address.
/cosmos/staking/v1beta1/delegations/:delegatorAddrWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETRedelegations queries redelegations of given address.
/cosmos/staking/v1beta1/delegators/:delegatorAddr/redelegationsWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETDelegatorUnbondingDelegations queries all unbonding delegations of a given
delegator address.
/cosmos/staking/v1beta1/delegators/:delegatorAddr/unbonding_delegationsWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETDelegatorValidators queries all validators info for given delegator
address.
/cosmos/staking/v1beta1/delegators/:delegatorAddr/validatorsWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETDelegatorValidator queries validator info for given delegator validator
pair.
/cosmos/staking/v1beta1/delegators/:delegatorAddr/validators/:validatorAddr - GETHistoricalInfo queries the historical info for given height.
/cosmos/staking/v1beta1/historical_info/:height - GETParameters queries the staking parameters.
/cosmos/staking/v1beta1/params - GETPool queries the pool info.
/cosmos/staking/v1beta1/pool - GETValidators queries all validators that match the given status.
/cosmos/staking/v1beta1/validatorsWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETValidator queries validator info for given validator address.
/cosmos/staking/v1beta1/validators/:validatorAddr - GETValidatorDelegations queries delegate info for given validator.
/cosmos/staking/v1beta1/validators/:validatorAddr/delegationsWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETDelegation queries delegate info for given validator delegator pair.
/cosmos/staking/v1beta1/validators/:validatorAddr/delegations/:delegatorAddr - GETUnbondingDelegation queries unbonding info for given validator delegator
pair.
/cosmos/staking/v1beta1/validators/:validatorAddr/delegations/:delegatorAddr/unbonding_delegation - GETValidatorUnbondingDelegations queries unbonding delegations of a validator.
/cosmos/staking/v1beta1/validators/:validatorAddr/unbonding_delegationsWhen called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set. - GETAppliedPlan queries a previously applied upgrade plan by its name.
/cosmos/upgrade/v1beta1/applied_plan/:name - GETReturns the account with authority to conduct upgrades
/cosmos/upgrade/v1beta1/authority - GETCurrentPlan queries the current upgrade plan.
/cosmos/upgrade/v1beta1/current_plan - GETModuleVersions queries the list of module versions from state.
/cosmos/upgrade/v1beta1/module_versions - GETUpgradedConsensusState 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)
/cosmos/upgrade/v1beta1/upgraded_consensus_state/:lastHeight
Service
- GETConfig queries for the operator configuration.
/cosmos/base/node/v1beta1/config - GETStatus queries for the node status.
/cosmos/base/node/v1beta1/status - GETABCIQuery 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.
/cosmos/base/tendermint/v1beta1/abci_query - GETGetLatestBlockResults 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.
/cosmos/base/tendermint/v1beta1/block_results/latest - GETGetBlockResults queries block results for given height.
/cosmos/base/tendermint/v1beta1/block_results/:height - GETGetLatestBlock returns the latest block.
/cosmos/base/tendermint/v1beta1/blocks/latest - GETGetBlockByHeight queries block for given height.
/cosmos/base/tendermint/v1beta1/blocks/:height - GETGetNodeInfo queries the current node info.
/cosmos/base/tendermint/v1beta1/node_info - GETGetSyncing queries node syncing.
/cosmos/base/tendermint/v1beta1/syncing - GETGetLatestValidatorSet queries latest validator-set.
/cosmos/base/tendermint/v1beta1/validatorsets/latest - GETGetValidatorSetByHeight queries validator-set at a given height.
/cosmos/base/tendermint/v1beta1/validatorsets/:height - POSTTxDecode decodes the transaction.
/cosmos/tx/v1beta1/decode - POSTTxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.
/cosmos/tx/v1beta1/decode/amino - POSTTxEncode encodes the transaction.
/cosmos/tx/v1beta1/encode - POSTTxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.
/cosmos/tx/v1beta1/encode/amino - POSTSimulate simulates executing a transaction for estimating gas usage.
/cosmos/tx/v1beta1/simulate - GETGetTxsEvent fetches txs by event.
/cosmos/tx/v1beta1/txs - POSTBroadcastTx broadcast transaction.
/cosmos/tx/v1beta1/txs - GETGetBlockWithTxs fetches a block with decoded txs.
/cosmos/tx/v1beta1/txs/block/:height - GETGetTx fetches a tx by hash.
/cosmos/tx/v1beta1/txs/:hash
API details
- Authentication
- None declared in the description
- Operations
- 109 operations on 108 pathsGET 103POST 6
- Main resources
- Query 89Service 20
- Description format
- Swagger 2.0, API version
1.0.0 - Links
- OpenAPI document
- Listed from
- Cosmos's published OpenAPI description (cosmos/cosmos-sdk) (Apache-2.0)
How to test the Cosmos SDK gRPC Gateway API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Cosmos SDK gRPC Gateway API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “AccountInfo queries account info which is common to all account types.” (GET /cosmos/auth/v1beta1/account_info/:address), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Cosmos SDK gRPC Gateway API?
A REST interface for state queries. It is listed under Finance & banking and has 109 endpoints.
Who publishes the Cosmos SDK gRPC Gateway API?
It is listed from Cosmos's public API description (an OpenAPI document), not published by Cosmos on Swastik Codes. Anyone who controls cosmos.network can claim the profile by adding a DNS TXT record.
How do I authenticate with the Cosmos SDK gRPC Gateway API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the Cosmos SDK gRPC Gateway API have?
109 operations on 108 paths (103 GET, 6 POST). The largest groups are Query, Service.
Is forking the Cosmos SDK gRPC Gateway API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.