gRPC-REST API
Supported methods for Alchemy Crypto.org gRPC-REST API.
Alchemy gRPC API
Here you will find a list of all the methods Alchemy supports for Crypto.org's gRPC API.
There might be methods supported by Crypto.org nodes but not by Alchemy. See the full list of gRPC-REST API methods on the official documentation.
Tendermint RPC
syncing
syncing
Syncing state of node. Get if the node is currently syncing with other nodes
Parameters
none
Returns
Node syncing status
Example
Request
Result
blocks/latest
blocks/latest
Get the latest block.
Parameters
none
Returns
The latest block.
Example
Request
Result
blocks/{height}
blocks/{height}
Get a block at a certain height.
Parameters
height
- integer, required block height
Returns
none
Example
Request
Result
validatorsets/latest
validatorsets/latest
Get the latest validator set (latest block height).
Parameters
none
Returns
The validator set at the latest block height
Example
Request
Result
validatorsets/{height}
validatorsets/{height}
Get the validator set at a certain height.
Parameters
height
- integer, required block height
Returns
The validator set at a specific block height.
Example
Request
Result
Query
cosmos/auth
methods
cosmos/auth
methods/cosmos/auth/v1beta1/accounts/{address}
/cosmos/auth/v1beta1/accounts/{address}
Returns account details based on address.
Parameters
address
- string, required address to query for
Returns
Account details
Example
Request
Result
/cosmos/auth/v1beta1/params
/cosmos/auth/v1beta1/params
Query all parameters.
Parameters
none
Returns
Parameters
Example
Request
Result
cosmos/bank
methods
cosmos/bank
methods/cosmos/bank/v1beta1/balances/{address}
/cosmos/bank/v1beta1/balances/{address}
Returns the balance of all coins for a single account.
Parameters
address
- string, required address to query balances forpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page most efficiently. Only one of offset or key should be set.pagination.offset
- string($uint64
), numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.pagination.limit
- string($uint64
), total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs.count_total
is only respected when offset is used, it is ignored when key is set.
Returns
Balance of all coins for a single account
Example
Request
Result
/cosmos/bank/v1beta1/balances/{address}/{denom}
/cosmos/bank/v1beta1/balances/{address}/{denom}
Return balance of a single coin for a single account.
Parameters
address
- string, required address to query balances fordenom
- string, required coin denom to query balances for
Returns
Balance of the specific coin for a single account.
Example
Request
Result
/cosmos/bank/v1beta1/params
/cosmos/bank/v1beta1/params
Queries the parameters of x/bank module.
Parameters
none
Returns
Parameters of x/bank module.
Example
Request
Result
/cosmos/bank/v1beta1/supply
/cosmos/bank/v1beta1/supply
Returns the total supply of all coins.
Parameters
none
Returns
Supply of all coins.
Example
Request
Result
/cosmos/bank/v1beta1/supply/{denom}
/cosmos/bank/v1beta1/supply/{denom}
Returns the supply of a single coin.
Parameters
denom
- string, required denom of the coin to query balances for
Returns
Total supply of a single coin.
Example
Request
Result
cosmos/distribution
methods
cosmos/distribution
methods/cosmos/distribution/v1beta1/community_pool
/cosmos/distribution/v1beta1/community_pool
Queries the community pool coins.
Parameters
none
Returns
Community pool coins.
Example
Request
Result
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards
Queries the total rewards accrued by each validator.
Parameters
delegator_address
- string, required delegator address to query for
Returns
Rewards from each validator.
Example
Request
Result
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}
Queries the total rewards accrued by a delegation.
Parameters
delegator_address
- string, required delegator address to query forvalidator_address
- string, required validator address to query for
Returns
Total rewards accrued by a delegation for a specific validator.
Example
Request
Result
/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators
/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators
Queries the validators of a delegator.
Parameters
delegator_address
- string, required delegator address to query for
Returns
Validators for a given delegator.
Example
Request
Result
/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address
/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address
Queries withdraw address of a delegator.
Parameters
delegator_address
- string, required delegator address to query for
Returns
Withdraw address of delegator.
Example
Request
Result
/cosmos/distribution/v1beta1/params
/cosmos/distribution/v1beta1/params
Queries params of the distribution module.
Parameters
none
Returns
Params of the distribution module.
Example
Request
Result
/cosmos/distribution/v1beta1/validators/{validator_address}/commission
/cosmos/distribution/v1beta1/validators/{validator_address}/commission
Queries accumulated commission for a validator.
Parameters
validator_address
- string, required validator address to query for
Returns
Total commission for a validator.
Example
Request
Result
/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards
/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards
Queries rewards of a validator address.
Parameters
validator_address
- string, required validator address to query for
Returns
Total outstanding rewards for a validator.
Example
Request
Result
/cosmos/distribution/v1beta1/validators/{validator_address}/slashes
/cosmos/distribution/v1beta1/validators/{validator_address}/slashes
Returns slash events of a validator
Parameters
validator_address
- string, required validator address to query forstarting_height
- string($uint64
), the optional starting height to query the hashesending_height
- string($uint64
), the optional ending height to query the hashespagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
All slash events of a validator.
Example
Request
Result
cosmos/evidence
methods
cosmos/evidence
methods/cosmos/evidence/v1beta1/evidence
/cosmos/evidence/v1beta1/evidence
Queries all evidence.
Parameters
pagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
All evidence.
Example
Request
Result
/cosmos/evidence/v1beta1/evidence/{evidence_hash}
/cosmos/evidence/v1beta1/evidence/{evidence_hash}
Queries evidence based on evidence hash.
Parameters
evidence_hash
- string($byte
), the hash of the requested evidence.
Returns
Evidence for a given hash.
Example
Request
Result
cosmos/gov
methods
cosmos/gov
methods/cosmos/gov/v1beta1/params/{params_type}
/cosmos/gov/v1beta1/params/{params_type}
Queries all parameters of the gov module.
Parameters
params_type
- string, required parameters to query for, can be one of "voting
", "tallying
", or "deposit
"
Returns
Parameters of the gov module.
Example
Request
Result
/cosmos/gov/v1beta1/proposals
/cosmos/gov/v1beta1/proposals
Queries all proposals based on given status.
Parameters
proposal_status
- defines status of the proposals. See below for different options. Default value = PROPOSAL_STATUS_UNSPECIFIEDPROPOSAL_STATUS_UNSPECIFIED
: default proposal status.PROPOSAL_STATUS_DEPOSIT_PERIOD
: defines a proposal status during the deposit period.PROPOSAL_STATUS_VOTING_PERIOD
: defines a proposal status during the voting period.PROPOSAL_STATUS_PASSED
: defines a proposal status of a proposal that has passed.PROPOSAL_STATUS_REJECTED
: defines a proposal status of a proposal that has been rejected.PROPOSAL_STATUS_FAILED
: defines a proposal status of a proposal that has failed.
voter
- string, defines the voter address for the proposals.depositor
- string, defines the deposit addresses from the proposalspagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Proposals based on given status.
Example
Request
Result
/cosmos/gov/v1beta1/proposals/{proposal_id}
/cosmos/gov/v1beta1/proposals/{proposal_id}
Queries proposal details based on ProposalID.
Parameters
proposal_id
- string, required unique id of the proposal
Returns
Proposal details based on proposalID.
Example
Request
Result
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits
Queries all deposits of a single proposal.
Parameters
proposal_id
- string($uint64
), required unique id of the proposalpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
All deposits based on a proposalID.
Example
Request
Result
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}
Queries single deposit information based proposalID and depositAddr.
Parameters
proposal_id
- string($uint64
), required unique id of the proposaldepositor
- string, the deposit addresses from the proposals.
Returns
Single deposit based on a proposalID.
Example
Request
Result
/cosmos/gov/v1beta1/proposals/{proposal_id}/tally
/cosmos/gov/v1beta1/proposals/{proposal_id}/tally
Queries the tally of a proposal vote.
Parameters
proposal_id
- string($uint64
), required unique id of the proposal
Returns
Tally of proposal vote.
Example
Request
Result
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes
Queries votes of a given proposal.
Parameters
proposal_id
- string($uint64
), required unique id of the proposalpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Votes for a given proposal.
Example
Request
Result
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}
Queries voted information based on proposalID, voterAddr.
Parameters
proposal_id
- string($uint64
), required unique id of the proposalvoter
- string, the other address for the proposals
Returns
Votes for a given proposal.
Example
Request
Result
cosmos/mint
methods
cosmos/mint
methods/cosmos/mint/v1beta1/annual_provisions
/cosmos/mint/v1beta1/annual_provisions
Returns current minting annual provisions value.
Parameters
none
Returns
Value of minting annual provisions.
Example
Request
Result
/cosmos/mint/v1beta1/inflation
/cosmos/mint/v1beta1/inflation
Returns the current minting inflation value.
Parameters
none
Returns
Current minting inflation value.
Example
Request
Result
/cosmos/mint/v1beta1/params
/cosmos/mint/v1beta1/params
Returns the total set of minting parameters
Parameters
none
Returns
Total set of minting params.
Example
Request
Result
cosmos/params
methods
cosmos/params
methods/cosmos/params/v1beta1/params
/cosmos/params/v1beta1/params
Queries a specific parameter of a module, given its subspace and key.
Parameters
subspace
- string, the module to query the parameter forkey
- string, the key of the parameter in the subspace
Returns
A specific parameter of a module.
Example
Request
Result
cosmos/slashing
methods
cosmos/slashing
methods/cosmos/slashing/v1beta1/params
/cosmos/slashing/v1beta1/params
Queries the parameters of slashing module
Parameters
none
Returns
The parameters of a slashing module.
Example
Request
Result
/cosmos/slashing/v1beta1/signing_infos
/cosmos/slashing/v1beta1/signing_infos
Queries signing info of all validators
Parameters
pagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
The signing info of all validators.
Example
Request
Result
/cosmos/slashing/v1beta1/signing_infos/{cons_address}
/cosmos/slashing/v1beta1/signing_infos/{cons_address}
Queries the signing info of given cons address
Parameters
cons_address
- string, required address to query signing info of
Returns
The signing info of all specified cons address.
Example
Request
Result
cosmos/staking
methods
cosmos/staking
methods/cosmos/staking/v1beta1/delegations/{delegator_addr}
/cosmos/staking/v1beta1/delegations/{delegator_addr}
Queries all delegations of a given delegator address.
Parameters
delegator_addr
- string, required delegator address to query forpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Delegations from a specific delegator address.
Example
Request
Result
/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations
/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations
Queries redelegations of given address.
Parameters
delegator_addr
- string, required delegator address to query forsrc_validator_addr
- string, the validator address to redelegate fromdst_validator_addr
- string, the validator address to redelegate topagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Delegations from a specific delegator address.
Example
Request
Result
/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations
/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations
Queries all unbonding delegations of a given delegator address.
Parameters
delegator_addr
- string, required delegator address to query forpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Unbonding delegations from a specific delegator address.
Example
Request
Result
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators
Queries all validators info for given delegator address.
Parameters
delegator_addr
- string, required delegator address to query forpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Validator info for a specific delegator address.
Example
Request
Result
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}
Queries validator info for given delegator validator pair.
Parameters
delegator_addr
- string, required delegator address to query forvalidator_addr
- string, required validator address to query for
Returns
Validator info for a given delegator pair.
Example
Request
Result
/cosmos/staking/v1beta1/historical_info/{height}
/cosmos/staking/v1beta1/historical_info/{height}
Queries the historical info for given height.
Parameters
height
- string($int64
), defines at which height to query the historical info for
Returns
Historical info for a given height.
Example
Request
Result
/cosmos/staking/v1beta1/params
/cosmos/staking/v1beta1/params
Queries the staking parameters.
Parameters
none
Returns
Staking parameters.
Example
Request
Result
/cosmos/staking/v1beta1/pool
/cosmos/staking/v1beta1/pool
Queries the pool info.
Parameters
none
Returns
Pool info.
Example
Request
Result
/cosmos/staking/v1beta1/validators
/cosmos/staking/v1beta1/validators
Queries all validators that match the given status.
Parameters
status
- string, status to query validatorspagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Validators that match the given status.
Example
Request
Result
/cosmos/staking/v1beta1/validators/{validator_addr}
/cosmos/staking/v1beta1/validators/{validator_addr}
Queries validator info for given validator address.
Parameters
validator_addr
- string, required validator address to query for
Returns
Validator info for a given validator address.
Example
Request
Result
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations
Queries delegate info for given validator.
Parameters
validator_addr
- string, required validator address to query forpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Delegate info for a given validator.
Example
Request
Result
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}
Queries delegate info for given validator delegator pair.
Parameters
validator_addr
- string, required validator address to query fordelegator_addr
- string, required delegator address to query for
Returns
Delegate info for a given validator delegator pair.
Example
Request
Result
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation
Queries unbonding info for given validator delegator pair.
Parameters
validator_addr
- string, required validator address to query fordelegator_addr
- string, required delegator address to query for
Returns
Unbonding info for a given validator delegator pair.
Example
Request
Result
/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations
/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations
Queries unbonding delegations of a validator.
Parameters
validator_addr
- string, required validator address to query forpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Unbonding info for a given validator.
Example
Request
Result
cosmos/upgrade
methods
cosmos/upgrade
methods/cosmos/upgrade/v1beta1/applied_plan/{name}
/cosmos/upgrade/v1beta1/applied_plan/{name}
Queries a previously applied upgrade plan by its name.
Parameters
name
- string, required name of the applied plan to query for
Returns
Previously applied upgrade plan.
Example
Request
Result
/cosmos/upgrade/v1beta1/current_plan
/cosmos/upgrade/v1beta1/current_plan
Queries the current upgrade plan.
Parameters
name
- string, required name of the applied plan to query for
Returns
Current upgrade plan.
Example
Request
Result
/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}
/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}
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, not supported with legacy querier.
Parameters
last_height
- string($int64
), required last height under which next consensus state is stored
Returns
Consensus state.
Example
Request
Result
ibc/core
methods
ibc/core
methods/ibc/core/channel/v1beta1/channels
/ibc/core/channel/v1beta1/channels
Queries all the IBC channels of a chain.
Parameters
pagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
IBC channels of a chain.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}
Queries an IBC Channel.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifier
Returns
IBC channels of a chain.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state
Queries for the client state for the channel associated with the provided channel identifiers.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifier
Returns
Client state.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}
Queries for the consensus state for the channel associated with the provided channel identifiers.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifierrevision_number
- string($uint64
), required revision number of the consensus staterevision_height
- string($uint64
), required revision height of the consensus state
Returns
Consensus state.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence
Returns the next receive sequence for a given channel.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifier
Returns
Next receive sequence.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements
Returns all the packet acknowledgements associated with a channel.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifierpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Packet acknowledgements.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}
Queries a stored packet acknowledgement hash.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifiersequence -
string($uint64)
, packet sequence
Returns
Packet acknowledgements.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments
Returns all the packet commitments hashes associated with a channel.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifierpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Packet commitments.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks
Returns all the unreceived IBC acknowledgements associated with a channel and sequences.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifierpacket_ack_sequence -
array[string], required list of acknowledgement sequences
Returns
Unreceived IBC acknowledgements.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets
Returns all the unreceived IBC packets associated with a channel and sequences.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifierpacket_commitment_sequences -
array[string], list of packet sequences
Returns
Unreceived IBC packets.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}
Queries a stored packet commitment hash.
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifiersequence -
string($uint64)
, required packet sequence
Returns
Packet commitment hash.
Example
Request
Result
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}
Queries if a given packet sequence has been received on the queried chain
Parameters
channel_id
- string, required channel unique identifierport_id
- string, required port unique identifiersequence -
string($uint64)
, required packet sequence
Returns
Whether or not the given packet has been received.
Example
Request
Result
/ibc/core/channel/v1beta1/connections/{connection}/channels
/ibc/core/channel/v1beta1/connections/{connection}/channels
Queries all the channels associated with a connection end.
Parameters
connection
- string, required connection unique identifierpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Channels associated with a connection
Example
Request
Result
/ibc/client/v1beta1/params
/ibc/client/v1beta1/params
Queries all parameters of the IBC client.
Parameters
none
Returns
Params of the IBC client.
Example
Request
Result
/ibc/core/client/v1beta1/client_states
/ibc/core/client/v1beta1/client_states
Queries all the IBC light clients of a chain.
Parameters
pagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
IBC light clients.
Example
Request
Result
/ibc/core/client/v1beta1/client_states/{client_id}
/ibc/core/client/v1beta1/client_states/{client_id}
Queries an IBC light client.
Parameters
client_id
- string, required client state unique identifier
Returns
IBC light client from client_id
.
Example
Request
Result
/ibc/core/client/v1beta1/consensus_states/{client_id}
/ibc/core/client/v1beta1/consensus_states/{client_id}
Queries all the consensus state associated with a given client.
Parameters
client_id
- string, required client unique identifierpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Consensus state associated with given client
Example
Request
Result
/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}
/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}
Queries a consensus state associated with a client state at a given height.
Parameters
channel_id
- string, required channel unique identifierrevision_number
- string($uint64)
, required consensus state revision numberrevision_height
- string($uint64)
, required consensus state revision heightlatest_hegiht
- boolean, overrides the height field and queries the latest stored consensus state
Returns
Consensus state associated with a client state at a given height.
Example
Request
Result
/ibc/core/connection/v1beta1/client_connections/{client_id}
/ibc/core/connection/v1beta1/client_connections/{client_id}
Queries the connection paths associated with a client state.
Parameters
client_id
- string, required client identifier associated with a connection
Returns
Connections paths associated with a client state.
Example
Request
Result
/ibc/core/connection/v1beta1/connections
/ibc/core/connection/v1beta1/connections
Queries all the IBC connections of a chain.
Parameters
pagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
IBC connections.
Example
Request
Result
/ibc/core/connection/v1beta1/connections/{connection_id}
/ibc/core/connection/v1beta1/connections/{connection_id}
Queries an IBC connection end.
Parameters
connection_id
- string, required connection unique identifier
Returns
IBC connections end.
Example
Request
Result
/ibc/core/connection/v1beta1/connections/{connection_id}/client_state
/ibc/core/connection/v1beta1/connections/{connection_id}/client_state
Queries the client state associated with the connection.
Parameters
connection_id
- string, required connection unique identifier
Returns
Client state.
Example
Request
Result
/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}
/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}
Queries the consensus state associated with the connection.
Parameters
connection_id
- string, required connection unique identifierrevision_number
- string($uint64
), required revision numberrevision_height
- string($uint64
), required revision height
Returns
Consensus state.
Example
Request
Result
ibc/applications
methods
ibc/applications
methods/ibc/applications/transfer/v1beta1/denom_traces
/ibc/applications/transfer/v1beta1/denom_traces
Queries all denomination traces.
Parameters
pagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Denomination traces.
Example
Request
Result
/ibc/applications/transfer/v1beta1/denom_traces/{hash}
/ibc/applications/transfer/v1beta1/denom_traces/{hash}
Queries a denomination trace information based off hash.
Parameters
hash
- string, required (hex format) hash of the denomination trace information
Returns
Denomination traces.
Example
Request
Result
/ibc/applications/transfer/v1beta1/params
/ibc/applications/transfer/v1beta1/params
Queries all parameters of the ibc-transfer module.
Parameters
none
Returns
Parameters of the IBC-transfer module.
Example
Request
Result
Service
cosmos/base
methods
cosmos/base
methods/cosmos/base/tendermint/v1beta1/blocks/latest
/cosmos/base/tendermint/v1beta1/blocks/latest
Returns the latest block.
Parameters
none
Returns
Latest block.
Example
Request
Result
/cosmos/base/tendermint/v1beta1/blocks/{height}
/cosmos/base/tendermint/v1beta1/blocks/{height}
Queries block for given height.
Parameters
height
- string($int64
), required block height
Returns
Latest block.
Example
Request
Result
/cosmos/base/tendermint/v1beta1/node_info
/cosmos/base/tendermint/v1beta1/node_info
Queries the current node info.
Parameters
none
Returns
Node info.
Example
Request
Result
/cosmos/base/tendermint/v1beta1/syncing
/cosmos/base/tendermint/v1beta1/syncing
Queries node syncing.
Parameters
none
Returns
Node syncing status.
Example
Request
Result
/cosmos/base/tendermint/v1beta1/validatorsets/latest
/cosmos/base/tendermint/v1beta1/validatorsets/latest
Queries latest validator-set.
Parameters
pagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Latest validator set.
Example
Request
Result
/cosmos/base/tendermint/v1beta1/validatorsets/{height}
/cosmos/base/tendermint/v1beta1/validatorsets/{height}
Queries validator-set at a given height.
Parameters
height
- string($uint64
), block heightpagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Validator set at given block height.
Example
Request
Result
cosmos/tx
methods
cosmos/tx
methods/cosmos/tx/v1beta1/simulate
/cosmos/tx/v1beta1/simulate
Simulates executing a transaction for estimating gas usage.
Parameters
body
- required object, see example below
Returns
Estimated gas usage.
Example
Request
Result
/cosmos/tx/v1beta1/txs
/cosmos/tx/v1beta1/txs
Fetches txs by event.
Parameters
events
- array[string], list of transaction event typepagination.key
- string($byte
), value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
- string($uint64
), numeric offset that can be used whenkey
is unavailable (less efficient than usingkey
). Only one ofoffset
orkey
should be set.pagination.limit
- string($uint64
), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
- boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Transactions.
Example
Request
Result
/cosmos/tx/v1beta1/txs
/cosmos/tx/v1beta1/txs
Broadcast transaction.
Parameters
body - required object. see example below
Returns
Broadcasted transaction.
Example
Request
Result
/cosmos/tx/v1beta1/txs/{hash}
/cosmos/tx/v1beta1/txs/{hash}
Fetches a tx by hash.
Parameters
hash
- string, required tx hash to query, encoded as a hex string.
Returns
Transaction.
Example
Request
Result
Last updated