> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Addresses API

> Generate and manage child addresses for your users.

The Addresses API lets you generate dedicated deposit addresses for each of your users. Each address is a child of your master wallet and inherits its network and asset configuration.

## What you can do

* Generate a new deposit address for a user
* Retrieve address details, balances, and transaction history
* Update address metadata
* Whitelist or unwhitelist addresses for withdrawal

## Key concepts

**One address per user.** Never reuse addresses across users. Each address should be permanently assigned to one user so deposits can be attributed correctly.

**EVM compatibility.** On EVM-compatible chains, a single address works across all supported EVM networks.

## Endpoints

| Method   | Endpoint                                                 | Description              |
| -------- | -------------------------------------------------------- | ------------------------ |
| `GET`    | `/wallets/{walletId}/addresses`                          | List all addresses       |
| `POST`   | `/wallets/{walletId}/addresses`                          | Generate a new address   |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}`              | Get address details      |
| `PATCH`  | `/wallets/{walletId}/addresses/{addressId}`              | Update address metadata  |
| `POST`   | `/wallets/{walletId}/addresses/{addressId}/whitelist`    | Whitelist an address     |
| `DELETE` | `/wallets/{walletId}/addresses/{addressId}/whitelist`    | Unwhitelist an address   |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/balance`      | Get single asset balance |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/balances`     | Get all asset balances   |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/transactions` | List transactions        |

<Card title="Full API Reference" icon="book" href="/en/api-reference/addresses/get-addresses">
  View all address endpoints in the API Reference tab.
</Card>