Kaia (KAIA)

GetBlock provides fast and reliable access to Kaia nodes via JSON-RPC API. Connect to the Kaia network without running your own infrastructure.

Kaia is an EVM-compatible Layer 1 blockchain formed by the merger of Klaytn and Finschia, backed by the Kakao and LINE ecosystems. It is a hard fork of the Klaytn chain, so the chain ID remains 8217, while the native token is now KAIA (the rebrand of KLAY). Kaia targets roughly 1-second blocks with immediate finality, using a BFT consensus operated by a governance council of validators.

Kaia is EVM-compatible and exposes the standard Ethereum JSON-RPC method set through the eth_ namespace, so Ethereum contracts and tooling — Hardhat, Foundry, ethers.js, viem, and web3.py — run without modification. Kaia also exposes a native kaia_ namespace (the rebrand of Klaytn's klay_) with methods that have no Ethereum equivalent, such as account-key lookups, consensus and council information, and block reward distribution.

Key Features

• EVM Compatibility: Standard Ethereum JSON-RPC via the eth_ namespace; deploy Solidity contracts and use Hardhat, Foundry, ethers.js, viem, and web3.py without modification

• Native kaia_ Namespace: Kaia-specific methods for account keys, consensus and council data, and rewards, alongside the eth_ namespace

• BFT Consensus with Immediate Finality: A governance council of validators finalizes blocks in roughly one second, with no reorgs

• Flexible Account Keys: Accounts decouple keys from addresses, supporting public, weighted multisig, and role-based keys

• Fee Delegation: Kaia natively supports fee-delegated transactions, where a fee payer covers a user's gas

• KAIA Native Token: KAIA pays gas; the base unit is kei (1 KAIA = 10^18 kei), and gas prices are quoted in ston

• Kakao and LINE Ecosystem: Backed by two of Asia's largest platforms, with a focus on consumer and mini-dApp use cases

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC SPECIFICATION

GetBlock's Kaia API reference documentation is provided exclusively for informational purposes and to optimize the developer experience. The canonical and normative specification for the Ethereum JSON-RPC API is maintained by the Ethereum community and published at ethereum.org/en/developers/docs/apis/json-rpc/. For the kaia_ namespace and Kaia-specific protocol details, consult the official documentation at docs.kaia.io.

Network Information

Property	Value
Network Name	Kaia Mainnet
Stage	Mainnet (live)
Chain ID	8217 (0x2019)
Native Currency	KAIA
Decimals	18 (base unit: kei; gas unit: ston)
Consensus	BFT with a governance council, immediate finality
Smart Contract VM	EVM (EVM-compatible)
Address Format	Ethereum-style (0x…, 20 bytes)
Block Explorer	kaiascan.io
Testnet	Kairos (Chain ID 1001)

Base URL

https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

All Kaia JSON-RPC methods are called by sending a POST request to the base URL with a standard JSON-RPC 2.0 body. For a WebSocket connection, use the WebSocket scheme: wss://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/.

Supported Networks

Network	JSON-RPC	WSS	Frankfurt, Germany
Mainnet	✅	✅	✅

Kairos Testnet (Chain ID 1001) is the test environment for staging contracts before mainnet. Confirm testnet endpoint availability from the GetBlock dashboard.

Quickstart

In this section, you will learn how to make your first call with either:

• Axios (JavaScript / Node.js)

• Python (Requests library)

Before you begin, you must have already installed npm or yarn on your local machine (for the Axios example) or Python and pip (for the Python example).

JavaScript (Axios)

1

Setup project

Create and initialize a new project:

mkdir kaia-api-quickstart
cd kaia-api-quickstart
npm init --yes

2

Install Axios

npm install axios

3

Create file

Create a new file named index.js. This is where you will make your first call.

4

Set ES module type

Set the ES module "type": "module" in your package.json.

5

Add code

Add the following code to index.js:

index.js

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data, null, 2)))
    .catch(error => console.log(error));

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

6

Run the script

node index.js

Expected output:

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "0x2019"
}

The result field is the Kaia Mainnet chain ID (0x2019 = 8217 in decimal). This confirms you are connected to the correct network.

Python (Requests)

1

Setup the project directory

mkdir kaia-api-quickstart
cd kaia-api-quickstart

2

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate

3

Install requests

pip install requests

4

Create script

Create a file called main.py with the following content:

main.py

import requests
import json

url = "https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

5

Run the script

python main.py

Available API Methods

Kaia exposes the standard Ethereum JSON-RPC method set plus native kaia_ methods. All methods are POST-only and called against the base URL above.

Block & Chain Information

Method	Description
eth_blockNumber	Returns the current latest block number
eth_chainId	Returns the chain ID (0x2019 = 8217 for Kaia Mainnet)
eth_getBlockByNumber	Returns block information by block number
eth_getBlockByHash	Returns block information by block hash
eth_getBlockTransactionCountByNumber	Returns the number of transactions in a block by block number
eth_getBlockTransactionCountByHash	Returns the number of transactions in a block by block hash
eth_getBlockReceipts	Returns all transaction receipts for a given block
eth_syncing	Returns sync status or false if the node is fully synced

Account & State

Method	Description
eth_getBalance	Returns the native KAIA balance of an account (in kei)
eth_getCode	Returns the contract bytecode at a given address
eth_getStorageAt	Returns the value at a specific storage slot
eth_getTransactionCount	Returns the transaction count (nonce) for an account

Transactions

Method	Description
eth_sendRawTransaction	Broadcasts a signed transaction
eth_getTransactionByHash	Returns a transaction by its hash
eth_getTransactionByBlockHashAndIndex	Returns a transaction by block hash and index
eth_getTransactionByBlockNumberAndIndex	Returns a transaction by block number and index
eth_getTransactionReceipt	Returns the receipt for a transaction by hash
eth_call	Executes a read-only call against contract state
eth_estimateGas	Estimates gas required for a transaction

Gas & Fee Market

Method	Description
eth_gasPrice	Returns the current gas price in kei
eth_maxPriorityFeePerGas	Returns the suggested max priority fee per gas (EIP-1559)
eth_feeHistory	Returns historical base fees and priority fees

Logs

Method	Description
eth_getLogs	Returns logs matching a given filter

Debug & Trace

Method	Description
debug_traceTransaction	Replays a transaction and returns an execution trace
debug_traceBlockByNumber	Traces every transaction in a block by block number
debug_traceBlockByHash	Traces every transaction in a block by block hash

Kaia Native (kaia_)

Method	Description
kaia_getAccount	Returns the Kaia account object, including type and key
kaia_getAccountKey	Returns the account key of an EOA
kaia_getBlockWithConsensusInfoByNumber	Returns a block with its proposer and committee
kaia_getCouncil	Returns the governance council validators at a block
kaia_getCommittee	Returns the committee validators for a block
kaia_getRewards	Returns the block reward distribution
kaia_isContractAccount	Returns whether an address is a Smart Contract Account

Network & Client Info

Method	Description
net_version	Returns the network ID (8217 for Kaia Mainnet)
web3_clientVersion	Returns the client software version

Support

For technical support and questions:

• Support Email: [e-mail]

See Also

• Official Kaia Documentation

• Kaia JSON-RPC Reference

• Ethereum JSON-RPC Specification

• Kaia Block Explorer (KaiaScan)

• Kaia on Chainlist

• Ethers.js Documentation

• Viem Documentation