Alchemy Logo

eth_getBalance

POST
/{apiKey}

Returns the balance of the account of a given address.

Path Parameters

apiKeystringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

Addressstringformat: "^0x[0-9a-fA-F]{40}$"required

The address of the account to query the balance for.

Blockstring or enumrequired

The block number, tag, or hash at which to retrieve the balance. Can be a block number, 'latest', 'earliest', 'pending', or a block hash.

Identifies a block by explicit number, a predefined tag (e.g., latest/safe/finalized), or a 32-byte block hash.

Responses

200

The balance of the account in wei, encoded as a hexadecimal string.

Was this page helpful?