eth_getBalance

curl --request POST \
  --url https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x5d20879655df3c1e04ab111af0009ad650e762f0",
    "latest"
  ]
}
'

import requests

url = "https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/"

payload = {
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0x5d20879655df3c1e04ab111af0009ad650e762f0", "latest"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 1,
    jsonrpc: '2.0',
    method: 'eth_getBalance',
    params: ['0x5d20879655df3c1e04ab111af0009ad650e762f0', 'latest']
  })
};

fetch('https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 1,
    'jsonrpc' => '2.0',
    'method' => 'eth_getBalance',
    'params' => [
        '0x5d20879655df3c1e04ab111af0009ad650e762f0',
        'latest'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/"

	payload := strings.NewReader("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBalance\",\n  \"params\": [\n    \"0x5d20879655df3c1e04ab111af0009ad650e762f0\",\n    \"latest\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBalance\",\n  \"params\": [\n    \"0x5d20879655df3c1e04ab111af0009ad650e762f0\",\n    \"latest\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBalance\",\n  \"params\": [\n    \"0x5d20879655df3c1e04ab111af0009ad650e762f0\",\n    \"latest\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x7e95defb1a447e2c6"
}

POST

eth_getBalance

curl --request POST \
  --url https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x5d20879655df3c1e04ab111af0009ad650e762f0",
    "latest"
  ]
}
'

import requests

url = "https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/"

payload = {
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0x5d20879655df3c1e04ab111af0009ad650e762f0", "latest"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 1,
    jsonrpc: '2.0',
    method: 'eth_getBalance',
    params: ['0x5d20879655df3c1e04ab111af0009ad650e762f0', 'latest']
  })
};

fetch('https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 1,
    'jsonrpc' => '2.0',
    'method' => 'eth_getBalance',
    'params' => [
        '0x5d20879655df3c1e04ab111af0009ad650e762f0',
        'latest'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/"

	payload := strings.NewReader("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBalance\",\n  \"params\": [\n    \"0x5d20879655df3c1e04ab111af0009ad650e762f0\",\n    \"latest\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBalance\",\n  \"params\": [\n    \"0x5d20879655df3c1e04ab111af0009ad650e762f0\",\n    \"latest\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBalance\",\n  \"params\": [\n    \"0x5d20879655df3c1e04ab111af0009ad650e762f0\",\n    \"latest\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x7e95defb1a447e2c6"
}

Arc API method that returns the balance of an account in wei. On Arc the native currency is USDC, which is what pays for gas, so this method returns the account’s spendable gas balance.

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.

Arc’s native currency carries 18 decimals, not the 6 that the USDC ERC-20 token uses. Divide by 10¹⁸, or you will be out by a factor of 10¹². See Arc tooling for the library helpers.

Parameters

address — the address to check the balance for
blockParameter — the block number in hexadecimal, or a tag: latest, earliest, safe, finalized, or pending

Response

result — the account balance in wei, encoded as hexadecimal

Divide the result by 10¹⁸ to get the balance in USDC. ethers.formatEther and web3.from_wei(..., "ether") both apply that conversion, so use them rather than the 6-decimal helpers you would reach for with the USDC ERC-20 token.

`eth_getBalance` code examples

const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

const getBalance = async (address) => {
    const balance = await provider.getBalance(address);
    console.log(`Balance: ${ethers.formatEther(balance)} USDC`);
  };

getBalance("0x19d7CF8eA0CE468417d1edA365a222a9dCBC7D27");

from web3 import Web3

node_url = "CHAINSTACK_NODE_URL"
web3 = Web3(Web3.HTTPProvider(node_url))

address = Web3.to_checksum_address("0x19d7cf8ea0ce468417d1eda365a222a9dcbc7d27")
balance = web3.eth.get_balance(address)
print(f"Balance: {web3.from_wei(balance, 'ether')} USDC")

curl -X POST "CHAINSTACK_NODE_URL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x19d7CF8eA0CE468417d1edA365a222a9dCBC7D27", "latest"], "id": 1}'

web3.py rejects lowercase addresses with InvalidAddress. Wrap any address you did not get from the library itself in Web3.to_checksum_address().

Checking ERC-20 token balances

eth_getBalance only reports the native USDC gas balance. To read an ERC-20 token balance, call the token contract’s balanceOf function with eth_call and apply that token’s own decimals.

Body

application/json

integer

default:1

jsonrpc

string

default:2.0

method

string

default:eth_getBalance

params

array

Response

200 - application/json

Returns the result of eth_getBalance.

jsonrpc

string

integer

result

string

Last modified on September 16, 2026

APIs introduction

Node APIs

Faucet API

Chainstack platform API

eth_getBalance | Arc

Parameters

Response

`eth_getBalance` code examples

Checking ERC-20 token balances

Body

Response

​Parameters

​Response

​eth_getBalance code examples

​Checking ERC-20 token balances

Body

Response

Parameters

Response

`eth_getBalance` code examples

Checking ERC-20 token balances