Node API
Supported Chains
API Reference
Kava

Kava

Kava API is available on Web3 API platform (opens in a new tab).

The Kava Network is the Layer-1 blockchain that combines the speed and scalability of the Cosmos SDK with the developer support of Ethereum. Kava will empower developers to build for Web3 and next-gen blockchain technologies through its unique co-chain architecture. KAVA is the native governance and staking token of the Kava Network, enabling its decentralization and security.

In order for your Web3 application to interact with Kava — either by reading blockchain data or sending transactions to the network — it must connect to a Kava node. Developers interact with the blockchain using the methods provided by the API.

We support the following networks and protocols for Kava:

Responses come in JSON format (opens in a new tab).

EVM JSON-RPC methods


web3_clientVersion

Returns the current client version.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <string>: the current client version.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "web3_clientVersion",
      "params": [],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "Version dev ()Compiled at  using Go go1.21.1 (amd64)"
}

web3_sha3

Returns Keccak-256 (not the standardized SHA3-256) of the given data.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    • <string> (data): the data to convert into a SHA3 hash.

Returns

  • <string> (data): the SHA3 result of the given string.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "web3_sha3",
      "params": ["0x68656c6c6f20776f726c64"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x5b2c76da96136d193336fad3fbc049867b8ca157da22f69ae0e4923648250acc"
}

net_version

Returns the current network ID.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <string>: the current network ID.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "net_version",
      "params": [],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "2222"
}

net_listening

Returns true if client is actively listening for network connections.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <boolean>: true when listening, otherwise false.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "net_listening",
      "params": [],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": true
}

eth_protocolVersion

Returns the current Ethereum protocol version.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <string>: the current Ethereum protocol version.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_protocolVersion",
      "params": [],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "result": "0x41",
    "id": 1
}

eth_syncing

Returns an object with data about the sync status or false.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <object>|<boolean>: an object with sync status data or false, when not syncing:
    • startingBlock (quantity): the block at which the import started (will only be reset, after the sync reached its head).
    • currentBlock (quantity): the current block, same as eth_blockNumber.
    • highestBlock (quantity): the estimated highest block.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_syncing",
      "params": [],
      "id": 1
    }'

Response example (syncing)

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "startingBlock": "0x384",
        "currentBlock": "0x386",
        "highestBlock": "0x454"
    }
}

Response example (not syncing)

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": false
}

eth_gasPrice

Returns the current price per gas in wei.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <string> (quantity): the current gas price in wei.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_gasPrice",
      "params": [],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x3b9aca00"
}

eth_accounts

Returns a list of addresses owned by client.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <array> (string; data, 20 bytes): addresses owned by the client.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_accounts",
      "params": [],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": [
        "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
    ]
}

eth_blockNumber

Returns the number of most recent block.

Parameters

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): None.

Returns

  • <string> (quantity): the current block number the client is on.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_blockNumber",
      "params": [],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x847e09"
}

eth_getBalance

Returns the balance of the account specified by address.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 20 bytes): an address to check for balance.
    2. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:
      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (quantity): the current balance in wei.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getBalance",
      "params": ["0xCe292495Ac1166215eA02f1616900F90B3C20762", "latest"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x594c67b5408f"
}

eth_getStorageAt

Returns the value from a storage position at an address specified.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 20 bytes): an address of the storage (hex encoded).

    2. <string> (quantity): a slot position in the storage (hex encoded unsigned integer).

    3. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:

      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (data): the value at this storage position.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getStorageAt",
      "params": ["0xCe292495Ac1166215eA02f1616900F90B3C20762", "0x0", "latest"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

eth_getTransactionCount

Returns the number of transactions sent from an address.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 20 bytes): an address.

    2. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:

      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (quantity): the number of transactions send from this address.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getTransactionCount",
      "params": ["0xB8FF877ed78Ba520Ece21B1de7843A8a57cA47Cb", "latest"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x26db1d"
}

eth_getBlockTransactionCountByHash

Returns the number of transactions in a block specified by block hash.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 32 bytes): a block hash.

Returns

  • <string> (quantity): the number of transactions in this block.

Request example:

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getBlockTransactionCountByHash",
      "params": ["0x004e9007f85b0931df490262b1605837596c8e622e981282123eb949564f4a5e"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0xe"
}

eth_getBlockTransactionCountByNumber

Returns the number of transactions in the block specified by number.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:
      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (quantity): the number of transactions in this block.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getBlockTransactionCountByNumber",
      "params": ["0x847E17"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0xa"
}

eth_getUncleCountByBlockHash

Returns the number of uncles in a block specified by block hash.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 32 bytes): a block hash.

Returns

  • <string> (quantity): the number of uncles in this block.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getUncleCountByBlockHash",
      "params": ["0x2e0fde25135f358272f79f9c370b8934b4524e87bd8e04aad8a42d4fc4003c2c"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

eth_getUncleCountByBlockNumber

Returns the number of uncles in a block specified by block number.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:
      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (quantity): the number of uncles in this block.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getUncleCountByBlockNumber",
      "params": ["0x847E12"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

eth_getCode

Returns code at a given address.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 20 bytes): an address to get the code from.
    2. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:
      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (data): the code from the given address.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getCode",
      "params": ["0x2a6b5109F48A5d50D82f618500237a70608fc9b2", "latest"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x"
}

eth_sendRawTransaction

Creates new message call transaction or a contract creation for signed transactions.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data): the signed transaction data.

Returns

  • <string> (data, 32 bytes): the transaction hash, or the zero hash if the transaction is not yet available.

Use eth_getTransactionReceipt to get the contract address, after the transaction was mined, when you created a contract.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransaction",
    "params": ["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"],
    "id": 1
}'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

Executes a new message call immediately without creating a transaction on the blockchain.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <object> (hex encoded): the transaction object:

      • from (string; data, 20 bytes; optional): the address the transaction is sent from.
      • to (string; data, 20 bytes): the address the transaction is directed to.
      • gas (string; quantity; optional): the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
      • gasPrice (string; quantity; optional): the gas price willing to be paid by the sender in wei.
      • value (string; quantity; optional): the value sent with this transaction, in wei.
      • data (string; data; optional): the hash of the method signature and encoded parameters.
    2. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:

      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (hex encoded bytes): the return value of executed contract.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{"from":null,"to":"0xE0c865f883cbF9A2be65fFa03B7330013faD9BFe","data":"0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"}, "latest"],
    "id": 1
}'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x"
}

eth_estimateGas

Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.

The transaction will not be added to the blockchain. Note that the estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <object> (hex encoded): the transaction object:

      • from (string; data, 20 bytes; optional): the address the transaction is sent from.
      • to (string; data, 20 bytes; optional): the address the transaction is directed to.
      • gas (string; quantity; optional): the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
      • gasPrice (string; quantity; optional): the gas price willing to be paid by the sender in wei.
      • value (string; quantity; optional): the value sent with this transaction, in wei.
      • data (string; data; optional): the hash of the method signature and encoded parameters.
    2. <string> (quantity|tag; optional): either a HEX value of a block number or one of the following block tags:

      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.

Returns

  • <string> (quantity): the amount of gas used.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
    "jsonrpc": "2.0",
    "method": "eth_estimateGas",
    "params": [{"to":"0xE0c865f883cbF9A2be65fFa03B7330013faD9BFe"}],
    "id": 1
}'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x5208"
}

eth_getBlockByHash

Returns information for the block specified by block hash.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 32 bytes): the block hash.
    2. <boolean>: if true it returns the full transaction objects, if false — only the hashes of the transactions.

Returns

  • <object>: a block object, or null when no block was found:
    • number (string; quantity): the block number; null when it's a pending block.
    • hash (string; data, 32 bytes): the hash of the block; null when it's a pending block.
    • parentHash (string; data, 32 bytes): the hash of the parent block.
    • nonce (string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.
    • sha3Uncles (string; data, 32 bytes): SHA3 of the uncles data in the block.
    • logsBloom (string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.
    • transactionsRoot (string; data, 32 bytes): the root of the transaction trie of the block.
    • stateRoot (string; data, 32 bytes): the root of the final state trie of the block.
    • receiptsRoot (string; data, 32 bytes): the root of the receipts trie of the block.
    • miner (string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.
    • difficulty (string; quantity): the difficulty for this block.
    • totalDifficulty (string; quantity): the total difficulty of the chain until this block.
    • extraData (string; data): the extra data field of this block.
    • size (string; quantity): the size of this block in bytes.
    • gasLimit (string; quantity): the maximum gas allowed in this block.
    • gasUsed (string; quantity): the total used gas by all transactions in this block.
    • timestamp (string; quantity): the unix timestamp for when the block was collated.
    • transactions (array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.
    • uncles (array of strings): an array of uncle hashes.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getBlockByHash",
      "params": ["0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982", false],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "difficulty": "0x0",
        "extraData": "0x",
        "gasLimit": "0x1312d00",
        "gasUsed": "0x2df97f",
        "hash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
        "logsBloom": "0x0000000000000008000000200000008040004210000000000000000300000000000400004000100000000000000000008000020200002000000002000000200000004000000080080000000c0000120000000000000a000010010000000200200500000000000200004400050002100000000800000800002000001000080000000008000000000500000000000400000080100000000000000000000000020101000000108008000400000005111000000a000002000001000022000000000080000002000110030000000000100001000000200000001000010080000200000000010000000000000000000000004848000040008000000000000100000000",
        "miner": "0x97eaafa954a6a848df656eebb24637921a2fe798",
        "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "nonce": "0x0000000000000000",
        "number": "0x847e9a",
        "parentHash": "0x7623510c31da52597f81b30cf8e3a0749b602c4864a0c97f1c76f01e7ac3e987",
        "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
        "size": "0x4fe3",
        "stateRoot": "0xb6fe6a8fce0b84d2626c8abcb10fb9a63ff854cc4295e413d96028dcb664bfa4",
        "timestamp": "0x65d61a21",
        "totalDifficulty": "0x0",
        "transactions": [
            "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
            "0x17828d77a6a9326a60ab7faf56b6ecc66f0cc9ce48c7543baab4f7141dfa6764",
            "0x79c18d30a4e3a408658938dc6a811f2cacaac3d8e2a5149ecb1f65a89c6ddfaa",
            "0xa50fa76c06a6c2700574d33987f9a6fd6bc06b9a042def2b60eccc9208b1a5bf",
            "0x0ac7d63724960562ceda4bf5a9ae993a9200c8603dcc13413079ac44a8ed074b",
            "0x2ebf3882bcefdc95062b6af242c29397f26d4dae412a6ba7d86efaaf308d4612",
            "0x4ad4332e4df2e152145d67ba5fc4effc0a20d387f4efb1cedfe00aa727734684",
            "0xfa00db04008f003927619ddfc32f8f6278a9da60fc7f8d163bfae1e15d5e0977"
        ],
        "transactionsRoot": "0xdb6581a769bf9079e51815bde8b23f2b9196c22795630c638a9446181951e769",
        "uncles": []
    }
}

eth_getBlockByNumber

Returns information for the block specified by block number.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:
      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
    2. <boolean>: if true it returns the full transaction objects, if false — only the hashes of the transactions.

Returns

  • <object>: a block object, or null when no block was found:
    • number (string; quantity): the block number; null when it's a pending block.
    • hash (string; data, 32 bytes): the hash of the block; null when it's a pending block.
    • parentHash (string; data, 32 bytes): the hash of the parent block.
    • nonce (string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.
    • sha3Uncles (string; data, 32 bytes): SHA3 of the uncles data in the block.
    • logsBloom (string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.
    • transactionsRoot (string; data, 32 bytes): the root of the transaction trie of the block.
    • stateRoot (string; data, 32 bytes): the root of the final state trie of the block.
    • receiptsRoot (string; data, 32 bytes): the root of the receipts trie of the block.
    • miner (string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.
    • difficulty (string; quantity): the difficulty for this block.
    • totalDifficulty (string; quantity): the total difficulty of the chain until this block.
    • extraData (string; data): the extra data field of this block.
    • size (string; quantity): the size of this block in bytes.
    • gasLimit (string; quantity): the maximum gas allowed in this block.
    • gasUsed (string; quantity): the total used gas by all transactions in this block.
    • timestamp (string; quantity): the unix timestamp for when the block was collated.
    • transactions (array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.
    • uncles (array of strings): an array of uncle hashes.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getBlockByNumber",
      "params": ["latest", false],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "difficulty": "0x0",
        "extraData": "0x",
        "gasLimit": "0x1312d00",
        "gasUsed": "0x7f36a",
        "hash": "0x95d062cb1fcf6e0a45057a7616ea08fa0c9d9f2e517d96139585af7dca1d8e00",
        "logsBloom": "0x00000000000000000000000000000000000002000000000000000000000000040000000001000000000000000000008000000000000000000000000000080000000000000800000000100000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000002000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000",
        "miner": "0x4a71c949f46694a7e306ee80d98451954f343d55",
        "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "nonce": "0x0000000000000000",
        "number": "0x847ed0",
        "parentHash": "0x126760ff1767c68c03d593d829fab7c4488659dac7a508f5c9a7c720bbd198ff",
        "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
        "size": "0x2fe6",
        "stateRoot": "0xa40bebeedfdbf3638ad7c9bfe00fe5c7c9b02d15a3da33ee090ffca870319933",
        "timestamp": "0x65d61b73",
        "totalDifficulty": "0x0",
        "transactions": [
            "0xbafa2fba29f6ad040ef2516db914d0f86c6d5a383fbad6ffa1b6263590a3dfa3"
        ],
        "transactionsRoot": "0x957d70dc0b699470a00a5cc1a7a92c0107bf91132fb92aecda98eda820d82742",
        "uncles": []
    }
}

eth_getTransactionByHash

Returns information on a transaction specified by transaction hash.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 32 bytes): a transaction hash.

Returns

  • blockHash (string; data, 32 bytes): a hash of the block containing the transaction; null when it's pending.
  • blockNumber (string; quantity): a number of the block containing the transaction; null when it's pending.
  • from (string; data, 20 bytes): an address of the sender.
  • gas (string; quantity): the gas provided by the sender.
  • gasPrice (string; quantity): the gas price provided by the sender in wei.
  • hash (string; data, 32 bytes): the hash of the transaction.
  • input (string; data): the data send along with the transaction.
  • nonce (string; quantity): the number of transactions made by the sender prior to this one.
  • to (string: data, 20 bytes): an address of the receiver: null when it's a contract creation transaction.
  • transactionIndex (string; quantity): the transaction index position in the block; null when it's pending.
  • value (string; quantity): the value transferred in wei.
  • v (string; quantity): ECDSA recovery ID.
  • r (string; quantity): ECDSA signature r.
  • s (string; quantity): ECDSA signature s.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByHash",
      "params": ["0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
        "blockNumber": "0x847e9a",
        "from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
        "gas": "0xaae60",
        "gasPrice": "0x3b9aca00",
        "hash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
        "input": "0x06c429e5000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca0000000000000000000000001a35ee4640b0a3b87705b0a4b45d227ba60ca2ad000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d00000000000000000000000000000000000000000000000000000000000001f400000000000000000000000000000000000000000000000000000000004c4b40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e",
        "nonce": "0x30721",
        "to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x8ae",
        "v": "0x117f",
        "r": "0x83f5313d2a434f05435a02000f310fa2690f8b936353e233935bfc7ad8a6091c",
        "s": "0x7b0a065c45e00b5280906c31d75309588d15cca0c9e124052119f2d43b809fbe"
    }
}

eth_getTransactionByBlockHashAndIndex

Returns information on a transaction specified by block hash and transaction index position.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 32 bytes): a block hash.
    2. <string> (quantity): a transaction index position.

Returns

  • blockHash (string; data, 32 bytes): a hash of the block containing the transaction; null when it's pending.
  • blockNumber (string; quantity): a number of the block containing the transaction; null when it's pending.
  • from (string; data, 20 bytes): an address of the sender.
  • gas (string; quantity): the gas provided by the sender.
  • gasPrice (string; quantity): the gas price provided by the sender in wei.
  • hash (string; data, 32 bytes): the hash of the transaction.
  • input (string; data): the data send along with the transaction.
  • nonce (string; quantity): the number of transactions made by the sender prior to this one.
  • to (string: data, 20 bytes): an address of the receiver: null when it's a contract creation transaction.
  • transactionIndex (string; quantity): the transaction index position in the block; null when it's pending.
  • value (string; quantity): the value transferred in wei.
  • v (string; quantity): ECDSA recovery ID.
  • r (string; quantity): ECDSA signature r.
  • s (string; quantity): ECDSA signature s.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByBlockHashAndIndex",
      "params": ["0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982", "0x0"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
        "blockNumber": "0x847e9a",
        "from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
        "gas": "0xaae60",
        "gasPrice": "0x3b9aca00",
        "hash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
        "input": "0x06c429e5000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca0000000000000000000000001a35ee4640b0a3b87705b0a4b45d227ba60ca2ad000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d00000000000000000000000000000000000000000000000000000000000001f400000000000000000000000000000000000000000000000000000000004c4b40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e",
        "nonce": "0x30721",
        "to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x8ae",
        "v": "0x117f",
        "r": "0x83f5313d2a434f05435a02000f310fa2690f8b936353e233935bfc7ad8a6091c",
        "s": "0x7b0a065c45e00b5280906c31d75309588d15cca0c9e124052119f2d43b809fbe"
    }
}

eth_getTransactionByBlockNumberAndIndex

Returns information on a transaction by block number and transaction index position.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (quantity|tag): either the hex value of a block number or one of the following block tags:
      • earliest: the lowest numbered block available on the client.
      • finalized: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.
      • safe: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.
      • latest: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.
      • pending: a sample next block built by the client on top of the latest and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
    2. <string> (quantity): the transaction index position.

Returns

  • blockHash (string; data, 32 bytes): a hash of the block containing the transaction; null when it's pending.
  • blockNumber (string; quantity): a number of the block containing the transaction; null when it's pending.
  • from (string; data, 20 bytes): an address of the sender.
  • gas (string; quantity): the gas provided by the sender.
  • gasPrice (string; quantity): the gas price provided by the sender in wei.
  • hash (string; data, 32 bytes): the hash of the transaction.
  • input (string; data): the data send along with the transaction.
  • nonce (string; quantity): the number of transactions made by the sender prior to this one.
  • to (string: data, 20 bytes): an address of the receiver: null when it's a contract creation transaction.
  • transactionIndex (string; quantity): the transaction index position in the block; null when it's pending.
  • value (string; quantity): the value transferred in wei.
  • v (string; quantity): ECDSA recovery ID.
  • r (string; quantity): ECDSA signature r.
  • s (string; quantity): ECDSA signature s.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByBlockNumberAndIndex",
      "params": ["0x847E9A", "0x0"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
        "blockNumber": "0x847e9a",
        "from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
        "gas": "0xaae60",
        "gasPrice": "0x3b9aca00",
        "hash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
        "input": "0x06c429e5000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca0000000000000000000000001a35ee4640b0a3b87705b0a4b45d227ba60ca2ad000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d00000000000000000000000000000000000000000000000000000000000001f400000000000000000000000000000000000000000000000000000000004c4b40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e",
        "nonce": "0x30721",
        "to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x8ae",
        "v": "0x117f",
        "r": "0x83f5313d2a434f05435a02000f310fa2690f8b936353e233935bfc7ad8a6091c",
        "s": "0x7b0a065c45e00b5280906c31d75309588d15cca0c9e124052119f2d43b809fbe"
    }
}

eth_getTransactionReceipt

Returns the receipt of a transaction by transaction hash.

The receipt is not available for pending transactions.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 32 bytes): a hash of the transaction.

Returns

  • object: a transaction receipt object, or null when no receipt was found:

    • transactionHash (string; data, 32 bytes): a hash of the transaction.

    • transactionIndex (string; quantity): the transactions index position in the block.

    • blockHash (string; data, 32 bytes): a hash of the block containing the transaction.

    • blockNumber (string; quantity): a number of the block containing the transaction.

    • from (string; data, 20 bytes): an address of the sender.

    • to (string; data, 20 bytes): an address of the receiver; null when it's a contract creation transaction.

    • cumulativeGasUsed (string; quantity): the total amount of gas used when this transaction was executed in the block.

    • effectiveGasPrice (string; quantity): the sum of the base fee and tip paid per unit of gas.

    • gasUsed (string; quantity): the amount of gas used by this specific transaction alone.

    • contractAddress (string; data, 20 bytes): the contract address created, if the transaction was a contract creation, otherwise null.

    • logs (array): an array of log objects, which this transaction generated.

    • logsBloom (string; data, 256 bytes): a bloom filter for light clients to quickly retrieve related logs.

    • type (string; data): the transaction type, 0x00 for legacy transactions, 0x01 for access list types, 0x02 for dynamic fees. It also returns either of the following:

      • root (string; data, 32 bytes): a post-transaction stateroot (pre Byzantium).
      • status (string; quantity): either 1 (success) or 0 (failure).

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getTransactionReceipt",
      "params": ["0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
        "blockNumber": "0x847e9a",
        "contractAddress": null,
        "cumulativeGasUsed": "0x55730",
        "from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
        "gasUsed": "0x55730",
        "logs": [
            {
                "address": "0x1a35ee4640b0a3b87705b0a4b45d227ba60ca2ad",
                "topics": [
                    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                    "0x000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca",
                    "0x0000000000000000000000001c253ea05445a44f3d1a273a11ed498825a58228"
                ],
                "data": "0x0000000000000000000000000000000000000000000000000000000000002609",
                "blockNumber": "0x847e9a",
                "transactionHash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
                "transactionIndex": "0x0",
                "blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
                "logIndex": "0x0",
                "removed": false
            }
        ],
        "logsBloom": "0x00000000000000000000000000000080400040100000000000000001000000000004000040001000000000000000000000000200000020000000000000000000000000000000800800000008000000000000000000080000000000000000002001000000000000000000000100021000000008000000000020000010000800000000080000000000000000000004000000001000000000000000000000000001000000000080080000000000041000000000000002000000000002000000000000000002000100020000000000000001000000200000000000000080000200000000010000000000000000000000000800000000000000000000000000000000",
        "status": "0x1",
        "to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
        "transactionHash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
        "transactionIndex": "0x0",
        "type": "0x0"
    }
}

eth_getUncleByBlockHashAndIndex

Returns information about an uncle of a block by hash and uncle index position.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (data, 32 bytes): the hash of a block.
    2. <string> (quantity): the uncle's index position.

Returns

  • <object>: a block object, or null when no block was found:
    • number (string; quantity): the block number; null when it's a pending block.
    • hash (string; data, 32 bytes): the hash of the block; null when it's a pending block.
    • parentHash (string; data, 32 bytes): the hash of the parent block.
    • nonce (string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.
    • sha3Uncles (string; data, 32 bytes): SHA3 of the uncles data in the block.
    • logsBloom (string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.
    • transactionsRoot (string; data, 32 bytes): the root of the transaction trie of the block.
    • stateRoot (string; data, 32 bytes): the root of the final state trie of the block.
    • receiptsRoot (string; data, 32 bytes): the root of the receipts trie of the block.
    • miner (string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.
    • difficulty (string; quantity): the difficulty for this block.
    • totalDifficulty (string; quantity): the total difficulty of the chain until this block.
    • extraData (string; data): the extra data field of this block.
    • size (string; quantity): the size of this block in bytes.
    • gasLimit (string; quantity): the maximum gas allowed in this block.
    • gasUsed (string; quantity): the total used gas by all transactions in this block.
    • timestamp (string; quantity): the unix timestamp for when the block was collated.
    • transactions (array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.
    • uncles (array of strings): an array of uncle hashes.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockHashAndIndex",
      "params": ["0x7eb6de38b5996d4d3568a84f6fb8e54069d23d36aa00c7dac3798e5deb164a23", "0x0"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "difficulty": "0x4ea3f27bc",
        "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
        "gasLimit": "0x1388",
        "gasUsed": "0x0",
        "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
        "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
        "nonce": "0x689056015818adbe",
        "number": "0x1b4",
        "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
        "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
        "size": "0x220",
        "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
        "timestamp": "0x55ba467c",
        "totalDifficulty": "0x78ed983323d",
        "transactions": [],
        "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "uncles": []
    }
}

eth_getUncleByBlockNumberAndIndex

Returns information about an uncle of a block by number and uncle index position.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. <string> (quantity|tag): the hex value of a block number.
    2. <string> (quantity): the uncle's index position.

Returns

  • <object>: a block object, or null when no block was found:
    • number (string; quantity): the block number; null when it's a pending block.
    • hash (string; data, 32 bytes): the hash of the block; null when it's a pending block.
    • parentHash (string; data, 32 bytes): the hash of the parent block.
    • nonce (string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.
    • sha3Uncles (string; data, 32 bytes): SHA3 of the uncles data in the block.
    • logsBloom (string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.
    • transactionsRoot (string; data, 32 bytes): the root of the transaction trie of the block.
    • stateRoot (string; data, 32 bytes): the root of the final state trie of the block.
    • receiptsRoot (string; data, 32 bytes): the root of the receipts trie of the block.
    • miner (string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.
    • difficulty (string; quantity): the difficulty for this block.
    • totalDifficulty (string; quantity): the total difficulty of the chain until this block.
    • extraData (string; data): the extra data field of this block.
    • size (string; quantity): the size of this block in bytes.
    • gasLimit (string; quantity): the maximum gas allowed in this block.
    • gasUsed (string; quantity): the total used gas by all transactions in this block.
    • timestamp (string; quantity): the unix timestamp for when the block was collated.
    • transactions (array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.
    • uncles (array of strings): an array of uncle hashes.

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockNumberAndIndex",
      "params": ["0x258C44", "0x0"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "difficulty": "0x57f117f5c",
        "extraData": "0x476574682f76312e302e302f77696e646f77732f676f312e342e32",
        "gasLimit": "0x1388",
        "gasUsed": "0x0",
        "hash": "0x932bdf904546a2287a2c9b2ede37925f698a7657484b172d4e5184f80bdd464d",
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "miner": "0x5bf5e9cf9b456d6591073513de7fd69a9bef04bc",
        "mixHash": "0x4500aa4ee2b3044a155252e35273770edeb2ab6f8cb19ca8e732771484462169",
        "nonce": "0x24732773618192ac",
        "number": "0x299",
        "parentHash": "0xa779859b1ee558258b7008bbabff272280136c5dd3eb3ea3bfa8f6ae03bf91e5",
        "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
        "size": "0x21d",
        "stateRoot": "0x2604fbf5183f5360da249b51f1b9f1e0f315d2ff3ffa1a4143ff221ad9ca1fec",
        "timestamp": "0x55ba4827",
        "totalDifficulty": "0xc46826a2c6a",
        "transactions": [],
        "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "uncles": []
    }
}

eth_getLogs

Returns an array of all logs matching a given filter object.

Parameters

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    1. object: the filter options:

      • fromBlock (string; quantity|tag; optional; default: "latest"): either the block number or one of the following block tags:

        • latest: for the last mined block.
        • earliest: for the lowest numbered block available on the client.
        • pending: for not yet mined transactions.
      • toBlock (string; quantity|tag; optional; default: "latest"): either the block number or one of the following block tags:

        • latest: for the last mined block.
        • earliest: for the lowest numbered block available on the client.
        • pending: for not yet mined transactions.
      • address (array of strings; data, 20 bytes; optional): a contract address or a list of addresses from which logs should originate.

      • topics (array of strings; data; optional): an array of 32 bytes data topics. Topics are order-dependent. Each topic can also be an array of data with "or" options.

      • blockhash (string; data, 32 bytes; optional; future): with the addition of EIP-234, blockHash will be a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash. Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock are allowed.

Returns

  • removed (string; tag): true when the log was removed, due to a chain reorganization; false if it's a valid log.
  • logIndex (string; quantity): the log index position in the block; null when it's a pending log.
  • transactionIndex (string; quantity): the transactions index position log was created from; null when it's a pending log.
  • transactionHash (string; data, 32 bytes): a hash of the transactions this log was created from; null when it's a pending log.
  • blockHash (string; data, 32 bytes): a hash of the block containing the log; null when it's pending; null when it's a pending log.
  • blockNumber (string; quantity): the number of the block containing the log; null when it's pending; null when it's a pending log.
  • address (string; data, 20 bytes): an address from which this log originated.
  • data (string; data): contains one or more 32 bytes non-indexed arguments of the log.
  • topics (array of strings; data): an array of 0 to 4 32 bytes data of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier.)

Request example

curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getLogs",
      "params": [{"address": "0x2BCfE12a949267e3Da5874E44554b29FA4B753E6"}],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
        {
            "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "topics": [
                "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "0x0000000000000000000000009acbb72cf67103a30333a32cd203459c6a9c3311",
                "0x000000000000000000000000994871e1103c5da4be270365fa62771ea4525520"
            ],
            "data": "0x000000000000000000000000000000000000000000000000000000001ec39aa0",
            "blockNumber": "0xf6289d",
            "transactionHash": "0xc7ed73c9b219d4243872e5993ad2950c8ea87d15af28562d33b0c05d46a90cee",
            "transactionIndex": "0x1e",
            "blockHash": "0x1e12377f0357320c0e5cfcadc2dfbc9c75fc339be668e118c34e4333f835ef31",
            "logIndex": "0x13",
            "removed": false
        },
        {
            "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "topics": [
                "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "0x0000000000000000000000005879975799597392c031f10b6eff282cb7974ac8",
                "0x0000000000000000000000006d52ab66340f3f78d0c1007bec484268876b5948"
            ],
            "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "blockNumber": "0xf6289d",
            "transactionHash": "0x0118499f7be4c3510bd60fe3a3aee5f5f316743b6cc13a8cb0528d784f962aec",
            "transactionIndex": "0x20",
            "blockHash": "0x1e12377f0357320c0e5cfcadc2dfbc9c75fc339be668e118c34e4333f835ef31",
            "logIndex": "0x14",
            "removed": false
        }
    ]
}

Tendermint JSON-RPC/REST methods

Info — node information:

Tx — transactions broadcast information:

  • broadcast_tx_sync — returns with the response from CheckTx. Does not wait for DeliverTx result.
  • broadcast_tx_async — returns right away, with no response. Does not wait for CheckTx nor DeliverTx results.
  • broadcast_tx_commit — returns with the responses from CheckTx and DeliverTx.
  • check_tx — checks the transaction without executing it.

ABCI — ABCI info:

  • abci_info — retrieves info about the application.
  • abci_query — queries the application for some information.

Information

blockchain

Retrieves block headers for minHeight <= height <= maxHeight.

At most 20 items will return for the minHeight or maxHeight parameters specified. If maxHeight does not yet exist, the blocks up to the current height will return. If minHeight does not exist (pruning), the earliest existing height will be used.

Parameters


  • minHeight (integer): the minimum block height to return.
  • maxHeight (integer): the maximum block height to return.

Returns

Block headers, in descending order (highest first).

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "blockchain",
      "params": ["1", "2"],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "last_height": "13211309",
        "block_metas": [
            {
                "block_id": {
                    "hash": "606AA3A0B325273C27FCD254D528DCCB968351ECF4C045920517A5269D76DB4E",
                    "parts": {
                        "total": 1,
                        "hash": "8B827E255B0EFF6D3D66315F9460D180D7A1988A5281DE11699CE204A0308E79"
                    }
                },
                "block_size": "6590",
                "header": {
                    "version": {
                        "block": "11"
                    },
                    "chain_id": "kava_2222-10",
                    "height": "2",
                    "time": "2022-05-25T18:39:32.196946927Z",
                    "last_block_id": {
                        "hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
                        "parts": {
                            "total": 1,
                            "hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
                        }
                    },
                    "last_commit_hash": "093DC4B1414DE776AAC2388AAD616FCAC5E783930420710395732259CA023DB8",
                    "data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                    "next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                    "consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
                    "app_hash": "4107A4EABA68DEF282B97D5071440DFB121307B524B0E2B64D7F348CB57E74A9",
                    "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "proposer_address": "330871F4F79EF8572E4AB3A64A45AF0C88AFC24E"
                },
                "num_txs": "0"
            },
            {
                "block_id": {
                    "hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
                    "parts": {
                        "total": 1,
                        "hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
                    }
                },
                "block_size": "339",
                "header": {
                    "version": {
                        "block": "11"
                    },
                    "chain_id": "kava_2222-10",
                    "height": "1",
                    "time": "2022-05-25T17:00:00Z",
                    "last_block_id": {
                        "hash": "",
                        "parts": {
                            "total": 0,
                            "hash": ""
                        }
                    },
                    "last_commit_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                    "next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                    "consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
                    "app_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                    "proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
                },
                "num_txs": "0"
            }
        ]
    }
}

block

Retrieves a block at a specified height.

Parameters


  • height (integer; default: 0): the height to return. If no height is provided, the latest block is to be fetched.

Returns

Block information.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block",
      "params": ["1"],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "block_id": {
            "hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
            "parts": {
                "total": 1,
                "hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
            }
        },
        "block": {
            "header": {
                "version": {
                    "block": "11"
                },
                "chain_id": "kava_2222-10",
                "height": "1",
                "time": "2022-05-25T17:00:00Z",
                "last_block_id": {
                    "hash": "",
                    "parts": {
                        "total": 0,
                        "hash": ""
                    }
                },
                "last_commit_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                "next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                "consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
                "app_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
            },
            "data": {
                "txs": []
            },
            "evidence": {
                "evidence": []
            },
            "last_commit": {
                "height": "0",
                "round": 0,
                "block_id": {
                    "hash": "",
                    "parts": {
                        "total": 0,
                        "hash": ""
                    }
                },
                "signatures": []
            }
        }
    }
}

block_by_hash

Retrieves a block by hash.

Parameters


  • hash (string; required): the Base64-encoded block hash.

Returns

Block information.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block_by_hash",
      "params": ["CZDLbPv0DScQ6hUoCceUnqdDEnaoPrG8RoNcoTekAKg="],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": -1,
    "result": {
        "block_id": {
            "hash": "0990CB6CFBF40D2710EA152809C7949EA7431276A83EB1BC46835CA137A400A8",
            "parts": {
                "total": 1,
                "hash": "BDB709FCE6291C69976F6AA6BADFAB768CCF7347CCE381D2DBE581AB1AFF1147"
            }
        },
        "block": {
            "header": {
                "version": {
                    "block": "11"
                },
                "chain_id": "kava_2222-10",
                "height": "13211369",
                "time": "2024-12-23T13:06:40.249128874Z",
                "last_block_id": {
                    "hash": "11E9C2ED7F9E6F494030DD8E6BA2887193FDBE4DCEF694193470780C56838A09",
                    "parts": {
                        "total": 1,
                        "hash": "FE6664A16EA56C07254298EE325FEC08A60473A76200E959C51CABA007FCC423"
                    }
                },
                "last_commit_hash": "2612A440646D3101752779E27EFE43EE17363A9B7DCBCFF2C13FD1C211E396AB",
                "data_hash": "B9B7F0546E07BB0F1E6837CEDC92C461A545A8E208D4F584A17B5471129DFB2E",
                "validators_hash": "98F5D4584BB1DF0122CC6CF68BC8772EE951737F0129502282B972F2CF7F7D89",
                "next_validators_hash": "98F5D4584BB1DF0122CC6CF68BC8772EE951737F0129502282B972F2CF7F7D89",
                "consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
                "app_hash": "883C909F30202624527F54653CB35A0A957EA6111ED9436F21F00E9271EB4599",
                "last_results_hash": "9EABEC2AD9A87ADAE8B4344675DCC4EECC8251B1FDFC5388A2469D30D1904AE3",
                "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
            },
            "data": {
                "txs": [
                    "CrALCvwKCh8vZXRoZXJtaW50LmV2bS52MS5Nc2dFdGhlcmV1bVR4EtgKCpEKChovZXRoZXJtaW50LmV2bS52MS5MZWdhY3lUeBLyCQiQiiISCjEwMDAwMDAwMDAY8MghIioweGJENTI5MzBBZjVmMzllMkE3QmIyMUY5YjEwZGQzOTEyNGVjOEZmYmEqATAy5Ai+doO2AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE9DUv06pMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAmJWcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAeAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAADIbHwO+9akmzXocUxfWdmd4JoiWwAAAAAAAAAAAAAAAJGcHCZ7wGpwOeA..."
                ]
            },
            "evidence": {
                "evidence": []
            },
            "last_commit": {
                "height": "13211368",
                "round": 0,
                "block_id": {
                    "hash": "11E9C2ED7F9E6F494030DD8E6BA2887193FDBE4DCEF694193470780C56838A09",
                    "parts": {
                        "total": 1,
                        "hash": "FE6664A16EA56C07254298EE325FEC08A60473A76200E959C51CABA007FCC423"
                    }
                },
                "signatures": [
                    {
                        "block_id_flag": 2,
                        "validator_address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
                        "timestamp": "2024-12-23T13:06:40.249128874Z",
                        "signature": "CwycpLoHveYoT/euba+mH8nfUFWvUimMqPM98IFLZPGGIqJzirAndVRhZ8YqNeBU3QaXQnpGRq5lkbh6qnTeAQ=="
                    },
                    {
                        "block_id_flag": 2,
                        "validator_address": "BC3E38E217AC3B03E61752C5C2F918FA6539166F",
                        "timestamp": "2024-12-23T13:06:40.318172526Z",
                        "signature": "AeGOEuMuAaJ8zB/DJYU8bJ75OL+FAQSfzUX1FnNiKgQ4ykulN+HppLM3rcJ1uXj+pc8pbN5V5db5SKzUJCsDCQ=="
                    }
                ]
            }
        }
    }
}

block_results

Retrieves block results at a specified height.

Parameters


  • height (integer; default: 0): the height to return. If no height is provided, the latest block info is to be fetched.

Returns

Block results.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "block_results",
      "params": ["1"],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "height": "1",
        "txs_results": null,
        "begin_block_events": [
            {
                "type": "coin_received",
                "attributes": [
                    {
                        "key": "receiver",
                        "value": "kava1m3h30wlvsf8llruxtpukdvsy0km2kum85yn938",
                        "index": true
                    },
                    {
                        "key": "amount",
                        "value": "38487598ukava",
                        "index": true
                    }
                ]
            },
            {
                "type": "block_gas",
                "attributes": [
                    {
                        "key": "height",
                        "value": "1",
                        "index": true
                    },
                    {
                        "key": "amount",
                        "value": "0",
                        "index": true
                    }
                ]
            }
        ],
        "validator_updates": null,
        "consensus_param_updates": {
            "block": {
                "max_bytes": "200000",
                "max_gas": "20000000"
            },
            "evidence": {
                "max_age_num_blocks": "1000000",
                "max_age_duration": "6000000000000000",
                "max_bytes": "50000"
            },
            "validator": {
                "pub_key_types": [
                    "ed25519"
                ]
            }
        }
    }
}

commit

Retrieves commit results at a specified height.

Parameters


  • height (integer; default: 0): the height to return. If no height is provided, the latest block commit info is to be fetched.

Returns

Commit results. Canonical switches from false to true for block H once block H+1 has been committed, until then it's subjective and only reflects what this node has seen so far.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "commit",
      "params": ["1"],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "signed_header": {
            "header": {
                "version": {
                    "block": "11"
                },
                "chain_id": "kava_2222-10",
                "height": "1",
                "time": "2022-05-25T17:00:00Z",
                "last_block_id": {
                    "hash": "",
                    "parts": {
                        "total": 0,
                        "hash": ""
                    }
                },
                "last_commit_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                "next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
                "consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
                "app_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                "proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
            },
            "commit": {
                "height": "1",
                "round": 1,
                "block_id": {
                    "hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
                    "parts": {
                        "total": 1,
                        "hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
                    }
                },
                "signatures": [
                    {
                        "block_id_flag": 2,
                        "validator_address": "BD417EAD7FF9AC70A11A01F63FB40BBDEB0F1FD4",
                        "timestamp": "2022-05-25T18:39:32.196946927Z",
                        "signature": "6qT1+sJhXk3SmspA9v7FZUqyBegmM0w2LRRNx6NgO045cPmHhhHNl9gNAT4OaU1ISwPXVdaIret3VrPuJtA0AA=="
                    },
                    {
                        "block_id_flag": 2,
                        "validator_address": "BFA6235D95564560A73460860B8D6F847360A31B",
                        "timestamp": "2022-05-25T18:39:32.085034348Z",
                        "signature": "sid5vAgVD5WHlrCTmwBYZBVHvoS1zDft4LPDpDs4vQg6HQfUQ2Pn8d8VaCYNSwSxbfQ2eu1OoJwjPgMwlwDzDQ=="
                    }
                ]
            }
        },
        "canonical": true
    }
}

validators

Retrieves a validator set at a specified height.

Validators are sorted by voting power.

Parameters


  • height (integer; default: 0): the height to return. If no height is provided, the validator set corresponding to the latest block is to be fetched.
  • page (integer; default: 1): a page number (1-based).
  • per_page (integer; default: 30; max: 100): a number of entries per page.

Returns

Commit results.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "validators",
      "params": ["1","1","30"],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "block_height": "1",
        "validators": [
            {
                "address": "BD417EAD7FF9AC70A11A01F63FB40BBDEB0F1FD4",
                "pub_key": {
                    "type": "tendermint/PubKeyEd25519",
                    "value": "sIKgJJY8szFPMmKA0GehzQvKwDNe7KECDE8O+XqPuwU="
                },
                "voting_power": "29204205",
                "proposer_priority": "-82888553"
            }
        ],
        "count": "30",
        "total": "100"
    }
}

genesis_chunked

Retrieves Genesis in multiple chunks.

Gets genesis document in multiple chunks to make it easier to iterate through larger genesis structures. Each chunk is produced by converting the genesis document to JSON and then splitting the resulting payload into 16MB blocks, and then Base64-encoding each block.

Parameters


  • chunk (integer; default: 0): a sequence number of the chunk to download.

Returns

A Genesis chunk response.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "genesis_chunked",
      "params": ["1"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "chunk": 0,
    "total": 1,
    "data": "Z2VuZXNpcwo=..."
  }
}

dump_consensus_state

Retrieves consensus state.

Not safe to call from inside the ABCI application during a block execution.

Parameters


None.

Returns

A complete consensus state. See the Vote string description (opens in a new tab).

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "dump_consensus_state",
      "params": [],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "round_state": {
            "height": "13211550",
            "round": 0,
            "step": 1,
            "start_time": "2024-12-23T13:24:44.738595111Z",
            "commit_time": "2024-12-23T13:24:39.738595111Z",
            "validators": {
                "validators": [
                    {
                        "address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
                        "pub_key": {
                            "type": "tendermint/PubKeyEd25519",
                            "value": "GFeC1pZ7fslcucbIsx44x9c0MPeJlLRb+WGG/wGflbw="
                        },
                        "voting_power": "21656144",
                        "proposer_priority": "-52387076"
                    }
                ],
                "proposer": {
                    "address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
                    "pub_key": {
                        "type": "tendermint/PubKeyEd25519",
                        "value": "GFeC1pZ7fslcucbIsx44x9c0MPeJlLRb+WGG/wGflbw="
                    },
                    "voting_power": "21656144",
                    "proposer_priority": "-52387076"
                }
            },
            "proposal": null,
            "proposal_block": null,
            "proposal_block_parts": null,
            "locked_round": -1,
            "locked_block": null,
            "locked_block_parts": null,
            "valid_round": -1,
            "valid_block": null,
            "valid_block_parts": null,
            "votes": [
                {
                    "round": 0,
                    "prevotes": [
                        "nil-Vote",
                        "nil-Vote"
                    ],
                    "prevotes_bit_array": "BA{88:________________________________________________________________________________________} 0/117388861 = 0.00",
                    "precommits": [
                        "nil-Vote",
                        "nil-Vote"
                    ],
                    "precommits_bit_array": "BA{88:________________________________________________________________________________________} 0/117388861 = 0.00"
                }
            ],
            "commit_round": -1,
            "last_commit": {
                "votes": [
                    "Vote{0:279EAD5DD43F 13211549/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 2F31A8E1F581 8B6CEAA65010 @ 2024-12-23T13:24:39.500074271Z}",
                    "Vote{1:BD417EAD7FF9 13211549/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 2F31A8E1F581 31E4D1FFA299 @ 2024-12-23T13:24:39.553047425Z}"
                ],
                "votes_bit_array": "BA{88:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} 117388861/117388861 = 1.00",
                "peer_maj_23s": {}
            },
            "last_validators": {
                "validators": [
                    {
                        "address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
                        "pub_key": {
                            "type": "tendermint/PubKeyEd25519",
                            "value": "GFeC1pZ7fslcucbIsx44x9c0MPeJlLRb+WGG/wGflbw="
                        },
                        "voting_power": "21656144",
                        "proposer_priority": "43345641"
                    }
                ],
                "proposer": {
                    "address": "5AA4440350230D5BB8CDFE6A5726656B4FC7DC6E",
                    "pub_key": {
                        "type": "tendermint/PubKeyEd25519",
                        "value": "BM16Wru6ELaZXCyKZAH5WGxg5YiMYw2WlcpBnfdbnQg="
                    },
                    "voting_power": "162210",
                    "proposer_priority": "-63939004"
                }
            },
            "triggered_timeout_precommit": false
        },
        "peers": [
            {
                "node_address": "f8d5e677f1f68f8bd798752595371817f61dc532@178.128.156.131:26656",
                "peer_state": {
                    "round_state": {
                        "height": "13211550",
                        "round": 0,
                        "step": 1,
                        "start_time": "2024-12-23T13:24:43.982077345Z",
                        "proposal": false,
                        "proposal_block_part_set_header": {
                            "total": 0,
                            "hash": ""
                        },
                        "proposal_block_parts": null,
                        "proposal_pol_round": -1,
                        "proposal_pol": "________________________________________________________________________________________",
                        "prevotes": "________________________________________________________________________________________",
                        "precommits": "________________________________________________________________________________________",
                        "last_commit_round": 0,
                        "last_commit": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                        "catchup_commit_round": -1,
                        "catchup_commit": "________________________________________________________________________________________"
                    },
                    "stats": {
                        "votes": "14173",
                        "block_parts": "45"
                    }
                }
            }
        ]
    }
}

consensus_state

Retrieves consensus state.

Not safe to call from inside the ABCI application during a block execution.

Parameters


None.

Returns

Consensus state results.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "consensus_state",
      "params": [],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "round_state": {
            "height/round/step": "13213043/0/6",
            "start_time": "2024-12-23T15:53:01.989949876Z",
            "proposal_block_hash": "78CB001605FE99454B82944CB47D65D093629DDD38454260E7B7980874A6A5D7",
            "locked_block_hash": "78CB001605FE99454B82944CB47D65D093629DDD38454260E7B7980874A6A5D7",
            "valid_block_hash": "78CB001605FE99454B82944CB47D65D093629DDD38454260E7B7980874A6A5D7",
            "height_vote_set": [
                {
                    "round": 0,
                    "prevotes": [
                        "Vote{0:279EAD5DD43F 13213043/00/SIGNED_MSG_TYPE_PREVOTE(Prevote) 78CB001605FE 619E4C697B2C @ 2024-12-23T15:53:02.160332603Z}",
                        "Vote{1:BD417EAD7FF9 13213043/00/SIGNED_MSG_TYPE_PREVOTE(Prevote) 78CB001605FE 82F0E2036082 @ 2024-12-23T15:53:02.374084828Z}"
                    ],
                    "prevotes_bit_array": "BA{88:xxxxxxxxxx__xxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxxx_xxxxxxxxxxxxxxx} 110520639/117416870 = 0.94",
                    "precommits": [
                        "Vote{0:279EAD5DD43F 13213043/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 78CB001605FE 92F18B4F01EA @ 2024-12-23T15:53:02.551832113Z}",
                        "nil-Vote",
                        "Vote{2:BFA6235D9556 13213043/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 78CB001605FE 0FB040BC54A6 @ 2024-12-23T15:53:02.563127503Z}",
                        "nil-Vote"
                    ],
                    "precommits_bit_array": "BA{88:x_x_x________x_x__x_xx____x__xxxx___x_xx_xx_xxx_xxx__x___xxx__xx_xxx__x___x___xx___xxxx_} 52462972/117416870 = 0.45"
                },
                {
                    "round": 1,
                    "prevotes": [
                        "nil-Vote",
                        "nil-Vote"
                    ],
                    "prevotes_bit_array": "BA{88:________________________________________________________________________________________} 0/117416870 = 0.00",
                    "precommits": [
                        "nil-Vote",
                        "nil-Vote"
                    ],
                    "precommits_bit_array": "BA{88:________________________________________________________________________________________} 0/117416870 = 0.00"
                }
            ],
            "proposer": {
                "address": "026D3C349592A1A1D6534744106D7B0453E3C565",
                "index": 29
            }
        }
    }
}

consensus_params

Retrieves consensus parameters.

Parameters


  • height (integer; default: 0): the height to return. If no height is provided, the latest block commit info is to be returned.

Returns

Consensus parameters results.

Request parameters

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "consensus_params",
      "params": ["1"],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "block_height": "1",
        "consensus_params": {
            "block": {
                "max_bytes": "200000",
                "max_gas": "20000000"
            },
            "evidence": {
                "max_age_num_blocks": "1000000",
                "max_age_duration": "6000000000000000",
                "max_bytes": "50000"
            },
            "validator": {
                "pub_key_types": [
                    "ed25519"
                ]
            },
            "version": {
                "app": "0"
            }
        }
    }
}

unconfirmed_txs

Retrieves the list of unconfirmed transactions.

Parameters


  • limit (integer; default: 30; max: 100): the maximum number of unconfirmed transactions to return.

Returns

The list of unconfirmed transactions.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "unconfirmed_txs",
      "params": ["1"],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "n_txs": "2",
        "total": "4",
        "total_bytes": "2012",
        "txs": [
            "CoYBCoMBCiQva2F2YS5wcmljZWZlZWQudjFiZXRhMS5Nc2dQb3N0UHJpY2USWwora2F2YTE5cmprNXFtbXd5d256ZmNjd3p5bjAyanl3Z3B3anFmNjBhZmo5MhILdXNkeDp1c2Q6MzAaEjcxODkzMDAwMDAwMDAwMDA2OSILCPHVsLsGEMCO5TcSagpSCkYKHy9jb3Ntb3MuY3J5cHRvLnNlY3AyNTZrMS5QdWJLZXkSIwohA31VSgUTeXh1kcCYwNrx04+4ItSC8M6wuKV96JLq9G0pEgQKAggBGJHBFxIUCg4KBXVrYXZhEgU1MDAwMBDwkwkaQKvIEvEmlpm5Xuw9on+NLx53kPmvw3QI2Fic1/IDowITWeN8bbGHdomSC1cdnrtZ8rxaBUnfpLM7Yisnk4cqcl4=",
            "CoQBCoEBCiQva2F2YS5wcmljZWZlZWQudjFiZXRhMS5Nc2dQb3N0UHJpY2USWQora2F2YTF1ZWFrN256ZXNtM3BuZXY2bG5ncDZsZ2swcnkwMmRqejhwanBjZxIIdXNkeDp1c2QaEjczMzg5OTk5OTk5OTk5OTk5NyIMCLSAp7sGEMCR+NQCEmkKUgpGCh8vY29zbW9zLmNyeXB0by5zZWNwMjU2azEuUHViS2V5EiMKIQJh+Rd6tFqIDMHzDY2LUqIfd6iQjaxEk7kCf/PggVVILxIECgIIARj78XASEwoNCgV1a2F2YRIENTAwMBDwkwkaQNH1d9rV6P0l8EktESQ6pSg1htx5I8FNNit3kfg/bOXqJ0c5PxTgBfeitv167yLxWxyXBWaJueQGMVh8KOHi1W0="
        ]
    }
}

num_unconfirmed_txs

Retrieves data on unconfirmed transactions.

Parameters


None.

Returns

The status of unconfirmed transactions.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "num_unconfirmed_txs",
      "params": [],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "n_txs": "0",
        "total": "0",
        "total_bytes": "0",
        "txs": null
    }
}

tx_search

Searches for transactions with their results.

Parameters


  • query (string; required): query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r()"'=>< are not allowed). operation can be =, <, <=, >, >=, CONTAINS. An operand can be a string (escaped with single quotes), number, date, or time.
  • prove (boolean; default: false): adds proofs of the transactions inclusion in the block.
  • page (integer; default: 1): a page number (1-based).
  • per_page (integer; default: 30, max: 100): a number of entries per page.
  • order_by (string; default: asc): the order in which transactions are sorted (asc or desc), by height & index. If empty, default sorting still applies.
  • match_events (boolean; default: false): match attributes in query within events, in addition to the height and txhash.

Returns

The list of unconfirmed transactions.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
    "jsonrpc": "2.0",
    "method": "tx_search",
    "params": {
        "query": "tx.height=13225811",
        "prove": true,
        "page": "1",
        "per_page": "5",
        "order_by": "desc"
    },
    "id": 1
}'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "txs": [],
        "total_count": "0"
    }
}

block_search

Searches for blocks by BeginBlock and EndBlock events.

Parameters


  • query (string; required): query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r()"'=>< are not allowed). operation can be =, <, <=, >, >=, CONTAINS. An operand can be a string (escaped with single quotes), number, date, or time.
  • page (integer; default: 1): a page number (1-based).
  • per_page (integer; default: 30, max: 100): a number of entries per page.
  • order_by (string; default: asc): the order in which transactions are sorted (asc or desc), by height & index. If empty, default sorting still applies.
  • match_events (boolean; default: false): match attributes in query within events, in addition to the height.

Returns

The list of paginated blocks matching the search criteria.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
    "jsonrpc": "2.0",
    "method": "block_search",
    "params": {
        "query": "block.height=13225811",
        "page": "1",
        "per_page": "10",
        "order_by": "desc"
    },
    "id": 1
}'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "blocks": [
            {
                "block_id": {
                    "hash": "F054E236608C0E65DFE9231F9332D7F54F1A282D4C2C3DA6B35FAED5D4EE9169",
                    "parts": {
                        "total": 1,
                        "hash": "4F02FC67A8503D1D5428EE6D1209FC5BC1BB67382DBDB53F38C3FD0783B2FC8A"
                    }
                },
                "block": {
                    "header": {
                        "version": {
                            "block": "11"
                        },
                        "chain_id": "kava_2222-10",
                        "height": "13225811",
                        "time": "2024-12-24T12:58:00.512093988Z",
                        "last_block_id": {
                            "hash": "304F208093FA799825FA221EB9B517B73A0879E6D9B971DD28FDF96F564EEC7C",
                            "parts": {
                                "total": 1,
                                "hash": "4158FCF92A13A2A5F8D466BD0189EB466DDD5D1FCA7ACF0E40069A8A0B775792"
                            }
                        },
                        "last_commit_hash": "CCFD88F120E554844A8DED71E1DAF3FA8089B1D7CFDC276917C8A5E34FDE6DBD",
                        "data_hash": "2E1EC915F83863741270A49157E2787F5F34F3B0E2E67BB1527368F8BA05D1CD",
                        "validators_hash": "7C3AABDFAA6A53BF1C63DC025201337CA9CB3F7DE8A51EA0C54B2CEBDCEF6E39",
                        "next_validators_hash": "7C3AABDFAA6A53BF1C63DC025201337CA9CB3F7DE8A51EA0C54B2CEBDCEF6E39",
                        "consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
                        "app_hash": "2AA5FE48061351DF5DD4F79C25A902466C31975199BEE286FE294273DB4FBF4A",
                        "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                        "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
                        "proposer_address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07"
                    },
                    "data": {
                        "txs": [
                            "CrIHCv4GCh8vZXRoZXJtaW50LmV2bS52MS5Nc2dFdGhlcmV1bVR4EtoGCpMGChovZXRoZXJtaW50LmV2bS52MS5MZWdhY3lUeBL0BQiXvhMSDDEwMTAwMDAwMDAwMBjJ9hgiKjB4ODE1ZjI3QTU2MTcxMUE2QjA0YmNFM0FhNjVjNUQ5QTE5NDVBNWVFQioBMDLkBHgmYbwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGdqr9oAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA..."
                        ]
                    },
                    "evidence": {
                        "evidence": []
                    },
                    "last_commit": {
                        "height": "13225810",
                        "round": 0,
                        "block_id": {
                            "hash": "304F208093FA799825FA221EB9B517B73A0879E6D9B971DD28FDF96F564EEC7C",
                            "parts": {
                                "total": 1,
                                "hash": "4158FCF92A13A2A5F8D466BD0189EB466DDD5D1FCA7ACF0E40069A8A0B775792"
                            }
                        },
                        "signatures": [
                            {
                                "block_id_flag": 2,
                                "validator_address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
                                "timestamp": "2024-12-24T12:58:00.458392974Z",
                                "signature": "LU+rS0/HPXczwL9jxzAWYHSck0ORgzD9MGLXx6POcKO2XpNnHRG8/QsxDSs4Ouy3hO9AAiG0RNUWBrVlgjlpBg=="
                            }
                        ]
                    }
                }
            }
        ],
        "total_count": "1"
    }
}

tx

Retrieves a transaction by hash.

Parameters


  • hash (string; required): a hash of a transaction to retrieve.
  • prove (boolean; default: false): adds proofs of the transaction's inclusion in the block.

Returns

Transaction info.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "tx",
      "params": ["4B6D8FEA3786BFC6152EAEA791C4DAF00C41E93DAD56A7230B565179CD29CAA1", true],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "4B6D8FEA3786BFC6152EAEA791C4DAF00C41E93DAD56A7230B565179CD29CAA1",
    "height": "12345",
    "index": 2,
    "tx_result": {
      "code": 0,
      "log": "Success",
      "events": [
        {
          "type": "transfer",
          "attributes": [
            { "key": "sender", "value": "kava1xyz..." },
            { "key": "recipient", "value": "kava1abc..." },
            { "key": "amount", "value": "10000ukava" }
          ]
        }
      ]
    },
    "tx": "BASE64_ENCODED_TX",  // The transaction itself in Base64 format
    "proof": {
      "root_hash": "0xABC123...",
      "data": "BASE64_ENCODED_PROOF",
      "proof": { /* Detailed proof structure */ }
    }
  }
}

Transactions

broadcast_tx_sync

Returns with the response from CheckTx. Does not wait for DeliverTx result.

If you want to be sure that the transaction is included in a block, you can subscribe for the result using JSON-RPC via a websocket. See https://docs.cometbft.com/v0.34/core/subscription.html (opens in a new tab) If you haven't received anything after a couple of blocks, resend it. If the same happens again, send it to some other node. A few reasons why it could happen:

  1. A malicious node drops or pretends it has committed your tx.
  2. A malicious proposer (not necessary the one you're communicating with) drops transactions, which might become valid in the future (https://github.com/tendermint/tendermint/issues/3322 (opens in a new tab)).

Please refer to Tendermint docs (opens in a new tab) for formatting/encoding rules.

Parameters


  • tx (string; required): the signed transaction, encoded as Base64.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "broadcast_tx_sync",
      "params": ["<BASE64_ENCODED_TRANSACTION>"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "code": 0,
    "data": "",
    "log": "transaction successfully broadcasted",
    "hash": "0xABC123..." // The transaction hash
  }
}

broadcast_tx_async

Returns right away, with no response. Does not wait for CheckTx nor DeliverTx results.

If you want to be sure that the transaction is included in a block, you can subscribe for the result using JSON-RPC via a websocket. See https://docs.cometbft.com/v0.34/core/subscription.html (opens in a new tab) If you haven't received anything after a couple of blocks, resend it. If the same happens again, send it to some other node. A few reasons why it could happen:

  1. A malicious node drops or pretends it has committed your tx.
  2. A malicious proposer (not necessary the one you're communicating with) drops transactions, which might become valid in the future (https://github.com/tendermint/tendermint/issues/3322 (opens in a new tab)).
  3. A node is offline.

Please refer to CometBFT docs (opens in a new tab) for formatting/encoding rules.

Parameters


  • tx (string; required): the Base64-encoded signed transaction.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "broadcast_tx_async",
      "params": ["<BASE64_ENCODED_TRANSACTION>"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "code": 0,
    "data": "",
    "log": "",
    "hash": "0xABC123..." // Transaction hash
  }
}

broadcast_tx_commit

Returns with the responses from CheckTx and DeliverTx.

Use only for testing and development. In production, use BroadcastTxSync or BroadcastTxAsync. You can subscribe for the transaction result using JSON-RPC via a websocket (see CometBFT docs (opens in a new tab)).

CONTRACT: only returns error if mempool.CheckTx() errs or if we timeout waiting for tx to commit. If CheckTx or DeliverTx fails, no error will be returned, but the result will contain a non-OK ABCI code. Please refer to CometBFT docs (opens in a new tab) for formatting/encoding rules.

Parameters


  • tx (string; required): the Base64-encoded signed transaction.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "broadcast_tx_commit",
      "params": ["<BASE64_ENCODED_TRANSACTION>"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "check_tx": {
      "code": 0,
      "data": "",
      "log": "Transaction checked successfully"
    },
    "deliver_tx": {
      "code": 0,
      "data": "",
      "log": "Transaction delivered successfully",
      "events": [
        {
          "type": "transfer",
          "attributes": [
            { "key": "sender", "value": "kava1xyz..." },
            { "key": "recipient", "value": "kava1abc..." },
            { "key": "amount", "value": "10000ukava" }
          ]
        }
      ]
    },
    "hash": "0xABC123...",
    "height": "12345"
  }
}

check_tx

Checks the transaction without executing it.

The transaction won't be added to the mempool.

Please refer to CometBFT docs (opens in a new tab) for formatting/encoding rules.

Parameters


  • tx (string; required): the Base64-encoded signed transaction.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "check_tx",
      "params": ["<BASE64_ENCODED_TRANSACTION>"],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "code": 0,
    "data": "",
    "log": "Transaction is valid",
    "events": [
      {
        "type": "transfer",
        "attributes": [
          { "key": "sender", "value": "kava1xyz..." },
          { "key": "recipient", "value": "kava1abc..." },
          { "key": "amount", "value": "10000ukava" }
        ]
      }
    ]
  }
}

ABCI

abci_info

Retrieves application info.

Parameters


None.

Returns

Application info.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "abci_info",
      "params": [],
      "id": 1
    }'

Response example

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "response": {
            "data": "kava",
            "version": "0.27.0",
            "app_version": "8",
            "last_block_height": "13239641",
            "last_block_app_hash": "wLirVXfBEeq0jZcrshBGWS7AGN19N7p8aQqMAiaIl+I="
        }
    }
}

abci_query

Queries the application for particular information.

Parameters


  • path (string; required): a path to the data ("/a/b/c").
  • data (string; required): the hex-encoded data.
  • height (integer; default: 0): the height (0 means latest).
  • prove (boolean; default: false): adds proofs of the transactions inclusion in the block.

Returns

Particular info according to the query submitted.

Request example

curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "abci_query",
      "params": ["a/b/c", "the_data", "1", true],
      "id": 1
    }'

Response example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "response": {
      "code": 0,
      "log": "",
      "info": "",
      "index": -1,
      "key": "0x6b61766131387879377a...",
      "value": "0x123456789abcdef", // Hex-encoded value
      "proofOps": null,
      "height": "12345",
      "codespace": ""
    }
  }
}

Cosmos REST methods

Query:

Service:

Auth methods

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

Retrieves account details based on address.

Parameters

  • address (string; required): an address to query for account details.

Returns

Account details.

Request example

curl https://rpc.ankr.com/http/kava_api/cosmos/auth/v1beta1/accounts/{address}

Response example

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

/cosmos/auth/v1beta1/params

Retrieves all parameters.

Parameters

None.

Returns

Parameters.

Request example

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

Response example

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

Bank 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
          }
        ]
      }
    ]
  }
}

/cosmos/tx/v1beta1/txs

Fetches txs by event.

Parameters

  • events (array[string]): a list of transaction event type.
  • 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

Transactions.

Request example

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

Response example

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

Broadcasts a transaction.

Parameters

  • <body> (object; required):
{
  "tx_bytes": "string",
  "mode": "BROADCAST_MODE_UNSPECIFIED"
}

Returns

Broadcasted transaction.

Request example

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

Response example

{
  "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, hex; required): a tx hash to query, encoded as a hex string.

Returns

Transaction.

Request example

curl https://rpc.ankr.com/http/kava_api/cosmos/tx/v1beta1/txs/{hash}

Response example

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