eth_getBalance - Polygon

Example code for the eth_getBalance json-rpc method. Сomplete guide on how to use eth_getBalance json-rpc in GetBlock.io Web3 documentation.

The eth_getBalance method returns the balance of the account at the given address. The balance is returned in wei, which is the smallest unit of MATIC (1 MATIC = 10^18 wei).

Parameters

Parameter

Type

Required

Description

address

string

Yes

The 20-byte account address to check balance

blockParameter

string

Yes

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

Request

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": ["0x742d35Cc6634C0532925a3b844Bc9e7595f5bEb1", "latest"],
    "id": "getblock.io"
}'

JavaScript (Axios)

import axios from 'axios';

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

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

axios.post(url, payload, {
    headers: { 'Content-Type': 'application/json' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

Python (requests)

import requests

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

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

response = requests.post(url, headers={"Content-Type": "application/json"}, json=payload)
print(response.json())

Rust (reqwest)

use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "eth_getBalance",
            "params": ["0x742d35Cc6634C0532925a3b844Bc9e7595f5bEb1", "latest"],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

Response

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

Response Parameters

Field

Type

Description

jsonrpc

string

JSON-RPC version (2.0)

string

Request identifier

result

varies

The balance in wei as a hexadecimal string

Use Case

The eth_getBalance method is useful for:

Check wallet balances
Verify sufficient funds before transactions
Track account value changes
Build portfolio trackers

Error Handling

Status Code / Error

Cause

403

Forbidden — Missing or invalid ACCESS-TOKEN

-32600

Invalid Request — Malformed request body

-32602

Invalid params — Invalid method parameters

Web3 Integration

Ethers.js

import { ethers } from 'ethers';

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

const result = await provider.send('eth_getBalance', ["0x742d35Cc6634C0532925a3b844Bc9e7595f5bEb1", "latest"]);
console.log('Result:', result);

Viem

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

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

const result = await client.request({
    method: 'eth_getBalance',
    params: ["0x742d35Cc6634C0532925a3b844Bc9e7595f5bEb1", "latest"]
});
console.log('Result:', result);

Previouseth_gasPrice - Polygon Nexteth_getBlockByHash - Polygon

Last updated 17 days ago

Was this helpful?

hashtagParameters

hashtagRequest

hashtagResponse

hashtagResponse Parameters

hashtagUse Case

hashtagError Handling

hashtagWeb3 Integration

Parameters

Request

Response

Response Parameters

Use Case

Error Handling

Web3 Integration