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 (1/4)

API reference for Kava. All methods ->

Part 1 of 4: 1 · 2 · 3 · 4

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