Links

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 state of node. Get if the node is currently syncing with other nodes

Parameters

none

Returns

Node syncing status

Example

Request
curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/syncing
Result
{
"syncing": true
}

blocks/latest

Get the latest block.

Parameters

none

Returns

The latest block.

Example

Request
curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/blocks/latest
Result
{
"block_meta": {
"header": {
"chain_id": "cosmoshub-2",
"height": 1,
"time": "2017-12-30T05:53:09.287+01:00",
"num_txs": 0,
"last_block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"total_txs": 35,
"last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"proposer_address": "cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27",
"version": {
"block": 10,
"app": 0
}
},
"block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
}
},
"block": {
"header": {
"chain_id": "cosmoshub-2",
"height": 1,
"time": "2017-12-30T05:53:09.287+01:00",
"num_txs": 0,
"last_block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"total_txs": 35,
"last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"proposer_address": "cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27",
"version": {
"block": 10,
"app": 0
}
},
"txs": [
"string"
],
"evidence": [
"string"
],
"last_commit": {
"block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"precommits": [
{
"validator_address": "string",
"validator_index": "0",
"height": "0",
"round": "0",
"timestamp": "2017-12-30T05:53:09.287+01:00",
"type": 2,
"block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"signature": "7uTC74QlknqYWEwg7Vn6M8Om7FuZ0EO4bjvuj6rwH1mTUJrRuMMZvAAqT9VjNgP0RA/TDp6u/92AqrZfXJSpBQ=="
}
]
}
}
}

blocks/{height}

Get a block at a certain height.

Parameters

  • height - integer, required block height

Returns

none

Example

Request
curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/blocks/1
Result
{
"block_meta": {
"header": {
"chain_id": "cosmoshub-2",
"height": 1,
"time": "2017-12-30T05:53:09.287+01:00",
"num_txs": 0,
"last_block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"total_txs": 35,
"last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"proposer_address": "cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27",
"version": {
"block": 10,
"app": 0
}
},
"block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
}
},
"block": {
"header": {
"chain_id": "cosmoshub-2",
"height": 1,
"time": "2017-12-30T05:53:09.287+01:00",
"num_txs": 0,
"last_block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"total_txs": 35,
"last_commit_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"data_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"next_validators_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"consensus_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"app_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"last_results_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"evidence_hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"proposer_address": "cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27",
"version": {
"block": 10,
"app": 0
}
},
"txs": [
"string"
],
"evidence": [
"string"
],
"last_commit": {
"block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"precommits": [
{
"validator_address": "string",
"validator_index": "0",
"height": "0",
"round": "0",
"timestamp": "2017-12-30T05:53:09.287+01:00",
"type": 2,
"block_id": {
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
"parts": {
"total": 0,
"hash": "EE5F3404034C524501629B56E0DDC38FAD651F04"
}
},
"signature": "7uTC74QlknqYWEwg7Vn6M8Om7FuZ0EO4bjvuj6rwH1mTUJrRuMMZvAAqT9VjNgP0RA/TDp6u/92AqrZfXJSpBQ=="
}
]
}
}
}

validatorsets/latest

Get the latest validator set (latest block height).

Parameters

none

Returns

The validator set at the latest block height

Example

Request
curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/validatorsets/latest
Result
{
"block_height": "string",
"validators": [
{
"address": "cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l",
"pub_key": "cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf",
"voting_power": "1000",
"proposer_priority": "1000"
}
]
}

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
curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/validatorsets/{height}
Result
{
"block_height": "string",
"validators": [
{
"address": "cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l",
"pub_key": "cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf",
"voting_power": "1000",
"proposer_priority": "1000"
}
]
}

Query

cosmos/auth methods

/cosmos/auth/v1beta1/accounts/{address}

Returns account details based on address.

Parameters

  • address - string, required address to query for

Returns

Account details

Example

Request
curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/cosmos/auth/v1beta1/accounts/{address}
Result
{
"account": {
"type_url": "string",
"value": "string"
}
}

NOTE:Example requests below have not been updated. When making requests please use:

https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest

/cosmos/auth/v1beta1/params

Query all parameters.

Parameters

none

Returns

Parameters

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/auth/v1beta1/params
Result
{
"params": {
"max_memo_characters": "string",
"tx_sig_limit": "string",
"tx_size_cost_per_byte": "string",
"sig_verify_cost_ed25519": "string",
"sig_verify_cost_secp256k1": "string"
}
}

cosmos/bank methods

/cosmos/bank/v1beta1/balances/{address}

Returns the balance of all coins for a single account.

Parameters

  • address - string, required address to query balances for
  • pagination.key - string($byte), value returned in PageResponse.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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/balances/{address}
Result
{
"balances": [
{
"denom": "string",
"amount": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}

/cosmos/bank/v1beta1/balances/{address}/{denom}

Return balance of a single coin for a single account.

Parameters

  • address - string, required address to query balances for
  • denom - string, required coin denom to query balances for

Returns

Balance of the specific coin for a single account.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/balances/{address}/{denom}
Result
{
"balance": {
"denom": "string",
"amount": "string"
}
}

/cosmos/bank/v1beta1/params

Queries the parameters of x/bank module.

Parameters

none

Returns

Parameters of x/bank module.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/params
Result
{
"params": {
"send_enabled": [
{
"denom": "string",
"enabled": true
}
],
"default_send_enabled": true
}
}

/cosmos/bank/v1beta1/supply

Returns the total supply of all coins.

Parameters

none

Returns

Supply of all coins.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/supply
Result
{
"supply": [
{
"denom": "string",
"amount": "string"
}
]
}

/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/supply/{denom}
Result
{
"amount": {
"denom": "string",
"amount": "string"
}
}

cosmos/distribution methods

/cosmos​/distribution​/v1beta1​/community_pool

Queries the community pool coins.

Parameters

none

Returns

Community pool coins.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos​/distribution​/v1beta1​/community_pool
Result
{
"pool": [
{
"denom": "string",
"amount": "string"
}
]
}

​/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset​/cosmos​/distribution​/v1beta1​/delegators​/{delegator_address}/rewards
Result
{
"rewards": [
{
"validator_address": "string",
"reward": [
{
"denom": "string",
"amount": "string"
}
]
}
],
"total": [
{
"denom": "string",
"amount": "string"
}
]
}

/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 for
  • validator_address - string, required validator address to query for

Returns

Total rewards accrued by a delegation for a specific validator.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}
Result
{
"rewards": [
{
"denom": "string",
"amount": "string"
}
]
}

/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators
Result
{
"validators": [
"string"
]
}

/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address
Result
{
"withdraw_address": "string"
}

/cosmos/distribution/v1beta1/params

Queries params of the distribution module.

Parameters

none

Returns

Params of the distribution module.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/params
Result
{
"params": {
"community_tax": "string",
"base_proposer_reward": "string",
"bonus_proposer_reward": "string",
"withdraw_addr_enabled": true
}
}

/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/validators/{validator_address}/commission
Result
{
"commission": {
"commission": [
{
"denom": "string",
"amount": "string"
}
]
}
}

/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards
Result
{
"rewards": {
"rewards": [
{
"denom": "string",
"amount": "string"
}
]
}
}

​/cosmos​/distribution​/v1beta1​/validators​/{validator_address}​/slashes

Returns slash events of a validator

Parameters

  • validator_address - string, required validator address to query for
  • starting_height - string($uint64), the optional starting height to query the hashes
  • ending_height - string($uint64), the optional ending height to query the hashes
  • pagination.key - string($byte), value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key - string($uint64), numeric offset that can be used when key is unavailable (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 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 when offset is used, ignored when key is set.

Returns

All slash events of a validator.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset​/cosmos​/distribution​/v1beta1​/validators​/{validator_address}/slashes
Result
{
"slashes": [
{
"validator_period": "string",
"fraction": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}

cosmos/evidence methods

/cosmos/evidence/v1beta1/evidence

Queries all evidence.

Parameters

  • pagination.key - string($byte), value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key - string($uint64), numeric offset that can be used when key is unavailable (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 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 when offset is used, ignored when key is set.

Returns

All evidence.

Example

Request
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/evidence/v1beta1/evidence
Result
{
"evidence": [
{
"type_url": "string",
"value": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}

/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/evidence/v1beta1/evidence/{evidence_hash}
Result
{
"evidence": {
"type_url": "string",
"value": "string"
}
}

cosmos/gov methods

/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
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/params/{params_type}
Result
{
"voting_params": {
"voting_period": "string"
},
"deposit_params": {
"min_deposit": [
{
"denom": "string",
"amount": "string"
}