# Ethereum eth_getBalance RPC method

Ethereum API method that returns the balance of a given account address. The value is returned in Wei.

Parameters:

  • address — the address to check the balance of.
  • quantity or tag — the integer block number, or the string with:
    • latest — the latest block that is to be validated. The Beacon Chain may reorg and the latest block can become orphaned.
    • safe — the block that is equal to the tip of the chain and is very unlikely to be orphaned.
    • finalized — the block that is accepted by the two thirds of the Ethereum validators.
    • earliest — the genesis block.
    • pending — the pending state and transactions block.

Returns:

  • quantity — the integer value of the current balance in Wei.

Example:

Information

cURL needs a HEX String starting with 0x to identify the block if you want to use a hex integer block number as a parameter. For example, block number 14000000 will be 0xD59F80.

  • web3.js
  • web3.py
  • eth.rb
  • cURL
const Web3 = require("web3");
const node_url = "CHAINSTACK_NODE_URL";
const web3 = new Web3(node_url);
web3.eth.getBalance("0x9D00f1630b5B18a74231477B7d7244f47138ab47", "latest", (err, balance) => {
    console.log(balance)
})