gRPC-REST API

Supported methods for Alchemy Crypto.org gRPC-REST API.

Alchemy gRPC API

Here you will find a list of all the methods Alchemy supports for Crypto.org's gRPC API.

There might be methods supported by Crypto.org nodes but not by Alchemy. See the full list of gRPC-REST API methods on the official documentation.

Tendermint RPC

syncing

Syncing state of node. Get if the node is currently syncing with other nodes

Parameters

none

Returns

Node syncing status

Example

Request

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

Result

{
  "syncing": true
}

blocks/latest

Get the latest block.

Parameters

none

Returns

The latest block.

Example

Request

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

Result

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

blocks/{height}

Get a block at a certain height.

Parameters

  • height - integer, required block height

Returns

none

Example

Request

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

Result

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

validatorsets/latest

Get the latest validator set (latest block height).

Parameters

none

Returns

The validator set at the latest block height

Example

Request

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

Result

{
  "block_height": "string",
  "validators": [
    {
      "address": "cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l",
      "pub_key": "cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf",
      "voting_power": "1000",
      "proposer_priority": "1000"
    }
  ]
}

validatorsets/{height}

Get the validator set at a certain height.

Parameters

  • height - integer, required block height

Returns

The validator set at a specific block height.

Example

Request

curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/validatorsets/{height}

Result

{
  "block_height": "string",
  "validators": [
    {
      "address": "cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l",
      "pub_key": "cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf",
      "voting_power": "1000",
      "proposer_priority": "1000"
    }
  ]
}

Query

cosmos/auth methods

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

Returns account details based on address.

Parameters

  • address - string, required address to query for

Returns

Account details

Example

Request

curl https://cro-croeseid.alchemyapi.io/your-api-key/cosmos-rest/cosmos/auth/v1beta1/accounts/{address}

Result

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

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

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

/cosmos/auth/v1beta1/params

Query all parameters.

Parameters

none

Returns

Parameters

Example

Request

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

Result

{
  "params": {
    "max_memo_characters": "string",
    "tx_sig_limit": "string",
    "tx_size_cost_per_byte": "string",
    "sig_verify_cost_ed25519": "string",
    "sig_verify_cost_secp256k1": "string"
  }
}

cosmos/bank methods

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

Returns the balance of all coins for a single account.

Parameters

  • address - string, required address to query balances for

  • pagination.key - string($byte), value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

  • pagination.offset - string($uint64), numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

  • pagination.limit - string($uint64), total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

  • pagination.count_total - boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used, it is ignored when key is set.

Returns

Balance of all coins for a single account

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/balances/{address}

Result

{
  "balances": [
    {
      "denom": "string",
      "amount": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

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

Return balance of a single coin for a single account.

Parameters

  • address - string, required address to query balances for

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

Returns

Balance of the specific coin for a single account.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/balances/{address}/{denom}

Result

{
  "balance": {
    "denom": "string",
    "amount": "string"
  }
}

/cosmos/bank/v1beta1/params

Queries the parameters of x/bank module.

Parameters

none

Returns

Parameters of x/bank module.

Example

Request

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

Result

{
  "params": {
    "send_enabled": [
      {
        "denom": "string",
        "enabled": true
      }
    ],
    "default_send_enabled": true
  }
}

/cosmos/bank/v1beta1/supply

Returns the total supply of all coins.

Parameters

none

Returns

Supply of all coins.

Example

Request

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

Result

{
  "supply": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

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

Returns the supply of a single coin.

Parameters

  • denom - string, required denom of the coin to query balances for

Returns

Total supply of a single coin.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/bank/v1beta1/supply/{denom}

Result

{
  "amount": {
    "denom": "string",
    "amount": "string"
  }
}

cosmos/distribution methods

/cosmos​/distribution​/v1beta1​/community_pool

Queries the community pool coins.

Parameters

none

Returns

Community pool coins.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos​/distribution​/v1beta1​/community_pool

Result

{
  "pool": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

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

Queries the total rewards accrued by each validator.

Parameters

  • delegator_address - string, required delegator address to query for

Returns

Rewards from each validator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset​/cosmos​/distribution​/v1beta1​/delegators​/{delegator_address}​/rewards

Result

{
  "rewards": [
    {
      "validator_address": "string",
      "reward": [
        {
          "denom": "string",
          "amount": "string"
        }
      ]
    }
  ],
  "total": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

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

Queries the total rewards accrued by a delegation.

Parameters

  • delegator_address - string, required delegator address to query for

  • validator_address - string, required validator address to query for

Returns

Total rewards accrued by a delegation for a specific validator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}

Result

{
  "rewards": [
    {
      "denom": "string",
      "amount": "string"
    }
  ]
}

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

Queries the validators of a delegator.

Parameters

  • delegator_address - string, required delegator address to query for

Returns

Validators for a given delegator.

Example

Request

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

Result

{
  "validators": [
    "string"
  ]
}

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

Queries withdraw address of a delegator.

Parameters

  • delegator_address - string, required delegator address to query for

Returns

Withdraw address of delegator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address

Result

{
  "withdraw_address": "string"
}

/cosmos/distribution/v1beta1/params

Queries params of the distribution module.

Parameters

none

Returns

Params of the distribution module.

Example

Request

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

Result

{
  "params": {
    "community_tax": "string",
    "base_proposer_reward": "string",
    "bonus_proposer_reward": "string",
    "withdraw_addr_enabled": true
  }
}

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

Queries accumulated commission for a validator.

Parameters

  • validator_address - string, required validator address to query for

Returns

Total commission for a validator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/validators/{validator_address}/commission

Result

{
  "commission": {
    "commission": [
      {
        "denom": "string",
        "amount": "string"
      }
    ]
  }
}

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

Queries rewards of a validator address.

Parameters

  • validator_address - string, required validator address to query for

Returns

Total outstanding rewards for a validator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards

Result

{
  "rewards": {
    "rewards": [
      {
        "denom": "string",
        "amount": "string"
      }
    ]
  }
}

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

Returns slash events of a validator

Parameters

  • validator_address - string, required validator address to query for

  • starting_height - string($uint64), the optional starting height to query the hashes

  • ending_height - string($uint64), the optional ending height to query the hashes

  • pagination.key - string($byte), value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.

  • pagination.key - string($uint64), numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.

  • pagination.limit - string($uint64), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.

  • pagination.count_total - boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

All slash events of a validator.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset​/cosmos​/distribution​/v1beta1​/validators​/{validator_address}​/slashes

Result

{
  "slashes": [
    {
      "validator_period": "string",
      "fraction": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

cosmos/evidence methods

/cosmos/evidence/v1beta1/evidence

Queries all evidence.

Parameters

  • pagination.key - string($byte), value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.

  • pagination.key - string($uint64), numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.

  • pagination.limit - string($uint64), total number of results to be returned in the results page. If empty, will default to a value to be set by each app.

  • pagination.count_total - boolean, set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

All evidence.

Example

Request

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

Result

{
  "evidence": [
    {
      "type_url": "string",
      "value": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/cosmos/evidence/v1beta1/evidence/{evidence_hash}

Queries evidence based on evidence hash.

Parameters

  • evidence_hash - string($byte), the hash of the requested evidence.

Returns

Evidence for a given hash.

Example

Request

curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/cosmos/evidence/v1beta1/evidence/{evidence_hash}

Result

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

cosmos/gov methods

/cosmos/gov/v1beta1/params/{params_type}

Queries all parameters of the gov module.

Parameters

  • params_type - string, required parameters to query for, can be one of "voting", "tallying", or "deposit"

Returns

Parameters of the gov module.

Example

Request

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

Result

{
  "voting_params": {
    "voting_period": "string"
  },
  "deposit_params": {
    "min_deposit": [
      {
        "denom": "string",
        "amount": "string"
      }
    ],
    "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"
  }
}

Last updated