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

# Obtener la dirección de depósito cripto

> Obtén la dirección de depósito on-chain de un token y una red blockchain específicos para la billetera de un comercio, incluidos los requisitos de confirmación.

Usa este endpoint para obtener la dirección de depósito on-chain de una criptomoneda y una red específicas. Debes proporcionar tanto un `tokenId` como un `chainType` de las combinaciones admitidas que se indican abajo. La respuesta incluye la dirección de depósito, el tag de dirección requerido si aplica (por ejemplo, para XRP o EOS), el monto mínimo de depósito y los requisitos de confirmación.

> [!NOTE]
>
> Todas las solicitudes deben incluir el header `X-BH-TOKEN` con un token de negocio obtenido de `GET /v2/token/generate`.

## Endpoint

`GET https://api.velafi.com/v2/assets/depositAddress`

## Parámetros de consulta

**tokenId** `string` *required*

Símbolo del token que se va a depositar. Valores admitidos: `USDT`, `USDC`, `BTC`, `COPM`, `BRL1`, `MXNB`, `MMXN`.

**chainType** `string` *required*

Identificador de la red blockchain. Debe ser una combinación válida para el `tokenId` seleccionado. Consulta la tabla de combinaciones admitidas más abajo.

**merchantId** `integer` *required*

ID del comercio cuya dirección de depósito quieres obtener.

## Combinaciones de token y red admitidas

| tokenId | chainType | Red |
| - | - | - |
| `USDT` | `TRC20` | Tron |
| `USDT` | `ERC20` | Ethereum |
| `USDT` | `BEP20` | BNB Smart Chain |
| `USDT` | `POL` | Polygon |
| `USDT` | `SPL20` | Solana Mainnet |
| `USDC` | `ERC20` | Ethereum |
| `USDC` | `POL` | Polygon |
| `USDC` | `SPL20` | Solana Mainnet |
| `BTC` | `BTC` | Bitcoin |
| `COPM` | `POL` | Polygon (POS) |
| `BRL1` | `POL` | Polygon (POS) |
| `MXNB` | `Arbitrum` | Arbitrum Network |
| `MMXN` | `ERC20` | Ethereum (ERC20) |
| `MMXN` | `TRC20` | TRON (TRC20) |

## Campos de la respuesta

**code** `number`

Código de respuesta de estilo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, por ejemplo `SUCCESS`.

**data** `object`

**campos de data**

**allowDeposit** `boolean`

Indica si los depósitos están habilitados actualmente para esta dirección.

**address** `string`

La dirección de depósito on-chain.

**addressExt** `string`

Tag o memo de la dirección (obligatorio para algunos tokens). Cadena vacía si no se necesita.

**minQuantity** `string`

Monto mínimo de depósito para este token.

**needAddressTag** `boolean`

Indica si se debe incluir un tag de dirección en la transacción de depósito.

**requiredConfirmNum** `number`

Número de confirmaciones on-chain necesarias antes de que se acredite el depósito.

**canWithdrawConfirmNum** `number`

Número de confirmaciones on-chain necesarias antes de que los fondos depositados se puedan retirar.

**tokenType** `string`

Identificador interno del tipo de token.

## Ejemplo

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/assets/depositAddress \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "tokenId=USDT" \
  --data-urlencode "chainType=TRC20" \
  --data-urlencode "merchantId=12345"
```

```json Respuesta theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "allowDeposit": true,
    "address": "YOUR_DEPOSIT_ADDRESS",
    "addressExt": "",
    "minQuantity": "5",
    "needAddressTag": false,
    "requiredConfirmNum": 12,
    "canWithdrawConfirmNum": 20,
    "tokenType": "TRX_TOKEN"
  }
}
```

> [!WARNING]
>
> Revisa siempre `allowDeposit` antes de mostrar la dirección a los usuarios. Si `allowDeposit` es `false`, es posible que los fondos enviados a esta dirección no se acrediten. Contacta al soporte de VelaFi si el indicador sigue en `false` de forma inesperada.


## Related topics

- [Off-ramp (cripto a fiat)](https://docs.velafi.com/es/docs/guides/off-ramp.md)
- [Listar depósitos cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/get-crypto-deposit-history.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Evento de retiro cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md)
- [Agregar una dirección a la lista blanca](https://docs.velafi.com/es/api-reference/crypto-wallet/add-whitelist-address.md)


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