> ## 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 retiros cripto

> Lista los retiros de cripto de la billetera de un comercio de VelaFi, del más reciente al más antiguo, filtrados por token, clientId y rango de tiempo.

Usa este endpoint para dar seguimiento a los retiros de cripto desde la billetera de un comercio hacia direcciones externas, incluidos los creados con [Crear retiro de cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/create-crypto-withdrawal.md). Para recibir una notificación cuando un retiro llegue a su estado final, suscríbete al [Evento de retiro de cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md). También puedes consultar periódicamente este endpoint por `clientId` hasta que `status` sea `6`, `7` o `9`, por ejemplo para conciliar retiros cuyo webhook no recibiste. Los reembolsos de pagos con stablecoin de esta lista no disparan el webhook. La lista también puede incluir otros registros de tipo retiro, como pagos masivos. Los retiros a una dirección de billetera de VelaFi se registran como transferencias internas y aparecen en el [Historial de transferencias de cripto](https://docs.velafi.com/es/api-reference/merchant/query-crypto-transfers.md). Los resultados se ordenan del más reciente al más antiguo, y una sola llamada devuelve hasta `pageSize` registros. Para encontrar un retiro específico, filtra por `clientId`.

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

## Parámetros de consulta

**merchantId** `number` *required*

ID del comercio.

**crypto** `string`

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

**clientId** `string`

Filtra por el `clientId` que enviaste al crear el retiro.

**startTime** `number`

Solo devuelve retiros creados en este momento o después (marca de tiempo Unix en milisegundos).

**endTime** `number`

Solo devuelve retiros 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 por defecto es `10`.

## Campos de la respuesta

**code** `number`

`200` indica éxito.

**msg** `string`

`SUCCESS` si la solicitud fue exitosa.

**data** `array`

**Campos de cada elemento de data**

**orderId** `number`

ID del registro de retiro. Coincide con el `orderId` devuelto por Crear retiro de cripto.

**merchantId** `number`

Comercio cuya billetera se debitó.

**time** `number`

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

**crypto** `string`

Símbolo del token.

**cryptoName** `string`

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

**address** `string`

Dirección de destino.

**addressTag** `string`

Memo o tag de destino, si existe.

**cryptoAmount** `string`

Monto del retiro.

**fee** `string`

Comisión de red.

**feeCrypto** `string`

Token en el que se expresa la comisión. Siempre es igual a `crypto`.

**arriveCryptoAmount** `string`

`cryptoAmount` menos `fee`.

**status** `number`

Estado del retiro:

* `5`: en proceso, incluidos los retiros retenidos para la auditoría interna de VelaFi
* `6`: exitoso
* `7`: fallido
* `9`: cancelado
* `0`: cualquier otro estado, por ejemplo mientras el retiro espera la aprobación de una subcuenta o está retenido por una solicitud de información de riesgo (RFI)

**txId** `string`

Hash de la transacción on-chain, cuando esté disponible.

**txIdUrl** `string`

Link al explorador de bloques de la transacción.

**remark** `string`

El `remark` que enviaste al crear el retiro.

## Ejemplo

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/assets/withdrawalOrders \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=151209" \
  --data-urlencode "clientId=withdraw-0001"
```


## Related topics

- [Crear un retiro cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/create-crypto-withdrawal.md)
- [Evento de retiro cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md)
- [Listar depósitos cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/get-crypto-deposit-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)


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