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

Get balance

GET
/v1/cefi/balances

Query for balance information current allocated to the exchange.

Authorization

JWT
headerAuthorizationBearer <JWT>

Present a True Markets-issued JWT access token as Authorization: Bearer <token>, together with x-truex-auth-timestamp (current Unix seconds, which guards against replays). No request signing is required.

Obtain a token pair by exchanging a signed challenge for your registered ES256 (EC P-256) API key at POST /v1/auth/api-key/token (see the Auth API); the same token is issued by the standard sign-in flows.

The token must carry a client_id claim, which scopes every request to your CeFi client. The claim is present only once your account is enabled for CeFi trading; a JWT without a client_id claim is rejected with 401 Unauthorized.

Query Parameters

asset_id?string

ID of asset to query balance information for.

Match^[1-9][0-9]*$
Length1 <= length
asset_name?string

Name of asset to query balance information for. ASCII alphanumeric only.

Match^[a-zA-Z0-9_-]+$
Length1 <= length
client_id?string

Exchange generated client ID to query balance information for.

Match^[1-9][0-9]*$
Length1 <= length

Header Parameters

x-truex-auth-timestamp*string

Timestamp when request was made in seconds since epoch. Must be no older than 15 seconds and no more than 1 second in the future. It guards against replayed requests.

Response Body

Successful operation.

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.truex.co/v1/cefi/balances' \  -H 'x-truex-auth-timestamp: string'
Example Response
[  {    "id": "78901985055342602",    "status": "INVALID",    "unsettled_fees": "9210.236229375",    "fees_hold": "179300.4249165",    "balances": [      {        "asset_id": "78901985048264711",        "balance": "10000000.45",        "unsettled": "0",        "order_hold": "3586008.49833",        "transfer_hold": "100.00",        "state": "OPEN"      }    ]  }]