---
title: "List balances"
url: https://docs.truemarkets.co/api/gateway/list-balances
description: "Returns unified balances across CeFi and DeFi for the authenticated user"
---

Docs index: https://docs.truemarkets.co/llms.txt

# List balances

Returns unified balances across CeFi and DeFi for the authenticated user

## Request

```
GET https://api.truemarkets.co/v1/gateway/balances/unified
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `TM-On-Behalf-Of` | header | string (uuid) | no | Act as one of your organization's users. The value is the `user_id` returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: `400` for a personal token, a repeated header or a non-UUID, `403` for a user outside your organization. Not accepted on organization-scoped routes. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Balances retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of object | no | List of asset balances |
| `data[].asset_id` | string (uuid) | no | Unique asset identifier; pass as `asset_id` when creating an order. Empty when the asset is not in the catalog. |
| `data[].economic_asset_id` | string (uuid) | no | Economic asset this listing belongs to, shared across venues and chains. Omitted when the asset is not in the catalog. |
| `data[].venue` | string, one of `defi`, `cefi` | no | The trading venue to filter by. * **defi** — Decentralized exchange (on-chain swaps). * **cefi** — Centralized exchange (off-chain order book). |
| `data[].symbol` | string | no | Asset ticker symbol (e.g. BTC, USDC) |
| `data[].name` | string | no | Human-readable asset name |
| `data[].chain` | string, nullable | no | Blockchain network ("solana", "base"), or null for exchange-held assets |
| `data[].address` | string, nullable | no | Token contract/mint address, or null for exchange-held assets |
| `data[].decimals` | integer | no | Display precision (e.g. 8 for BTC, 6 for USDC) |
| `data[].total` | string | no | Gross balance including held amounts (decimal string) |
| `data[].available` | string | no | Usable balance after holds (decimal string) |
| `data[].held` | string | no | Amount locked in orders or transfers (decimal string) |
| `data[].allocated` | string | no | Quantity of a DeFi row committed to CeFi trading (decimal string). `total` and `available` are already net of it, and the CeFi row for the same asset reports it. Zero on CeFi rows. |
| `data[].stable` | boolean | no | Whether this is a stablecoin |
| `data[].tradeable` | boolean | no | Whether this asset is active for trading |

### 400

Bad request

### 401

Unauthorized

### 403

Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.

### 500

Internal server error

### 503

Service unavailable
