For AI agents: an LLM-friendly Markdown version of every page is available by appending .md to its URL or by sending an Accept: text/markdown request header. The full documentation index is at https://www.ankr.com/docs/llms.txt
Skip to main content

Kava — Cosmos REST methods

API reference for Kava. All methods ->

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

Retrieves the balance of all coins for a single account.

Parameters​

  • address(string; required): an 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/balances/{address}

Response example​

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

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

Retrieves balance of a single coin for a single account.

Parameters​

  • address (string; required): an address to query balances for.
  • denom (string; required): a coin denom to query balances for.

Returns​

Balance of the specific coin for a single account.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/balances/{address}/{denom}

Response example​

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

/cosmos/bank/v1beta1/params​

Retrieves the parameters of x/bank module.

Parameters​

None.

Returns​

Parameters of x/bank module.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/params

Response example​

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

/cosmos/bank/v1beta1/supply​

Retrieves the total supply of all coins.

Parameters​

None.

Returns​

Supply of all coins.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/supply

Response example​

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

Distribution methods​

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

Retrieves the total rewards accrued by each validator.

Parameters​

  • delegator_address (string; required): a delegator address to query for.

Returns​

Rewards from each validator.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards

Response example​

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

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

Retrieves the total rewards accrued by a delegation.

Parameters​

  • delegator_address (string; required): a delegator address to query for.
  • validator_address (string; required): a validator address to query for.

Returns​

Total rewards accrued by a delegation for a specific validator.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}

Response example​

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

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

Retrieves the validators of a delegator.

Parameters​

  • delegator_address (string; required): a delegator address to query for.

Returns​

Validators for a given delegator.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators

Response example​

{
  "validators": [
    "string"
  ]
}

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

Retrieves withdraw address of a delegator.

Parameters​

  • delegator_address (string, required): a delegator address to query for.

Returns​

Withdraw address of delegator.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address

Response example​

{
  "withdraw_address": "string"
}

/cosmos/distribution/v1beta1/params​

Retrieves params of the distribution module.

Parameters​

None.

Returns​

Params of the distribution module.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/params

Response example​

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

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

Retrieves accumulated commission for a validator.

Parameters​

  • validator_address (string; required): a validator address to query for.

Returns​

Total commission for a validator.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/validators/{validator_address}/commission

Response example​

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

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

Retrieves the rewards of a validator address.

Parameters​

  • validator_address (string; required): validator address to query for.

Returns​

Total outstanding rewards for a validator.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards

Response example​

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

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

Retrieves slash events of a validator.

Parameters​

  • validator_address (string; required): a 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): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/validators/{validator_address}/slashes

Response example​

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

Evidence methods​

/cosmos/evidence/v1beta1/evidence​

Retrieves all evidence.

Parameters​

  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/evidence/v1beta1/evidence

Response example​

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

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

Retrieves evidence based on evidence hash.

Parameters​

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

Returns​

Evidence for a given hash.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/evidence/v1beta1/evidence/{evidence_hash}

Response example​

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

Gov methods​

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

Retrieves all parameters of the gov module.

Parameters​

  • params_type (string, required): parameters to query for; possible values: voting, tallying, or deposit.

Returns​

Parameters of the gov module.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/params/{params_type}

Response example​

{
  "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​

Retrieves all proposals based on given status.

Parameters​

  • proposal_status: defines status of the proposals. See below for different options. Default value = PROPOSAL_STATUS_UNSPECIFIED. Other statuses:
    • 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): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals

Response example​

{
  "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}​

Retrieves proposal details based on ProposalID.

Parameters​

  • proposal_id (string; required): a unique id of the proposal.

Returns​

Proposal details based on proposalID.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}

Response example​

{
  "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​

Retrieves all deposits of a single proposal.

Parameters​

  • proposal_id (string, uint64; required): a unique id of the proposal.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits

Response example​

{
  "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}​

Retrieves single deposit information based proposalID and depositAddr.

Parameters​

  • proposal_id (string, uint64): a required unique id of the proposal.
  • depositor (string): the deposit addresses from the proposals.

Returns​

Single deposit based on a proposalID.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}

Response example​

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

/cosmos/gov/v1beta1/proposals/{proposal_id}/tally​

Retrieves the tally of a proposal vote.

Parameters​

  • proposal_id (string, uint64): a required unique ID of the proposal.

Returns​

Tally of proposal vote.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/tally

Response example​

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

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

Retrieves the votes of a given proposal.

Parameters​

  • proposal_id (string($uint64), required): a unique id of the proposal
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/votes

Response example​

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

/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}​

Retrieves voted information based on proposalID and voterAddr.

Parameters​

  • proposal_id (string, uint64; required): a unique ID of the proposal.
  • voter (string): the other address for the proposals.

Returns​

Votes for a given proposal.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}

Response example​

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

Mint methods​

/cosmos/mint/v1beta1/annual_provisions​

Retrieves the current minting annual provisions value.

Parameters​

None.

Returns​

Value of minting annual provisions.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/mint/v1beta1/annual_provisions

Response example​

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

/cosmos/mint/v1beta1/inflation​

Retrieves the current minting inflation value.

Parameters​

None.

Returns​

Current minting inflation value.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/mint/v1beta1/inflation

Response example​

{
  "inflation": "string"
}

/cosmos/mint/v1beta1/params​

Retrieves the total set of minting parameters

Parameters​

None.

Returns​

Total set of minting params.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/mint/v1beta1/params

Response example​

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

Slashing methods​

/cosmos/slashing/v1beta1/params​

Retrieves the slashing module parameters.

Parameters​

None.

Returns​

The parameters of a slashing module.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/slashing/v1beta1/params

Response example​

{
  "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​

Retrieves signing info of all validators.

Parameters​

  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/slashing/v1beta1/signing_infos

Response example​

{
  "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}​

Retrieves the signing info of given cons address.

Parameters​

  • cons_address (string, required): an address to query signing info for.

Returns​

The signing info of all specified cons address.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/slashing/v1beta1/signing_infos/{cons_address}

Response example​

{
  "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"
  }
}

Staking methods​

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

Retrieves all delegations of a given delegator address.

Parameters​

  • delegator_addr (string, required): a delegator address to query for.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegations/{delegator_addr}

Response example​

{
  "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​

Retrieves the redelegations of a given address.

Parameters​

  • delegator_addr (string, required): a 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): a 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: a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations

Response example​

{
  "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​

Retrieves all unbonding delegations of a given delegator address.

Parameters​

  • delegator_addr (string, required): a delegator address to query for.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

Response example​

{
  "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​

Retrieves all validators info for given delegator address.

Parameters​

  • delegator_addr (string; required): a delegator address to query for.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators

Response example​

{
  "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}​

Retrieves validator info for a given delegator-validator pair.

Parameters​

  • delegator_addr (string; required): a delegator address to query for.
  • validator_addr (string; required): a validator address to query for.

Returns​

Validator info for a given delegator pair.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}

Response example​

{
  "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}​

Retrieves the historical info for a given height.

Parameters​

  • height (string, int64): defines at which height to query the historical info for.

Returns​

Historical info for a given height.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/historical_info/{height}

Response example​

{
  "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​

Retrieves the staking parameters.

Parameters​

None.

Returns​

Staking parameters.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/params

Response example​

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

/cosmos/staking/v1beta1/pool​

Retrieves the pool info.

Parameters​

None.

Returns​

Pool info.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/pool

Response example​

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

/cosmos/staking/v1beta1/validators​

Retrieves all validators that match the given status.

Parameters​

  • status (string): a status to query validators by.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators

Response example​

{
  "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}​

Retrieves validator info for a given validator address.

Parameters​

  • validator_addr (string; required): a validator address to query for.

Returns​

Validator info for a given validator address.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}

Response example​

{
  "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​

Retrieves delegate info for a given validator.

Parameters​

  • validator_addr (string; required): a validator address to query for.
  • pagination.key (string, byte): a 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: a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

Response example​

{
  "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}​

Retrieves delegate info for a given validator-delegator pair.

Parameters​

  • validator_addr (string; required): a validator address to query for.
  • delegator_addr (string; required): a delegator address to query for.

Returns​

Delegate info for a given validator delegator pair.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}

Response example​

{
  "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​

Retrieves unbonding info for a given validator-delegator pair.

Parameters​

  • validator_addr (string; required): a validator address to query for.
  • delegator_addr (string; required): a delegator address to query for.

Returns​

Unbonding info for a given validator delegator pair.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation

Response example​

{
  "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​

Retrieves unbonding delegations of a validator.

Parameters​

  • validator_addr (string, required): a validator address to query for.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

Response example​

{
  "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"
  }
}

Upgrade methods​

/cosmos/upgrade/v1beta1/applied_plan/{name}​

Retrieves a previously applied upgrade plan by its name.

Parameters​

  • name (string; required): a name of the applied plan to query for.

Returns​

Previously applied upgrade plan.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/upgrade/v1beta1/applied_plan/{name}

Response example​

{
  "height": "string"
}

/cosmos/upgrade/v1beta1/current_plan​

Retrieves the current upgrade plan.

Parameters​

  • name (string; required): a name of the applied plan to query for.

Returns​

Current upgrade plan.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/upgrade/v1beta1/current_plan

Response example​

{
  "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}​

Retrieves 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): a required last height under which next consensus state is stored.

Returns​

Consensus state.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}

Response example​

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

Ibc core methods​

/ibc/core/channel/v1beta1/channels​

Retrieves all the IBC channels of a chain.

Parameters​

  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels

Response example​

{
  "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}​

Retrieves an IBC Channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.

Returns​

IBC channels of a chain.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}

Response example​

{
  "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​

Retrieves the client state for the channel associated with the provided channel identifiers.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.

Returns​

Client state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state

Response example​

{
  "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}​

Retrieves the consensus state for the channel associated with the provided channel identifiers.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • revision_number (string, uint64; required): a revision number of the consensus state.
  • revision_height string, uint64; required: a revision height of the consensus state.

Returns​

Consensus state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Response example​

{
  "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​

Retrieves the next receive sequence for a given channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.

Returns​

Next receive sequence.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence

Response example​

{
  "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​

Retrieves all the packet acknowledgements associated with a channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements

Response example​

{
  "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}​

Retrieves a stored packet acknowledgement hash.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • sequence (string, uint64): a packet sequence.

Returns​

Packet acknowledgements.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}

Response example​

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

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments​

Retrieves all the packet commitments hashes associated with a channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments

Response example​

{
  "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​

Retrieves all the unreceived IBC acknowledgements associated with a channel and sequences.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_ack_sequence (array[string]): a required list of acknowledgement sequences.

Returns​

Unreceived IBC acknowledgements.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks

Response example​

{
  "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​

Retrieves all the unreceived IBC packets associated with a channel and sequences.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_commitment_sequences (array[string]): a list of packet sequences.

Returns​

Unreceived IBC packets.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets

Response example​

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

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}​

Retrieves a stored packet commitment hash.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_commitment_sequences (array[string]): a list of packet sequences.

Returns​

Packet commitment hash.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}

Response example​

{
  "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}​

Checks whether a given packet sequence has been received on the queried chain.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • sequence (string, uint64): a required packet sequence.

Returns​

Whether the given packet has been received or not.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}

Response example​

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

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

Retrieves all the channels associated with a connection end.

Parameters​

  • connection (string, required): a connection unique identifier.
  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/connections/{connection}/channels

Response example​

{
  "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​

Retrieves all parameters of the IBC client.

Parameters​

None.

Returns​

Params of the IBC client.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/client/v1beta1/params

Response example​

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

/ibc/core/client/v1beta1/client_states​

Retrieves all the IBC light clients of a chain.

Parameters​

  • pagination.key (string; byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/client_states

Response example​

{
  "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}​

Retrieves an IBC light client.

Parameters​

  • client_id (string; required): a client state unique identifier.

Returns​

IBC light client from client_id.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/client_states/{client_id}

Response example​

{
  "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}​

Retrieves all the consensus state associated with a given client.

Parameters​

  • client_id (string; required): a client unique identifier.
  • pagination.key (string, byte): a 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): a 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): a 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

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/consensus_states/{client_id}

Response example​

{
  "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}​

Retrieves a consensus state associated with a client state at a given height.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • revision_number (string, uint64): a required consensus state revision number.
  • revision_height(string, uint64): a required consensus state revision height.
  • latest_height (boolean): overrides the height field and queries the latest stored consensus state.

Returns​

Consensus state associated with a client state at a given height.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}

Response example​

{
  "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}​

Retrieves the connection paths associated with a client state.

Parameters​

  • client_id (string, required): a client identifier associated with a connection.

Returns​

Connections paths associated with a client state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/client_connections/{client_id}

Response example​

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

/ibc/core/connection/v1beta1/connections​

Retrieves all the IBC connections of a chain.

Parameters​

  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections

Response example​

{
  "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}​

Retrieves an IBC connection end.

Parameters​

  • connection_id (string; required): a connection unique identifier.

Returns​

IBC connections end.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}

Response example​

{
  "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​

Retrieves the client state associated with the connection.

Parameters​

  • connection_id (string; required): a connection unique identifier.

Returns​

Client state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}/client_state

Response example​

{
  "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}​

Retrieves the consensus state associated with the connection.

Parameters​

  • connection_id (string; required): a connection unique identifier.
  • revision_number (string, uint64): a required revision number.
  • revision_height (string, uint64): a required revision height.

Returns​

Consensus state.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Response example​

{
  "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​

Retrieves all denomination traces.

Parameters​

  • pagination.key (string, byte): a 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): a 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): a 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.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/applications/transfer/v1beta1/denom_traces

Response example​

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

/ibc/applications/transfer/v1beta1/denom_traces/{hash}​

Retrieves a denomination trace information by hash.

Parameters​

  • hash (string, hex; required): a hash of the denomination trace information.

Returns​

Denomination traces.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/applications/transfer/v1beta1/denom_traces/{hash}

Response example​

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

/ibc/applications/transfer/v1beta1/params​

Retrieves all parameters of the IBC transfer module.

Parameters​

None.

Returns​

Parameters of the IBC transfer module.

Request example​

curl https://rpc.ankr.com/http/kava_api/ibc/applications/transfer/v1beta1/params

Response example​

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

Tx methods​

/cosmos/tx/v1beta1/simulate​

Simulates executing a transaction for estimating gas usage.

Parameters​

  • <body> (object; required):
{
  "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.

Request example​

curl https://rpc.ankr.com/http/kava_api/cosmos/tx/v1beta1/simulate

Response example​

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