eth_getBalance - BSC

Example code for the eth_getBalance JSON RPC method. Сomplete guide on how to use eth_getBalance JSON RPC in GetBlock Web3 documentation.

This method returns the balance of the account at a given address on the BNB Smart Chain. The balance is returned in wei (the smallest unit of BNB, where 1 BNB = 10^18 wei). This method is essential for wallet applications, balance verification, and transaction preparation.

Balances are returned in wei (1 BNB = 10^18 wei). Convert from hex wei to decimal and then to BNB by dividing by 1e18.

Parameters

Parameter

Type

Required

Description

address

string

Yes

The address to check balance (20 bytes, 0x-prefixed)

block

string

Yes

Block number in hex, or "latest", "earliest", "pending"

Request Example

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9", "latest"],
    "id": "getblock.io"
}'

JavaScript (Axios)

const axios = require('axios');

const url = 'https://go.getblock.io/<ACCESS-TOKEN>/';

const payload = {
    jsonrpc: '2.0',
    method: 'eth_getBalance',
    params: ['0x8D97689C9818892B700e27F316cc3E41e17fBeb9', 'latest'],
    id: 'getblock.io'
};

axios.post(url, payload, {
    headers: { 'Content-Type': 'application/json' }
})
.then(response => {
    const balanceWei = parseInt(response.data.result, 16);
    const balanceBnb = balanceWei / 1e18;
    console.log('Balance:', balanceBnb, 'BNB');
})
.catch(error => console.error(error));

Python

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = {
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9", "latest"],
    "id": "getblock.io"
}

response = requests.post(url, headers={"Content-Type": "application/json"}, json=payload)
balance_wei = int(response.json()["result"], 16)
balance_bnb = balance_wei / 1e18
print(f"Balance: {balance_bnb} BNB")

Rust

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    
    let payload = json!({
        "jsonrpc": "2.0",
        "method": "eth_getBalance",
        "params": ["0x8D97689C9818892B700e27F316cc3E41e17fBeb9", "latest"],
        "id": "getblock.io"
    });

    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);
    
    Ok(())
}

Response Example

Response (JSON)

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "0x8ac7230489e80000"
}

Response Parameters

Parameter

Type

Description

jsonrpc

string

JSON-RPC version (2.0)

string

Request identifier

result

string

Balance in wei (0x8ac7230489e80000 = 10 BNB)

Use Cases

Display wallet balance in dApps
Verify sufficient BNB for gas fees
Check account holdings before transactions
Monitor wallet addresses
Calculate portfolio values

Error Handling

Error Code

Description

-32602

Invalid params - malformed address or block parameter

-32603

Internal error - node processing issues

-32000

Server error - RPC endpoint unavailable

SDK Integration

Ethers.js

const { ethers } = require('ethers');

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

const balance = await provider.getBalance('0x8D97689C9818892B700e27F316cc3E41e17fBeb9');
console.log('Balance:', ethers.formatEther(balance), 'BNB');

Viem

import { createPublicClient, http, formatEther } from 'viem';
import { bsc } from 'viem/chains';

const client = createPublicClient({
    chain: bsc,
    transport: http('https://go.getblock.io/<ACCESS-TOKEN>/')
});

const balance = await client.getBalance({
    address: '0x8D97689C9818892B700e27F316cc3E41e17fBeb9'
});
console.log('Balance:', formatEther(balance), 'BNB');

Previouseth_estimateGas - BSC Nexteth_getLogs - BSC

Last updated 12 days ago

Was this helpful?

hashtagParameters

hashtagRequest Example

hashtagResponse Example

hashtagResponse Parameters

hashtagUse Cases

hashtagError Handling

hashtagSDK Integration

Parameters

Request Example

Response Example

Response Parameters

Use Cases

Error Handling

SDK Integration