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

# Listar depósitos cripto

> Lista los depósitos de cripto on-chain recibidos en las billeteras de tus comercios en VelaFi, del más reciente al más antiguo, con filtros por token, hash de transacción, comercio y rango de tiempo.

Usa este endpoint para listar los depósitos de cripto recibidos en las billeteras de tus comercios. Los resultados se ordenan del más reciente al más antiguo, y una sola llamada devuelve hasta `pageSize` registros. Para consultar más atrás, acota la ventana con `startTime` y `endTime`.

> [!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/depositOrders`

## Parámetros de consulta

**merchantId** `number`

Filtra por ID del comercio.

**crypto** `string`

Filtra por símbolo del token, por ejemplo `USDT`.

**txId** `string`

Filtra por hash de la transacción on-chain.

**startTime** `number`

Devuelve solo los depósitos creados en este momento o después (marca de tiempo Unix en milisegundos).

**endTime** `number`

Devuelve solo los depósitos creados en este momento o antes (marca de tiempo Unix en milisegundos).

**pageSize** `number` (default: 10)

Número máximo de registros que se devuelven, de `1` a `1000`. El valor predeterminado es `10`.

## Campos de la respuesta

**code** `number`

`200` indica éxito.

**msg** `string`

`SUCCESS` cuando la solicitud es exitosa.

**data** `array`

**campos de cada elemento de data**

**orderId** `number`

ID del registro de depósito.

**merchantId** `number`

Comercio que recibió el depósito.

**time** `number`

Momento en que se creó el registro de depósito (marca de tiempo Unix en milisegundos).

**crypto** `string`

Símbolo del token.

**cryptoName** `string`

Nombre del token. Actualmente es igual a `crypto`.

**cryptoAmount** `string`

Monto depositado.

**address** `string`

Actualmente devuelve el mismo valor que `fromAddress` (la dirección de envío), no tu dirección de depósito de VelaFi.

**addressTag** `string`

Actualmente siempre es una cadena vacía.

**fromAddress** `string`

Dirección de envío.

**fromAddressTag** `string`

Actualmente siempre es una cadena vacía.

**status** `number`

Estado del depósito:

* `1` — en proceso
* `2` — exitoso
* `3` — fallido o cancelado
* `4` — cualquier otro estado

**txId** `string`

Hash de la transacción on-chain.

**txIdUrl** `string`

Enlace al explorador de bloques de la transacción.

## Ejemplo

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/assets/depositOrders \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=151209" \
  --data-urlencode "crypto=USDT" \
  --data-urlencode "pageSize=50"
```


## Related topics

- [Obtener la dirección de depósito cripto](https://docs.velafi.com/es/api-reference/merchant/get-crypto-deposit-address.md)
- [Listar retiros cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/get-crypto-withdrawal-history.md)
- [Listar transferencias cripto](https://docs.velafi.com/es/api-reference/merchant/query-crypto-transfers.md)
- [Listar pares cripto→fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-crypto-fiat-pairs.md)
- [Listar pares fiat→cripto](https://docs.velafi.com/es/api-reference/basic-configuration/get-fiat-crypto-pairs.md)


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