EVM

Archive

eth_getBalance

Summary: Get balance of an account

This request returns the balance in wei of the given account address/condition.

Parameters

address string

required

A string that represents a 20-byte Linea address to check the balance of.

Pattern: ^0x[0-9a-fA-F]{40}$

---

block anyOf

required

Block number, block hash, or string tag.

Block number string

Block number in hexadecimal.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Block tag enum

See the default block parameter.

• earliest: The lowest numbered block the client has available.
• finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination.
• latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
• pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool.

Enum:

"earliest"

"finalized"

"latest"

"pending"

Block hash string

32 byte hex value.

Pattern: ^0x[0-9a-f]{64}$

Returns

The balance in wei, as a hexadecimal value.

eth_getBalanceResponse object

balance string

Hex-encoded unsigned integer.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Customize request

Parameter

Value

address

string

block

anyOf

• Block number
• Block tag
• Block hash

Request

curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": [],
    "id": 1
  }'

Example response

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