> ## 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 el saldo cripto

> Obtén los saldos de la billetera de criptomonedas de un comercio específico u obtén los totales agregados de todos los comercios vinculados a tu clave de API.

Usa este endpoint para consultar los saldos de activos cripto que se guardan en la billetera de custodia de un comercio. Envía un `merchantId` específico para limitar los resultados a un solo comercio, o envía `0` para recibir los totales agregados de todos los comercios vinculados a tu clave de API. Cada activo muestra el saldo total, la parte libre (disponible) y cualquier monto bloqueado (reservado para órdenes pendientes).

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

## Endpoint

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

## Parámetros de consulta

**merchantId** `integer` *required*

El ID del comercio que se va a consultar. Envía `0` para agregar los saldos de todos los comercios vinculados a esta clave de API.

## 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** `object`

**campos de data**

**canDeposit** `boolean`

Indica si la cuenta puede recibir depósitos cripto en este momento.

**balances** `array`

**campos de cada elemento de balances**

**asset** `string`

Símbolo del activo, por ejemplo `USDT`, `BTC`, `USDC`.

**assetId** `string`

Identificador interno del activo.

**assetName** `string`

Nombre legible del activo para mostrar.

**total** `string`

Saldo total que se tiene en este activo.

**free** `string`

Saldo disponible no reservado para órdenes pendientes.

**locked** `string`

Saldo reservado para órdenes abiertas o en curso.

## Ejemplos

> [tab] Comercio específico
>
> ```bash cURL theme={null}
> curl -G https://api.velafi.com/v2/assets/account/assets \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   --data-urlencode "merchantId=12345"
> ```
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "canDeposit": true,
>     "balances": [
>       {
>         "asset": "USDT",
>         "assetId": "USDT",
>         "assetName": "USDT",
>         "total": "1000",
>         "free": "800",
>         "locked": "200"
>       },
>       {
>         "asset": "BTC",
>         "assetId": "BTC",
>         "assetName": "BTC",
>         "total": "0.5",
>         "free": "0.3",
>         "locked": "0.2"
>       }
>     ]
>   }
> }
> ```

> [tab] Agregado (todos los comercios)
>
> ```bash cURL theme={null}
> curl -G https://api.velafi.com/v2/assets/account/assets \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   --data-urlencode "merchantId=0"
> ```
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "canDeposit": true,
>     "balances": [
>       {
>         "asset": "USDT",
>         "assetId": "USDT",
>         "assetName": "USDT",
>         "total": "5000",
>         "free": "4000",
>         "locked": "1000"
>       },
>       {
>         "asset": "BTC",
>         "assetId": "BTC",
>         "assetName": "BTC",
>         "total": "2",
>         "free": "1.5",
>         "locked": "0.5"
>       }
>     ]
>   }
> }
> ```

> [!NOTE]
>
> Cuando `merchantId` es `0`, la API suma los saldos de todos los comercios vinculados a la misma cuenta. Úsalo para obtener una vista a nivel de portafolio sin recorrer uno por uno los IDs de comercio.


## Related topics

- [On-ramp (fiat a cripto)](https://docs.velafi.com/es/docs/guides/on-ramp.md)
- [Evento de retiro cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md)
- [Off-ramp (cripto a fiat)](https://docs.velafi.com/es/docs/guides/off-ramp.md)
- [Crear una orden de off-ramp](https://docs.velafi.com/es/api-reference/order/create-a-crypto-to-fiat-order.md)
- [Crear una transferencia cripto](https://docs.velafi.com/es/api-reference/merchant/crypto-transfer.md)


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