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. 
​Official gRPC Documentation​
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"
    }

gRPC-REST API

Alchemy gRPC API

​Official gRPC Documentation​

Tendermint RPC

syncing

Parameters

Returns

Example

blocks/latest

Parameters

Returns

Example

blocks/{height}

Parameters

Returns

Example

validatorsets/latest

Parameters

Returns

Example

validatorsets/{height}

Parameters

Returns

Example

Query

cosmos/auth methods

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

Parameters

Returns

Example

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

/cosmos/auth/v1beta1/params

Parameters

Returns

Example

cosmos/bank methods

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

Parameters

Returns

Example

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

Parameters

Returns

Example

/cosmos/bank/v1beta1/params

Parameters

Returns

Example

/cosmos/bank/v1beta1/supply

Parameters

Returns

Example

/cosmos/bank/v1beta1/supply/{denom}

Parameters

Returns

Example

cosmos/distribution methods

/cosmos​/distribution​/v1beta1​/community_pool

Parameters

Returns

Example

​/cosmos​/distribution​/v1beta1​/delegators​/{delegator_address}​/rewards

Parameters

Returns

Example

/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}

Parameters

Returns

Example

/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators

Parameters

Returns

Example

/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address

Parameters

Returns

Example

/cosmos/distribution/v1beta1/params

Parameters

Returns

Official gRPC Documentation

`syncing`

`blocks/latest`

`blocks/{height}`

`validatorsets/latest`

`validatorsets/{height}`

`cosmos/auth` methods

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

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

`/cosmos/auth/v1beta1/params`

`cosmos/bank` methods

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

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

`/cosmos/bank/v1beta1/params`

`/cosmos/bank/v1beta1/supply`

`/cosmos/bank/v1beta1/supply/{denom}`

`cosmos/distribution` methods

`/cosmos/distribution/v1beta1/community_pool`

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards`

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}`

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators`

`/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address`

`/cosmos/distribution/v1beta1/params`

`/cosmos/distribution/v1beta1/validators/{validator_address}/commission`

`/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards`

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

`cosmos/evidence` methods

`/cosmos/evidence/v1beta1/evidence`