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
or