Accounts & state2 CU

eth_getBalance on Soneium

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.

Soneium endpoint (public — no key)

https://rpc.nodeflare.app/soneium/public

Method

eth_getBalance

Cost

2 CU

Chain ID

1868

Block time

~2 s

Finality

~2 s soft · L1-final ~13 min

Accounts & state on Soneium

Launched January 2025, so state is compact and any point-in-time read is fast. Entertainment/IP apps and their NFT contracts make up much of the state.

Parameters

[address, blockNumber|tag]

cURL

curl https://rpc.nodeflare.app/soneium/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/soneium/public'
);

const result = await provider.send('eth_getBalance', ["0x0000000000000000000000000000000000000000", "latest"]);

Try it live

Runs the example above against the public Soneium endpoint — straight from your browser.

eth_getBalance on Soneium — FAQ

How do I call eth_getBalance on Soneium?

POST a JSON-RPC 2.0 request with "method": "eth_getBalance" to NodeFlare's Soneium endpoint at https://rpc.nodeflare.app/soneium/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 Soneium endpoint?

Yes. eth_getBalance works on the public Soneium endpoint (https://rpc.nodeflare.app/soneium/public) with no API key, rate-limited per IP. A free key adds higher limits and a dedicated path.

Anything Soneium-specific to know when using eth_getBalance?

Launched January 2025, so state is compact and any point-in-time read is fast. Entertainment/IP apps and their NFT contracts make up much of the state.

Call eth_getBalance on Soneium with a free key

2,000,000 compute units/month, heavy methods unlocked, every chain included. No credit card.

Get your free API key →