Accounts & state2 CU

eth_getBalance on Polygon

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.

Polygon endpoint (public — no key)

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

Method

eth_getBalance

Cost

2 CU

Chain ID

137

Block time

~1.5 s

Finality

~5 s (milestone finality)

Accounts & state on Polygon

Polygon has processed billions of transactions since 2020 — state is among the largest of any EVM chain. Near-head reads are fast; deep-historical state queries are heavier than on young chains.

Parameters

[address, blockNumber|tag]

cURL

curl https://rpc.nodeflare.app/polygon/public \
  -X POST \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "latest"],"id":1}'

The example targets the USDC contract on Polygon — you can run it as-is.

ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider(
  'https://rpc.nodeflare.app/polygon/public'
);

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

Try it live

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

eth_getBalance on Polygon — FAQ

How do I call eth_getBalance on Polygon?

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

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

Anything Polygon-specific to know when using eth_getBalance?

Polygon has processed billions of transactions since 2020 — state is among the largest of any EVM chain. Near-head reads are fast; deep-historical state queries are heavier than on young chains.

Call eth_getBalance on Polygon with a free key

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

Get your free API key →