eth_getBalance - Ethereum RPC method documentation

Chain

eth_getBalance RPC Method

The API credit value for this method is 2 . To learn more about API credits and each method's value, visit the API Credits page.

Parameters:

address - string - The address (20 bytes) to check for balance
blockNumber/tag - string - The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized (safe and finalized tags are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova and Avalanche C-chain), see the default block parameter description in the official Ethereum documentation

Returns:

result - The ETH balance of the specified address in hexadecimal value, measured in wei

Code Examples:

ethers
javascript
eth.rb
ruby
python
curl
web3py

const ethers = require("ethers");
(async () => {
  const provider = new ethers.providers.JsonRpcProvider("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/");
  const balance = await provider.getBalance(
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
    "latest"
  );
  console.log(balance);
})();

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "method": "eth_getBalance",
  "params": [
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
    "latest"
  ],
  "id": 1,
  "jsonrpc": "2.0"
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

require 'ethereum.rb'
client = Ethereum::HttpClient.new('http://sample-endpoint-name.network.quiknode.pro/token-goes-here/')
balance = client.get_balance('0x8D97689C9818892B700e27F316cc3E41e17fBeb9','latest')
puts balance

require "uri"
require "json"
require "net/http"

url = URI("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/")

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

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

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

import requests
import json

url = "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/"

payload = json.dumps({
  "method": "eth_getBalance",
  "params": [
    "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
    "latest"
  ],
  "id": 1,
  "jsonrpc": "2.0"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

curl http://sample-endpoint-name.network.quiknode.pro/token-goes-here/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBalance","params":["0x8D97689C9818892B700e27F316cc3E41e17fBeb9", "latest"],"id":1,"jsonrpc":"2.0"}'

from web3 import Web3, HTTPProvider
w3 = Web3(HTTPProvider('http://sample-endpoint-name.network.quiknode.pro/token-goes-here/'))
print (w3.eth.get_balance('0x8D97689C9818892B700e27F316cc3E41e17fBeb9', 'latest'))

Ready to get started? Create a free account

Eth Get Balance

Contents

eth_getBalance RPC Method