Skip to main content
POST
/
35848e183f3e3303c8cfeacbea831cab
eth_getBalance
curl --request POST \
  --url https://bsc-mainnet.core.chainstack.com/35848e183f3e3303c8cfeacbea831cab \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x6B8E1585035b5B53afcd9791076E43b53D3e1AA4",
    "pending"
  ]
}
'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": {}
}
BNB API method that returns the balance of a specific Ethereum account in Wei, the smallest unit of ether. This method allows developers to retrieve the current balance of a BNB account for various purposes, such as checking available funds or displaying balance information.
When called against a block older than the latest ~128 blocks, this method is treated as an archive request (2 RUs instead of 1 RU). See request units.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • address — the address to check the balance of.
  • quantity or tag — the integer of a block encoded as hexadecimal or the string with:
    • latest — the most recent block in the blockchain and the current state of the blockchain at the most recent block. A chain reorganization is to be expected.
    • safe—the block that received justification from the beacon chain. Although this block could be involved in a chain reorganization, it would necessitate either a coordinated attack by the majority of validators or severe propagation latency.
    • finalized — the block accepted as canonical by more than 2/3 of the validators. A chain reorganization is extremely unlikely, and it would require at least 1/3 of the staked amount to be burned.
    • earliest — the earliest available or genesis block
    • pending— the pending state and transactions block. This is the current state of transactions that have been broadcast to the network but have not yet been included in a block.
See the default block parameter and How The Merge Impacts Ethereum’s Application Layer.

​
Response

  • quantity — the integer value of the current balance in Wei

​
eth_getBalance code examples

const { Web3 } = require("web3");
const NODE_URL = "CHAINSTACK_NODE_URL";
const web3 = new Web3(NODE_URL);

async function getBalance(address, block) {
  const balance = await web3.eth.getBalance(address, block)
  console.log(balance)
 }
 
 getBalance("0x8894E0a0c962CB723c1976a4421c95949bE2D4E3", "latest" )

​
Use case

One practical use case for eth_getBalance is to check the balance of an account for a program that scans the balance periodically and fills up the account when the balance drops below a certain value.

Body

application/json
​
id
integer
default:1
​
jsonrpc
string
default:2.0
​
method
string
default:eth_getBalance
​
params
string[]

The address identifier.

Response

200 - application/json

The account balance.

​
jsonrpc
string
​
id
integer
​
result
object
Last modified on May 18, 2026