🟪 Polygon

Polygon API Documentation

eth_getBalance RPC Method

The eth_getBalance method returns the balance (in wei) of the specified account address at the latest block.


eth_getBalance only returns the balance of the native chain currency (ex: Matic for Polygon or ETH for Ethereum or) and does not include any ERC20 token balances.



Balance - The chosen address’ balance in wei as an integer.


POST https://<network>.chainnodes.org/YOUR-API-KEY


💡 Confusing?

Ask our experienced blockchain developers in Telegram

  • HTTPS POST Request with a JSON RPC call in the body
  • Replace YOUR-API-KEY with the API key from your CHAINNODES.ORG Dashboard
  • You can use a different supported network by replacing polygon-mainnet
curl https://polygon-mainnet.chainnodes.org/YOUR-API-KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getBalance","params": ["0x95222290DD7278Aa3Ddd389Cc1E1d165CC4BAfe5", "latest"],"id":1}'


  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x19451085df7bc276d"

Some use cases:

  1. Wallet Balance Display: Wallet applications use eth_getBalance to display the current balance of a user's account.
  2. Transaction Validation: Before sending a transaction, a user or a wallet can call eth_getBalance to check if the account has enough balance to cover the transaction cost. This can prevent failed transactions due to insufficient funds.
  3. Account Monitoring: Services that monitor Ethereum accounts for various purposes (like auditing, alerting, or reporting) use eth_getBalance to track the balance of specific accounts over time.
  4. DApp Interaction: Decentralized applications use eth_getBalance to check the balance of a user's account before performing actions that require a certain minimum balance.

Need RPC API keys?

Get 12.5M archival requests for free today.

JSON-RPC API Documentation by CHAINNODES is based on Erigon node client. Contact us if you are interested in specific methods that are only available on geth, besu, Nethermind or reth