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

# Agregar una dirección a la lista blanca

> Agrega una dirección de destino a tu lista blanca de direcciones de retiro de cripto. Los retiros por API solo pueden ir a direcciones de la lista blanca.

Los retiros de cripto por API solo pueden ir a direcciones de tu lista blanca de direcciones de retiro. Usa este endpoint para agregar una dirección para un token y una red específicos. Las entradas de la lista blanca pertenecen a tu usuario de API, así que aplican a todos los comercios bajo él.

> [!NOTE]
>
> Todas las solicitudes deben incluir el encabezado `X-BH-TOKEN` con un token de acceso y `Content-Type: application/json`. Consulta [Autenticación](https://docs.velafi.com/es/api-reference/authentication.md).

## Endpoint

`POST https://api.velafi.com/v2/user/whitelistAddress`

## Parámetros de la solicitud

**crypto** `string` *required*

Símbolo del token, por ejemplo `USDT`. Debe ser un token habilitado actualmente en VelaFi.

**chainType** `string` *required*

Nombre de la red, por ejemplo `TRC20`. Usa un `chainType` devuelto por [Consultar cuota de retiro](https://docs.velafi.com/es/api-reference/crypto-wallet/get-withdrawal-quota.md).

**address** `string` *required*

Dirección de destino. Debe ser una dirección válida para la red. De lo contrario, la solicitud se rechaza.

**addressTag** `string`

Memo o etiqueta, para las redes que lo usan. Los retiros a esta entrada deben usar el mismo `addressTag`.

**remark** `string`

Tu etiqueta para esta dirección.

Agregar una dirección que ya está en tu lista blanca con los mismos `crypto`, `chainType`, `address` y `addressTag` se rechaza como duplicado.

## Campos de la respuesta

**code** `number`

`200` indica éxito.

**msg** `string`

`SUCCESS` en caso de éxito.

**data** `object`

**campos de data**

**addressId** `number`

ID de la entrada de la lista blanca. Úsalo para eliminar la entrada.

**crypto** `string`

Símbolo del token.

**chainType** `string`

Nombre de la red.

**address** `string`

Dirección en la lista blanca.

**addressTag** `string`

Memo o etiqueta. Cadena vacía si no hay.

**remark** `string`

Tu etiqueta para esta dirección.

## Ejemplo

```bash cURL theme={null}
curl -X POST https://api.velafi.com/v2/user/whitelistAddress \
  -H "X-BH-TOKEN: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "crypto": "USDT",
    "chainType": "TRC20",
    "address": "YOUR_DESTINATION_ADDRESS",
    "remark": "Treasury wallet"
  }'
```


## Related topics

- [Eliminar una dirección de la lista blanca](https://docs.velafi.com/es/api-reference/crypto-wallet/delete-whitelist-address.md)
- [Autenticación](https://docs.velafi.com/es/api-reference/authentication.md)
- [Crear una clave de API](https://docs.velafi.com/es/docs/guides/creating-api-key.md)
- [Listar direcciones de la lista blanca](https://docs.velafi.com/es/api-reference/crypto-wallet/get-whitelist-addresses.md)
- [Generar un token](https://docs.velafi.com/es/api-reference/generate-token.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.