> ## 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.

# API de Direcciones

> Genera y gestiona direcciones secundarias para tus usuarios.

La API de Direcciones te permite generar direcciones de depósito dedicadas para cada uno de tus usuarios. Cada dirección es hija de tu billetera maestra y hereda su configuración de red y activos.

## Qué puedes hacer

* Generar una nueva dirección de depósito para un usuario
* Consultar detalles de dirección, saldos e historial de transacciones
* Actualizar metadatos de la dirección
* Agregar o quitar direcciones de la lista blanca para retiros

## Conceptos clave

**Una dirección por usuario.** Nunca reutilices direcciones entre usuarios. Cada dirección debe asignarse permanentemente a un solo usuario para que los depósitos puedan atribuirse correctamente.

**Compatibilidad EVM.** En cadenas compatibles con EVM, una sola dirección funciona en todas las redes EVM soportadas.

## Endpoints

| Method   | Endpoint                                                 | Description                         |
| -------- | -------------------------------------------------------- | ----------------------------------- |
| `GET`    | `/wallets/{walletId}/addresses`                          | Listar todas las direcciones        |
| `POST`   | `/wallets/{walletId}/addresses`                          | Generar una nueva dirección         |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}`              | Obtener detalles de dirección       |
| `PATCH`  | `/wallets/{walletId}/addresses/{addressId}`              | Actualizar metadatos de dirección   |
| `POST`   | `/wallets/{walletId}/addresses/{addressId}/whitelist`    | Agregar dirección a la lista blanca |
| `DELETE` | `/wallets/{walletId}/addresses/{addressId}/whitelist`    | Quitar dirección de la lista blanca |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/balance`      | Obtener saldo de un activo          |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/balances`     | Obtener saldos de todos los activos |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/transactions` | Listar transacciones                |

<Card title="Referencia completa de la API" icon="book" href="/es/api-reference/addresses/get-addresses">
  Consulta todos los endpoints de direcciones en la pestaña de Referencia de la API.
</Card>
