eth_getBalance - Mantle

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

This method returns the MNT balance of the account specified by address on the Mantle network.

Parameters

Parameter

Type

Description

address

string

20-byte address to check for balance

blockParameter

string

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

Request examples

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

example.js

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0xD85498dbEaEB1Df24BE52eED4F52eAc2Fbd56245", "latest"],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data)))
    .catch(error => console.log(error));

example.py

import requests
import json

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

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0xD85498dbEaEB1Df24BE52eED4F52eAc2Fbd56245", "latest"],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

main.rs

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": ["0xD85498dbEaEB1Df24BE52eED4F52eAc2Fbd56245", "latest"],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

Response

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

Response Parameters

Field

Type

Description

jsonrpc

string

JSON-RPC protocol version ("2.0")

string

Request identifier matching the request

result

string

Current balance in wei (hexadecimal)

Use Case

The eth_getBalance method is essential for:

Wallet balance displays
Checking MNT holdings before transactions
Portfolio tracking applications
DeFi protocol balance monitoring
Transaction validation (sufficient funds)
Account activity monitoring

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid ACCESS-TOKEN

-32602

Invalid params

Invalid address format or block parameter

Web3 Integration

ethers.js

import { ethers } from 'ethers';

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

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

viem.js

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

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

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

Previouseth_feeHistory - Mantle Nexteth_getBlockByHash - Mantle

Last updated 3 days ago

Was this helpful?