eth_getBalance on XLayer
Returns the native-token balance (in wei) of an address at a given block. The standard way to read a wallet's balance.
This returns the native coin only — for ERC-20 balances use eth_call against the token's balanceOf. Pass an explicit block number for point-in-time reads; latest moves every block.
XLayer endpoint (public — no key)
https://rpc.nodeflare.app/xlayer/publicMethod
eth_getBalance
Cost
2 CU
Chain ID
196
Block time
~1 s
Finality
soft ~1 s · hard on validity proof to L1
Accounts & state on XLayer
eth_getBalance returns OKB. The chain is closely tied to the OKX ecosystem, with bridged assets dominating state.
Parameters
[address, blockNumber|tag]cURL
curl https://rpc.nodeflare.app/xlayer/public \
-X POST \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x0000000000000000000000000000000000000000", "latest"],"id":1}'ethers.js
import { ethers } from 'ethers';
const provider = new ethers.JsonRpcProvider(
'https://rpc.nodeflare.app/xlayer/public'
);
const result = await provider.send('eth_getBalance', ["0x0000000000000000000000000000000000000000", "latest"]);Try it live
Runs the example above against the public XLayer endpoint — straight from your browser.
eth_getBalance on XLayer — FAQ
How do I call eth_getBalance on XLayer?
POST a JSON-RPC 2.0 request with "method": "eth_getBalance" to NodeFlare's XLayer endpoint at https://rpc.nodeflare.app/xlayer/public. No API key is required for the public endpoint.
What does eth_getBalance cost on the free tier?
eth_getBalance is weighted at 2 compute units per call. The free tier includes 2,000,000 CU/month, so that is roughly 1,000,000 eth_getBalance calls per month — no credit card.
Is eth_getBalance available on the public XLayer endpoint?
Yes. eth_getBalance works on the public XLayer endpoint (https://rpc.nodeflare.app/xlayer/public) with no API key, rate-limited per IP. A free key adds higher limits and a dedicated path.
Anything XLayer-specific to know when using eth_getBalance?
eth_getBalance returns OKB. The chain is closely tied to the OKX ecosystem, with bridged assets dominating state.
Call eth_getBalance on XLayer with a free key
2,000,000 compute units/month, heavy methods unlocked, every chain included. No credit card.
Get your free API key →