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

> Consulta el historial completo de transferencias internas de cripto entre billeteras de comercios, con filtros por símbolo de token, rango de fechas e ID de cliente.

Usa este endpoint para obtener el historial de transferencias internas de cripto en las que participan una o más billeteras de comercios. Cada transferencia completada genera dos registros: un asiento negativo (cargo) del lado del remitente y un asiento positivo (abono) del lado del destinatario. Usa el filtro `merchantId` para limitar los resultados a un solo comercio. Combínalo con el endpoint [Transferencia de cripto](https://docs.velafi.com/es/api-reference/merchant/crypto-transfer.md) para armar un rastro de auditoría completo.

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

## Endpoint

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

## Parámetros de consulta

**merchantId** `number`

Filtra los registros por ID de comercio.

**tokenId** `string`

Filtra por símbolo de token, por ejemplo `USDT`, `BTC`.

**clientId** `string`

Filtra por el identificador de transferencia que proporcionaste.

**startTime** `number`

Inicio del rango de fechas como marca de tiempo Unix en milisegundos.

**endTime** `number`

Fin del rango de fechas como marca de tiempo Unix en milisegundos.

**pageSize** `number`

Número de registros que se devuelven por página.

## Campos de la respuesta

**code** `number`

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

**msg** `string`

Mensaje de estado legible, por ejemplo `SUCCESS`.

**data** `array`

**Campos de cada elemento de data**

**id** `string`

ID único del registro para esta línea de transferencia.

**tokenId** `string`

Símbolo del token de este registro.

**amount** `string`

Monto transferido. Negativo = cargo (remitente), positivo = abono (destinatario).

**clientId** `string`

El identificador de transferencia que proporcionaste.

**merchantId** `string`

ID del comercio al que pertenece este registro.

**fromMerchantId** `string`

ID del comercio remitente.

**toMerchantId** `string`

ID del comercio destinatario.

## Ejemplo

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

```json Respuesta theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": [
    {
      "id": "4355",
      "tokenId": "USDT",
      "amount": "10",
      "clientId": "crypto-transfer-001",
      "merchantId": "61",
      "fromMerchantId": "246",
      "toMerchantId": "61"
    },
    {
      "id": "4354",
      "tokenId": "USDT",
      "amount": "-10",
      "clientId": "crypto-transfer-001",
      "merchantId": "246",
      "fromMerchantId": "246",
      "toMerchantId": "61"
    }
  ]
}
```

> [!NOTE]
>
> Una sola transferencia crea dos registros: uno para el remitente (`amount` negativo) y otro para el destinatario (`amount` positivo). El campo `merchantId` indica desde la perspectiva de qué comercio se presenta cada registro.


## Related topics

- [Listar retiros cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/get-crypto-withdrawal-history.md)
- [Listar depósitos cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/get-crypto-deposit-history.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)
- [Listar métodos de pago cripto→fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-crypto-fiat-payment-methods.md)


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