Kaia - JSON-RPC

JSON-RPC methods supported on Kaia Mainnet and Kaia Kairos through Tatum RPC Gateway, with base URLs and an example request.

Call Kaia JSON-RPC methods through Tatum RPC Gateway. Send an HTTP POST request with a JSON-RPC 2.0 body to the network's base URL, with your API key in the x-api-key header. See Authentication.

Base URLs

NetworkBase URL
Kaia Mainnethttps://kaia-mainnet.gateway.tatum.io
Kaia Kairoshttps://kaia-kairos.gateway.tatum.io

Example request

curl 'https://kaia-mainnet.gateway.tatum.io' \
  --header 'content-type: application/json' \
  --header 'x-api-key: {YOUR_API_KEY}' \
  --data '{"jsonrpc":"2.0","method":"kaia_blockNumber","params":[],"id":1}'

Methods

96 methods. Parameters and responses are described in the Kaia JSON-RPC API reference; linked method names go to their page there.

MethodDescription
debug_getBadBlocksReturns the last bad blocks the node has seen on the network.
debug_storageRangeAtReturns the storage of a contract at a given block and transaction index.
debug_traceBlockReplays all transactions of an RLP-encoded block and returns their traces.
debug_traceBlockByHashReplays all transactions of a block, selected by hash, and returns their traces.
debug_traceBlockByNumberReplays all transactions of a block, selected by number, and returns their traces.
debug_traceCallRuns a call on top of a given block without creating a transaction and returns its trace.
debug_traceTransactionReplays a transaction and returns its execution trace.
eth_blockNumberReturns the number of the most recent block.
eth_callExecutes a message call immediately without creating a transaction on the chain.
eth_callManyExecutes a list of message calls in sequence on top of a given block, without creating transactions.
eth_chainIdReturns the chain ID used for signing replay-protected transactions.
eth_estimateGasEstimates the gas needed to execute a transaction without adding it to the chain.
eth_feeHistoryReturns base fees, gas usage ratios and priority fee percentiles for a range of blocks.
eth_gasPriceReturns the current gas price in wei.
eth_getBalanceReturns the balance of an address in wei.
eth_getBlockByHashReturns information about a block by hash.
eth_getBlockByNumberReturns information about a block by number.
eth_getBlockReceiptsReturns the receipts of all transactions in a block.
eth_getBlockTransactionCountByHashReturns the number of transactions in a block, selected by hash.
eth_getBlockTransactionCountByNumberReturns the number of transactions in a block, selected by number.
eth_getCodeReturns the bytecode at an address.
eth_getLogsReturns the logs that match a filter object.
eth_getProofReturns the Merkle proof of an account and, optionally, of some of its storage slots.
eth_getStorageAtReturns the value of a storage slot at an address.
eth_getTransactionByBlockHashAndIndexReturns a transaction by block hash and transaction index.
eth_getTransactionByBlockNumberAndIndexReturns a transaction by block number and transaction index.
eth_getTransactionByHashReturns a transaction by hash.
eth_getTransactionCountReturns the number of transactions sent from an address (its nonce).
eth_getTransactionReceiptReturns the receipt of a transaction by transaction hash.
eth_getUncleByBlockHashAndIndexReturns an uncle of a block, selected by block hash and uncle index.
eth_getUncleByBlockNumberAndIndexReturns an uncle of a block, selected by block number and uncle index.
eth_getUncleCountByBlockHashReturns the number of uncles in a block, selected by hash.
eth_getUncleCountByBlockNumberReturns the number of uncles in a block, selected by number.
eth_maxPriorityFeePerGasReturns a suggested priority fee (tip) per gas in wei.
eth_sendRawTransactionSubmits a signed, RLP-encoded transaction to the network.
eth_signTypedDataSigns EIP-712 typed structured data.
eth_signTypedData_v3Signs EIP-712 typed structured data (version 3 of the format).
eth_simulateV1Simulates a sequence of blocks and calls on top of a given block and returns the results.
eth_syncingReturns the sync status of the node, or false when it is not syncing.
kaia_blockNumberReturns the number of the most recent block.
kaia_callExecutes a call without creating a transaction on the chain.
kaia_chainIdReturns the chain ID of the network.
kaia_estimateGasEstimates the gas needed to execute a transaction without sending it.
kaia_gasPriceReturns the current suggested gas price in kei.
kaia_getBalanceReturns the balance of an account at a given block.
kaia_getBlockByHashReturns a block by its hash.
kaia_getBlockByNumberReturns a block by its number.
kaia_getBlockReceiptsReturns the receipts of all transactions in a block, identified by block hash.
kaia_getBlockTransactionCountByHashReturns the number of transactions in a block, by block hash.
kaia_getBlockTransactionCountByNumberReturns the number of transactions in a block, by block number.
kaia_getCodeReturns the bytecode at a given address.
kaia_getLogsReturns the logs that match a given filter object.
kaia_getStorageAtReturns the value from a storage position at a given address.
kaia_getTransactionByBlockHashAndIndexReturns a transaction by block hash and transaction index.
kaia_getTransactionByBlockNumberAndIndexReturns a transaction by block number and transaction index.
kaia_getTransactionByHashReturns a transaction by its hash.
kaia_getTransactionCountReturns the number of transactions sent from an address (its nonce).
kaia_getTransactionReceiptReturns the receipt of a transaction by its hash.
kaia_maxPriorityFeePerGasReturns a recommended priority fee per gas for a new transaction.
kaia_sendRawTransactionSubmits a signed, RLP-encoded transaction to the network.
klay_blockNumberReturns the number of the most recent block. Legacy alias of kaia_blockNumber.
klay_callExecutes a call without creating a transaction on the chain. Legacy alias of kaia_call.
klay_chainIdReturns the chain ID of the network. Legacy alias of kaia_chainId.
klay_estimateGasEstimates the gas needed to execute a transaction without sending it. Legacy alias of kaia_estimateGas.
klay_gasPriceReturns the current suggested gas price in kei. Legacy alias of kaia_gasPrice.
klay_getBalanceReturns the balance of an account at a given block. Legacy alias of kaia_getBalance.
klay_getBlockByHashReturns a block by its hash. Legacy alias of kaia_getBlockByHash.
klay_getBlockByNumberReturns a block by its number. Legacy alias of kaia_getBlockByNumber.
klay_getBlockReceiptsReturns the receipts of all transactions in a block, identified by block hash. Legacy alias of kaia_getBlockReceipts.
klay_getBlockTransactionCountByHashReturns the number of transactions in a block, by block hash. Legacy alias of kaia_getBlockTransactionCountByHash.
klay_getBlockTransactionCountByNumberReturns the number of transactions in a block, by block number. Legacy alias of kaia_getBlockTransactionCountByNumber.
klay_getCodeReturns the bytecode at a given address. Legacy alias of kaia_getCode.
klay_getLogsReturns the logs that match a given filter object. Legacy alias of kaia_getLogs.
klay_getRewardsReturns the reward distribution of a block, including rewardees and their shares.
klay_getStorageAtReturns the value from a storage position at a given address. Legacy alias of kaia_getStorageAt.
klay_getTransactionByBlockHashAndIndexReturns a transaction by block hash and transaction index. Legacy alias of kaia_getTransactionByBlockHashAndIndex.
klay_getTransactionByBlockNumberAndIndexReturns a transaction by block number and transaction index. Legacy alias of kaia_getTransactionByBlockNumberAndIndex.
klay_getTransactionByHashReturns a transaction by its hash. Legacy alias of kaia_getTransactionByHash.
klay_getTransactionCountReturns the number of transactions sent from an address (its nonce). Legacy alias of kaia_getTransactionCount.
klay_getTransactionReceiptReturns the receipt of a transaction by its hash. Legacy alias of kaia_getTransactionReceipt.
klay_maxPriorityFeePerGasReturns a recommended priority fee per gas for a new transaction. Legacy alias of kaia_maxPriorityFeePerGas.
klay_sendRawTransactionSubmits a signed, RLP-encoded transaction to the network. Legacy alias of kaia_sendRawTransaction.
net_listeningReturns true when the client is listening for network connections.
net_peerCountReturns the number of peers connected to the client.
net_versionReturns the current network ID.
trace_blockReturns the traces of all transactions in a block.
trace_callRuns a call and returns the requested traces (trace, vmTrace, stateDiff) without creating a transaction.
trace_callManyRuns a list of calls in sequence, each on top of the state of the previous one, and returns their traces.
trace_rawTransactionTraces a signed raw transaction without broadcasting it.
trace_replayBlockTransactionsReplays all transactions of a block and returns the requested traces.
trace_replayTransactionReplays a transaction and returns the requested traces.
trace_transactionReturns all traces of a transaction.
txpool_contentReturns the pending and queued transactions in the transaction pool.
txpool_inspectReturns a text summary of the pending and queued transactions in the transaction pool.
txpool_statusReturns the number of pending and queued transactions in the transaction pool.
web3_clientVersionReturns the client version.

The gateway lists its supported methods at runtime:

Method unavailable?

If you need a method we don't support yet, contact support.