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"
    }
  ],
  "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"
      }
    ],
    "max_deposit_period": "string"
  },
  "tally_params": {
    "quorum": "string",
    "threshold": "string",
    "veto_threshold": "string"
  }
}

`/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_UNSPECIFIED
- PROPOSAL_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 proposals
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

Proposals based on given status.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/proposals

Result

{
  "proposals": [
    {
      "proposal_id": "string",
      "content": {
        "type_url": "string",
        "value": "string"
      },
      "status": "PROPOSAL_STATUS_UNSPECIFIED",
      "final_tally_result": {
        "yes": "string",
        "abstain": "string",
        "no": "string",
        "no_with_veto": "string"
      },
      "submit_time": "2021-01-19T03:03:05.413Z",
      "deposit_end_time": "2021-01-19T03:03:05.413Z",
      "total_deposit": [
        {
          "denom": "string",
          "amount": "string"
        }
      ],
      "voting_start_time": "2021-01-19T03:03:05.413Z",
      "voting_end_time": "2021-01-19T03:03:05.413Z"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/proposals/{proposal_id}

Result

{
  "proposal": {
    "proposal_id": "string",
    "content": {
      "type_url": "string",
      "value": "string"
    },
    "status": "PROPOSAL_STATUS_UNSPECIFIED",
    "final_tally_result": {
      "yes": "string",
      "abstain": "string",
      "no": "string",
      "no_with_veto": "string"
    },
    "submit_time": "2021-01-19T03:30:27.807Z",
    "deposit_end_time": "2021-01-19T03:30:27.807Z",
    "total_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "voting_start_time": "2021-01-19T03:30:27.807Z",
    "voting_end_time": "2021-01-19T03:30:27.807Z"
  }
}

`/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits`

Queries all deposits of a single proposal.

Parameters

proposal_id - string($uint64), required unique id of the proposal
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 deposits based on a proposalID.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits

Result

{
  "deposits": [
    {
      "proposal_id": "string",
      "depositor": "string",
      "amount": [
        {
          "denom": "string",
          "amount": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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 proposal
depositor - string, the deposit addresses from the proposals.

Returns

Single deposit based on a proposalID.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}

Result

{
  "deposit": {
    "proposal_id": "string",
    "depositor": "string",
    "amount": [
      {
        "denom": "string",
        "amount": "string"
      }
    ]
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/proposals/{proposal_id}/tally

Result

{
  "tally": {
    "yes": "string",
    "abstain": "string",
    "no": "string",
    "no_with_veto": "string"
  }
}

`/cosmos/gov/v1beta1/proposals/{proposal_id}/votes`

Queries votes of a given proposal.

Parameters

proposal_id - string($uint64), required unique id of the proposal
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

Votes for a given proposal.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/proposals/{proposal_id}/votes

Result

{
  "votes": [
    {
      "proposal_id": "string",
      "voter": "string",
      "option": "VOTE_OPTION_UNSPECIFIED"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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 proposal
voter - string, the other address for the proposals

Returns

Votes for a given proposal.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}

Result

{
  "vote": {
    "proposal_id": "string",
    "voter": "string",
    "option": "VOTE_OPTION_UNSPECIFIED"
  }
}

`cosmos/mint` methods

`/cosmos/mint/v1beta1/annual_provisions`

Returns current minting annual provisions value.

Parameters

none

Returns

Value of minting annual provisions.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/mint/v1beta1/annual_provisions

Result

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "string"
    }
  ]
}

`/cosmos/mint/v1beta1/inflation`

Returns the current minting inflation value.

Parameters

none

Returns

Current minting inflation value.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/mint/v1beta1/inflation

Result

{
  "inflation": "string"
}

`/cosmos/mint/v1beta1/params`

Returns the total set of minting parameters

Parameters

none

Returns

Total set of minting params.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/mint/v1beta1/params

Result

{
  "params": {
    "mint_denom": "string",
    "inflation_rate_change": "string",
    "inflation_max": "string",
    "inflation_min": "string",
    "goal_bonded": "string",
    "blocks_per_year": "string"
  }
}

`cosmos/params` methods

`/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 for
key - string, the key of the parameter in the subspace

Returns

A specific parameter of a module.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/params/v1beta1/params

Result

{
  "param": {
    "subspace": "string",
    "key": "string",
    "value": "string"
  }
}

`cosmos/slashing` methods

`/cosmos/slashing/v1beta1/params`

Queries the parameters of slashing module

Parameters

none

Returns

The parameters of a slashing module.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/slashing/v1beta1/params

Result

{
  "params": {
    "signed_blocks_window": "string",
    "min_signed_per_window": "string",
    "downtime_jail_duration": "string",
    "slash_fraction_double_sign": "string",
    "slash_fraction_downtime": "string"
  }
}

`/cosmos/slashing/v1beta1/signing_infos`

Queries signing info of all validators

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

The signing info of all validators.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/slashing/v1beta1/signing_infos

Result

{
  "info": [
    {
      "address": "string",
      "start_height": "string",
      "index_offset": "string",
      "jailed_until": "2021-01-19T06:33:32.230Z",
      "tombstoned": true,
      "missed_blocks_counter": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/slashing/v1beta1/signing_infos/{cons_address}

Result

{
  "val_signing_info": {
    "address": "string",
    "start_height": "string",
    "index_offset": "string",
    "jailed_until": "2021-01-19T06:34:40.106Z",
    "tombstoned": true,
    "missed_blocks_counter": "string"
  }
}

`cosmos/staking` methods

`/cosmos/staking/v1beta1/delegations/{delegator_addr}`

Queries all delegations of a given delegator address.

Parameters

delegator_addr - string, required delegator address to query for
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

Delegations from a specific delegator address.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/delegations/{delegator_addr}

Result

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "string",
        "validator_address": "string",
        "shares": "string"
      },
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations`

Queries redelegations of given address.

Parameters

delegator_addr - string, required delegator address to query for
src_validator_addr - string, the validator address to redelegate from
dst_validator_addr - string, the validator address to redelegate to
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

Delegations from a specific delegator address.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations

Result

{
  "redelegation_responses": [
    {
      "redelegation": {
        "delegator_address": "string",
        "validator_src_address": "string",
        "validator_dst_address": "string",
        "entries": [
          {
            "creation_height": "string",
            "completion_time": "2021-01-19T06:58:45.718Z",
            "initial_balance": "string",
            "shares_dst": "string"
          }
        ]
      },
      "entries": [
        {
          "redelegation_entry": {
            "creation_height": "string",
            "completion_time": "2021-01-19T06:58:45.718Z",
            "initial_balance": "string",
            "shares_dst": "string"
          },
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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 for
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

Unbonding delegations from a specific delegator address.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

Result

{
  "unbonding_responses": [
    {
      "delegator_address": "string",
      "validator_address": "string",
      "entries": [
        {
          "creation_height": "string",
          "completion_time": "2021-01-19T07:01:25.628Z",
          "initial_balance": "string",
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators`

Queries all validators info for given delegator address.

Parameters

delegator_addr - string, required delegator address to query for
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

Validator info for a specific delegator address.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators

Result

{
  "validators": [
    {
      "operator_address": "string",
      "consensus_pubkey": {
        "type_url": "string",
        "value": "string"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "string",
      "delegator_shares": "string",
      "description": {
        "moniker": "string",
        "identity": "string",
        "website": "string",
        "security_contact": "string",
        "details": "string"
      },
      "unbonding_height": "string",
      "unbonding_time": "2021-01-19T07:06:38.006Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2021-01-19T07:06:38.006Z"
      },
      "min_self_delegation": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

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

Returns

Validator info for a given delegator pair.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}

Result

{
  "validator": {
    "operator_address": "string",
    "consensus_pubkey": {
      "type_url": "string",
      "value": "string"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "security_contact": "string",
      "details": "string"
    },
    "unbonding_height": "string",
    "unbonding_time": "2021-01-19T07:08:34.100Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2021-01-19T07:08:34.100Z"
    },
    "min_self_delegation": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/historical_info/{height}

Result

{
  "hist": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2021-01-19T07:13:57.974Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "valset": [
      {
        "operator_address": "string",
        "consensus_pubkey": {
          "type_url": "string",
          "value": "string"
        },
        "jailed": true,
        "status": "BOND_STATUS_UNSPECIFIED",
        "tokens": "string",
        "delegator_shares": "string",
        "description": {
          "moniker": "string",
          "identity": "string",
          "website": "string",
          "security_contact": "string",
          "details": "string"
        },
        "unbonding_height": "string",
        "unbonding_time": "2021-01-19T07:13:57.974Z",
        "commission": {
          "commission_rates": {
            "rate": "string",
            "max_rate": "string",
            "max_change_rate": "string"
          },
          "update_time": "2021-01-19T07:13:57.974Z"
        },
        "min_self_delegation": "string"
      }
    ]
  }
}

`/cosmos/staking/v1beta1/params`

Queries the staking parameters.

Parameters

none

Returns

Staking parameters.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/params

Result

{
  "params": {
    "unbonding_time": "string",
    "max_validators": 0,
    "max_entries": 0,
    "historical_entries": 0,
    "bond_denom": "string"
  }
}

`/cosmos/staking/v1beta1/pool`

Queries the pool info.

Parameters

none

Returns

Pool info.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/pool

Result

{
  "pool": {
    "not_bonded_tokens": "string",
    "bonded_tokens": "string"
  }
}

`/cosmos/staking/v1beta1/validators`

Queries all validators that match the given status.

Parameters

status - string, status to query validators
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

Validators that match the given status.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/validators

Result

{
  "validators": [
    {
      "operator_address": "string",
      "consensus_pubkey": {
        "type_url": "string",
        "value": "string"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "string",
      "delegator_shares": "string",
      "description": {
        "moniker": "string",
        "identity": "string",
        "website": "string",
        "security_contact": "string",
        "details": "string"
      },
      "unbonding_height": "string",
      "unbonding_time": "2021-01-19T07:21:25.914Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2021-01-19T07:21:25.914Z"
      },
      "min_self_delegation": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/validators/{validator_addr}

Result

{
  "validator": {
    "operator_address": "string",
    "consensus_pubkey": {
      "type_url": "string",
      "value": "string"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "security_contact": "string",
      "details": "string"
    },
    "unbonding_height": "string",
    "unbonding_time": "2021-01-19T07:25:26.679Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2021-01-19T07:25:26.679Z"
    },
    "min_self_delegation": "string"
  }
}

`/cosmos/staking/v1beta1/validators/{validator_addr}/delegations`

Queries delegate info for given validator.

Parameters

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

Delegate info for a given validator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

Result

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "string",
        "validator_address": "string",
        "shares": "string"
      },
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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 for
delegator_addr - string, required delegator address to query for

Returns

Delegate info for a given validator delegator pair.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}

Result

{
  "delegation_response": {
    "delegation": {
      "delegator_address": "string",
      "validator_address": "string",
      "shares": "string"
    },
    "balance": {
      "denom": "string",
      "amount": "string"
    }
  }
}

`/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 for
delegator_addr - string, required delegator address to query for

Returns

Unbonding info for a given validator delegator pair.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation

Result

{
  "unbond": {
    "delegator_address": "string",
    "validator_address": "string",
    "entries": [
      {
        "creation_height": "string",
        "completion_time": "2021-01-19T07:35:28.235Z",
        "initial_balance": "string",
        "balance": "string"
      }
    ]
  }
}

`/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations`

Queries unbonding delegations of a validator.

Parameters

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

Unbonding info for a given validator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

Result

{
  "unbonding_responses": [
    {
      "delegator_address": "string",
      "validator_address": "string",
      "entries": [
        {
          "creation_height": "string",
          "completion_time": "2021-01-19T07:37:20.281Z",
          "initial_balance": "string",
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`cosmos/upgrade` methods

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/upgrade/v1beta1/applied_plan/{name}

Result

{
  "height": "string"
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/upgrade/v1beta1/current_plan

Result

{
  "plan": {
    "name": "string",
    "time": "2021-01-19T07:49:08.875Z",
    "height": "string",
    "info": "string",
    "upgraded_client_state": {
      "type_url": "string",
      "value": "string"
    }
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}

Result

{
  "upgraded_consensus_state": {
    "type_url": "string",
    "value": "string"
  }
}

`ibc/core` methods

`/ibc/core/channel/v1beta1/channels`

Queries all the IBC channels of a chain.

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

IBC channels of a chain.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels

Result

{
  "channels": [
    {
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "ordering": "ORDER_NONE_UNSPECIFIED",
      "counterparty": {
        "port_id": "string",
        "channel_id": "string"
      },
      "connection_hops": [
        "string"
      ],
      "version": "string",
      "port_id": "string",
      "channel_id": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}`

Queries an IBC Channel.

Parameters

channel_id - string, required channel unique identifier
port_id - string, required port unique identifier

Returns

IBC channels of a chain.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}

Result

{
  "channel": {
    "state": "STATE_UNINITIALIZED_UNSPECIFIED",
    "ordering": "ORDER_NONE_UNSPECIFIED",
    "counterparty": {
      "port_id": "string",
      "channel_id": "string"
    },
    "connection_hops": [
      "string"
    ],
    "version": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier

Returns

Client state.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state

Result

{
  "identified_client_state": {
    "client_id": "string",
    "client_state": {
      "type_url": "string",
      "value": "string"
    }
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
revision_number - string($uint64), required revision number of the consensus state
revision_height - string($uint64), required revision height of the consensus state

Returns

Consensus state.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Result

{
  "consensus_state": {
    "type_url": "string",
    "value": "string"
  },
  "client_id": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier

Returns

Next receive sequence.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence

Result

{
  "next_sequence_receive": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
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

Packet acknowledgements.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements

Result

{
  "acknowledgements": [
    {
      "port_id": "string",
      "channel_id": "string",
      "sequence": "string",
      "data": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
sequence - string($uint64), packet sequence

Returns

Packet acknowledgements.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}

Result

{
  "acknowledgement": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
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

Packet commitments.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments

Result

{
  "commitments": [
    {
      "port_id": "string",
      "channel_id": "string",
      "sequence": "string",
      "data": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
packet_ack_sequence - array[string], required list of acknowledgement sequences

Returns

Unreceived IBC acknowledgements.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks

Result

{
  "sequences": [
    "string"
  ],
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
packet_commitment_sequences -array[string], list of packet sequences

Returns

Unreceived IBC packets.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets

Result

{
  "sequences": [
    "string"
  ],
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
sequence - string($uint64), required packet sequence

Returns

Packet commitment hash.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}

Result

{
  "commitment": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
port_id - string, required port unique identifier
sequence - string($uint64), required packet sequence

Returns

Whether or not the given packet has been received.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}

Result

{
  "received": true,
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/ibc/core/channel/v1beta1/connections/{connection}/channels`

Queries all the channels associated with a connection end.

Parameters

connection - string, required connection unique identifier
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

Channels associated with a connection

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/channel/v1beta1/connections/{connection}/channels

Result

{
  "channels": [
    {
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "ordering": "ORDER_NONE_UNSPECIFIED",
      "counterparty": {
        "port_id": "string",
        "channel_id": "string"
      },
      "connection_hops": [
        "string"
      ],
      "version": "string",
      "port_id": "string",
      "channel_id": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/ibc/client/v1beta1/params`

Queries all parameters of the IBC client.

Parameters

none

Returns

Params of the IBC client.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/client/v1beta1/params

Result

{
  "params": {
    "allowed_clients": [
      "string"
    ]
  }
}

`/ibc/core/client/v1beta1/client_states`

Queries all the IBC light clients of a chain.

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

IBC light clients.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/client/v1beta1/client_states

Result

{
  "client_states": [
    {
      "client_id": "string",
      "client_state": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/client/v1beta1/client_states/{client_id}

Result

{
  "client_state": {
    "type_url": "string",
    "value": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
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

Consensus state associated with given client

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/client/v1beta1/consensus_states/{client_id}

Result

{
  "consensus_states": [
    {
      "height": {
        "revision_number": "string",
        "revision_height": "string"
      },
      "consensus_state": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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 identifier
revision_number - string($uint64), required consensus state revision number
revision_height- string($uint64), required consensus state revision height
latest_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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}

Result

{
  "consensus_state": {
    "type_url": "string",
    "value": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/connection/v1beta1/client_connections/{client_id}

Result

{
  "connection_paths": [
    "string"
  ],
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/ibc/core/connection/v1beta1/connections`

Queries all the IBC connections of a chain.

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

IBC connections.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/connection/v1beta1/connections

Result

{
  "connections": [
    {
      "id": "string",
      "client_id": "string",
      "versions": [
        {
          "identifier": "string",
          "features": [
            "string"
          ]
        }
      ],
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "counterparty": {
        "client_id": "string",
        "connection_id": "string",
        "prefix": {
          "key_prefix": "string"
        }
      },
      "delay_period": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/connection/v1beta1/connections/{connection_id}

Result

{
  "connection": {
    "client_id": "string",
    "versions": [
      {
        "identifier": "string",
        "features": [
          "string"
        ]
      }
    ],
    "state": "STATE_UNINITIALIZED_UNSPECIFIED",
    "counterparty": {
      "client_id": "string",
      "connection_id": "string",
      "prefix": {
        "key_prefix": "string"
      }
    },
    "delay_period": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/connection/v1beta1/connections/{connection_id}/client_state

Result

{
  "identified_client_state": {
    "client_id": "string",
    "client_state": {
      "type_url": "string",
      "value": "string"
    }
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`/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 identifier
revision_number - string($uint64), required revision number
revision_height - string($uint64), required revision height

Returns

Consensus state.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Result

{
  "consensus_state": {
    "type_url": "string",
    "value": "string"
  },
  "client_id": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

`ibc/applications` methods

`/ibc/applications/transfer/v1beta1/denom_traces`

Queries all denomination traces.

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

Denomination traces.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/applications/transfer/v1beta1/denom_traces

Result

{
  "denom_traces": [
    {
      "path": "string",
      "base_denom": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/applications/transfer/v1beta1/denom_traces/{hash}

Result

{
  "denom_trace": {
    "path": "string",
    "base_denom": "string"
  }
}

`/ibc/applications/transfer/v1beta1/params`

Queries all parameters of the ibc-transfer module.

Parameters

none

Returns

Parameters of the IBC-transfer module.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/ibc/applications/transfer/v1beta1/params

Result

{
  "params": {
    "send_enabled": true,
    "receive_enabled": true
  }
}

Service

`cosmos/base` methods

`/cosmos/base/tendermint/v1beta1/blocks/latest`

Returns the latest block.

Parameters

none

Returns

Latest block.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/base/tendermint/v1beta1/blocks/latest

Result

{
  "block_id": {
    "hash": "string",
    "part_set_header": {
      "total": 0,
      "hash": "string"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2021-01-19T15:50:40.377Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "data": {
      "txs": [
        "string"
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2021-01-19T15:50:40.378Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string"
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2021-01-19T15:50:40.378Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2021-01-19T15:50:40.378Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2021-01-19T15:50:40.378Z",
                  "last_block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "last_commit_hash": "string",
                  "data_hash": "string",
                  "validators_hash": "string",
                  "next_validators_hash": "string",
                  "consensus_hash": "string",
                  "app_hash": "string",
                  "last_results_hash": "string",
                  "evidence_hash": "string",
                  "proposer_address": "string"
                },
                "commit": {
                  "height": "string",
                  "round": 0,
                  "block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "string",
                      "timestamp": "2021-01-19T15:50:40.378Z",
                      "signature": "string"
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "string",
                    "pub_key": {
                      "ed25519": "string",
                      "secp256k1": "string"
                    },
                    "voting_power": "string",
                    "proposer_priority": "string"
                  }
                ],
                "proposer": {
                  "address": "string",
                  "pub_key": {
                    "ed25519": "string",
                    "secp256k1": "string"
                  },
                  "voting_power": "string",
                  "proposer_priority": "string"
                },
                "total_voting_power": "string"
              }
            },
            "common_height": "string",
            "byzantine_validators": [
              {
                "address": "string",
                "pub_key": {
                  "ed25519": "string",
                  "secp256k1": "string"
                },
                "voting_power": "string",
                "proposer_priority": "string"
              }
            ],
            "total_voting_power": "string",
            "timestamp": "2021-01-19T15:50:40.378Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "string",
      "round": 0,
      "block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "string",
          "timestamp": "2021-01-19T15:50:40.378Z",
          "signature": "string"
        }
      ]
    }
  }
}

`/cosmos/base/tendermint/v1beta1/blocks/{height}`

Queries block for given height.

Parameters

height - string($int64), required block height

Returns

Latest block.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/base/tendermint/v1beta1/blocks/{height}

Result

{
  "block_id": {
    "hash": "string",
    "part_set_header": {
      "total": 0,
      "hash": "string"
    }
  },
  "block": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2021-01-19T15:58:09.922Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "data": {
      "txs": [
        "string"
      ]
    },
    "evidence": {
      "evidence": [
        {
          "duplicate_vote_evidence": {
            "vote_a": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2021-01-19T15:58:09.922Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string"
            },
            "vote_b": {
              "type": "SIGNED_MSG_TYPE_UNKNOWN",
              "height": "string",
              "round": 0,
              "block_id": {
                "hash": "string",
                "part_set_header": {
                  "total": 0,
                  "hash": "string"
                }
              },
              "timestamp": "2021-01-19T15:58:09.922Z",
              "validator_address": "string",
              "validator_index": 0,
              "signature": "string"
            },
            "total_voting_power": "string",
            "validator_power": "string",
            "timestamp": "2021-01-19T15:58:09.922Z"
          },
          "light_client_attack_evidence": {
            "conflicting_block": {
              "signed_header": {
                "header": {
                  "version": {
                    "block": "string",
                    "app": "string"
                  },
                  "chain_id": "string",
                  "height": "string",
                  "time": "2021-01-19T15:58:09.922Z",
                  "last_block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "last_commit_hash": "string",
                  "data_hash": "string",
                  "validators_hash": "string",
                  "next_validators_hash": "string",
                  "consensus_hash": "string",
                  "app_hash": "string",
                  "last_results_hash": "string",
                  "evidence_hash": "string",
                  "proposer_address": "string"
                },
                "commit": {
                  "height": "string",
                  "round": 0,
                  "block_id": {
                    "hash": "string",
                    "part_set_header": {
                      "total": 0,
                      "hash": "string"
                    }
                  },
                  "signatures": [
                    {
                      "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
                      "validator_address": "string",
                      "timestamp": "2021-01-19T15:58:09.922Z",
                      "signature": "string"
                    }
                  ]
                }
              },
              "validator_set": {
                "validators": [
                  {
                    "address": "string",
                    "pub_key": {
                      "ed25519": "string",
                      "secp256k1": "string"
                    },
                    "voting_power": "string",
                    "proposer_priority": "string"
                  }
                ],
                "proposer": {
                  "address": "string",
                  "pub_key": {
                    "ed25519": "string",
                    "secp256k1": "string"
                  },
                  "voting_power": "string",
                  "proposer_priority": "string"
                },
                "total_voting_power": "string"
              }
            },
            "common_height": "string",
            "byzantine_validators": [
              {
                "address": "string",
                "pub_key": {
                  "ed25519": "string",
                  "secp256k1": "string"
                },
                "voting_power": "string",
                "proposer_priority": "string"
              }
            ],
            "total_voting_power": "string",
            "timestamp": "2021-01-19T15:58:09.922Z"
          }
        }
      ]
    },
    "last_commit": {
      "height": "string",
      "round": 0,
      "block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "signatures": [
        {
          "block_id_flag": "BLOCK_ID_FLAG_UNKNOWN",
          "validator_address": "string",
          "timestamp": "2021-01-19T15:58:09.922Z",
          "signature": "string"
        }
      ]
    }
  }
}

`/cosmos/base/tendermint/v1beta1/node_info`

Queries the current node info.

Parameters

none

Returns

Node info.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/base/tendermint/v1beta1/node_info

Result

{
  "default_node_info": {
    "protocol_version": {
      "p2p": "string",
      "block": "string",
      "app": "string"
    },
    "default_node_id": "string",
    "listen_addr": "string",
    "network": "string",
    "version": "string",
    "channels": "string",
    "moniker": "string",
    "other": {
      "tx_index": "string",
      "rpc_address": "string"
    }
  },
  "application_version": {
    "name": "string",
    "app_name": "string",
    "version": "string",
    "git_commit": "string",
    "build_tags": "string",
    "go_version": "string",
    "build_deps": [
      {
        "path": "string",
        "version": "string",
        "sum": "string"
      }
    ]
  }
}

`/cosmos/base/tendermint/v1beta1/syncing`

Queries node syncing.

Parameters

none

Returns

Node syncing status.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset /cosmos/base/tendermint/v1beta1/syncing

Result

{
  "syncing": true
}

`/cosmos/base/tendermint/v1beta1/validatorsets/latest`

Queries latest validator-set.

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

Latest validator set.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/base/tendermint/v1beta1/validatorsets/latest

Result

{
  "block_height": "string",
  "validators": [
    {
      "address": "string",
      "pub_key": {
        "type_url": "string",
        "value": "string"
      },
      "voting_power": "string",
      "proposer_priority": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/base/tendermint/v1beta1/validatorsets/{height}`

Queries validator-set at a given height.

Parameters

height- string($uint64), block height
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

Validator set at given block height.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset /cosmos/base/tendermint/v1beta1/validatorsets/{height}

Result

{
  "block_height": "string",
  "validators": [
    {
      "address": "string",
      "pub_key": {
        "type_url": "string",
        "value": "string"
      },
      "voting_power": "string",
      "proposer_priority": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`cosmos/tx` methods

`/cosmos/tx/v1beta1/simulate`

Simulates executing a transaction for estimating gas usage.

Parameters

body - required object, see example below

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "memo": "string",
      "timeout_height": "string",
      "extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "string",
            "value": "string"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_UNSPECIFIED"
            },
            "multi": {
              "bitarray": {
                "extra_bits_stored": 0,
                "elems": "string"
              },
              "mode_infos": [
                null
              ]
            }
          },
          "sequence": "string"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "string",
            "amount": "string"
          }
        ],
        "gas_limit": "string",
        "payer": "string",
        "granter": "string"
      }
    },
    "signatures": [
      "string"
    ]
  }
}

Returns

Estimated gas usage.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/tx/v1beta1/simulate

Result

{
  "gas_info": {
    "gas_wanted": "string",
    "gas_used": "string"
  },
  "result": {
    "data": "string",
    "log": "string",
    "events": [
      {
        "type": "string",
        "attributes": [
          {
            "key": "string",
            "value": "string",
            "index": true
          }
        ]
      }
    ]
  }
}

`/cosmos/tx/v1beta1/txs`

Fetches txs by event.

Parameters

events- array[string], list of transaction event type
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

Transactions.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/tx/v1beta1/txs

Result

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "memo": "string",
        "timeout_height": "string",
        "extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "non_critical_extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "type_url": "string",
              "value": "string"
            },
            "mode_info": {
              "single": {
                "mode": "SIGN_MODE_UNSPECIFIED"
              },
              "multi": {
                "bitarray": {
                  "extra_bits_stored": 0,
                  "elems": "string"
                },
                "mode_infos": [
                  null
                ]
              }
            },
            "sequence": "string"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "string",
              "amount": "string"
            }
          ],
          "gas_limit": "string",
          "payer": "string",
          "granter": "string"
        }
      },
      "signatures": [
        "string"
      ]
    }
  ],
  "tx_responses": [
    {
      "height": "string",
      "txhash": "string",
      "codespace": "string",
      "code": 0,
      "data": "string",
      "raw_log": "string",
      "logs": [
        {
          "msg_index": 0,
          "log": "string",
          "events": [
            {
              "type": "string",
              "attributes": [
                {
                  "key": "string",
                  "value": "string"
                }
              ]
            }
          ]
        }
      ],
      "info": "string",
      "gas_wanted": "string",
      "gas_used": "string",
      "tx": {
        "type_url": "string",
        "value": "string"
      },
      "timestamp": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/tx/v1beta1/txs`

Broadcast transaction.

Parameters

body - required object. see example below

{
  "tx_bytes": "string",
  "mode": "BROADCAST_MODE_UNSPECIFIED"
}

Returns

Broadcasted transaction.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/tx/v1beta1/txs

Result

{
  "tx_response": {
    "height": "string",
    "txhash": "string",
    "codespace": "string",
    "code": 0,
    "data": "string",
    "raw_log": "string",
    "logs": [
      {
        "msg_index": 0,
        "log": "string",
        "events": [
          {
            "type": "string",
            "attributes": [
              {
                "key": "string",
                "value": "string"
              }
            ]
          }
        ]
      }
    ],
    "info": "string",
    "gas_wanted": "string",
    "gas_used": "string",
    "tx": {
      "type_url": "string",
      "value": "string"
    },
    "timestamp": "string"
  }
}

`/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

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/tx/v1beta1/txs/{hash}

Result

{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "memo": "string",
      "timeout_height": "string",
      "extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "string",
            "value": "string"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_UNSPECIFIED"
            },
            "multi": {
              "bitarray": {
                "extra_bits_stored": 0,
                "elems": "string"
              },
              "mode_infos": [
                null
              ]
            }
          },
          "sequence": "string"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "string",
            "amount": "string"
          }
        ],
        "gas_limit": "string",
        "payer": "string",
        "granter": "string"
      }
    },
    "signatures": [
      "string"
    ]
  },
  "tx_response": {
    "height": "string",
    "txhash": "string",
    "codespace": "string",
    "code": 0,
    "data": "string",
    "raw_log": "string",
    "logs": [
      {
        "msg_index": 0,
        "log": "string",
        "events": [
          {
            "type": "string",
            "attributes": [
              {
                "key": "string",
                "value": "string"
              }
            ]
          }
        ]
      }
    ],
    "info": "string",
    "gas_wanted": "string",
    "gas_used": "string",
    "tx": {
      "type_url": "string",
      "value": "string"
    },
    "timestamp": "string"
  }
}

PreviousTendermint-RPC API NextCompute Units

Last updated 4 years ago

hashtagAlchemy gRPC API

hashtagOfficial gRPC Documentationarrow-up-right

hashtagTendermint RPC

hashtagsyncing

hashtagParameters

hashtagReturns

hashtagExample

hashtagblocks/latest

hashtagParameters

hashtagReturns

hashtagExample

hashtagblocks/{height}

hashtagParameters

hashtagReturns

hashtagExample

hashtagvalidatorsets/latest

hashtagParameters

hashtagReturns

hashtagExample

hashtagvalidatorsets/{height}

hashtagParameters

hashtagReturns

hashtagExample

hashtagQuery

hashtagcosmos/auth methods

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

hashtagParameters

hashtagReturns

hashtagExample

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

hashtag/cosmos/auth/v1beta1/params

hashtagParameters

hashtagReturns

hashtagExample

hashtagcosmos/bank methods

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

hashtagParameters

hashtagReturns

hashtagExample

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

hashtagParameters

hashtagReturns

hashtagExample

hashtag/cosmos/bank/v1beta1/params

hashtagParameters

hashtagReturns

hashtagExample

hashtag/cosmos/bank/v1beta1/supply

hashtagParameters

hashtagReturns

hashtagExample

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

hashtagParameters

hashtagReturns

hashtagExample

hashtagcosmos/distribution methods

hashtag/cosmos​/distribution​/v1beta1​/community_pool

hashtagParameters

hashtagReturns

hashtagExample

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

hashtagParameters

hashtagReturns

hashtagExample

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

hashtagParameters

hashtagReturns

hashtagExample

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

hashtagParameters

hashtagReturns

hashtagExample

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

hashtagParameters

hashtagReturns

hashtagExample

hashtag/cosmos/distribution/v1beta1/params

hashtagParameters

hashtagReturns

hashtagExample

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

Example