For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/list-balances.md.

List balances

Organization tokenNo token

GET
/balances/unified

Returns unified balances across CeFi and DeFi for the authenticated user

Authorization

bearerAuth
headerAuthorizationBearer <JWT>

An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.

Header Parameters

TM-On-Behalf-Of?string

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.

Formatuuid

Response Body

Balances retrieved successfully

application/json
  1. response

Unified balances across CeFi and DeFi venues

data?array<>

List of asset balances

Example Request
curl -X GET 'https://api.truemarkets.co/v1/gateway/balances/unified' \  -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'
Example Response
{  "data": [    {      "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",      "economic_asset_id": "7f93aecf-1e3c-4189-b692-a8b4a0ef8e5b",      "venue": "defi",      "symbol": "string",      "name": "string",      "chain": "string",      "address": "string",      "decimals": 0,      "total": "string",      "available": "string",      "held": "string",      "allocated": "string",      "stable": true,      "tradeable": true    }  ]}