# eth_getBalance - Etherlink RPC Method

Returns the balance of a given address on Etherlink.

## When to Use This Method

Read the demonstrated account balance at block 1,000,000. The response is denominated in wei.

## Request Parameters

- `address` (`DATA, required`): 20-byte account or contract address.
- `blockNumber` (`QUANTITY, required`): Block number in hexadecimal. The example uses the recorded historical height.

## Request Example

```json
{
  "jsonrpc": "2.0",
  "id": 19,
  "method": "eth_getBalance",
  "params": [
    "0x5d66ec78664f4a0b0929a41270316a6cd4d8bd4b",
    "0xf4240"
  ]
}
```

## Response Fields

This method returns no documented fields.

## Successful Response

```json
{
  "jsonrpc": "2.0",
  "result": "0x7200434edcab2b200",
  "id": 19
}
```

## Best Practices

Keep the recorded block height and address together when reproducing a historical example. Preserve RPC errors instead of replacing them with empty results.

## Code Examples

```bash
curl -X POST "https://api-etherlink-mainnet.n.dwellir.com/YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"jsonrpc":"2.0","id":19,"method":"eth_getBalance","params":["0x5d66ec78664f4a0b0929a41270316a6cd4d8bd4b","0xf4240"]}'
```