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
Query for balance information current allocated to the exchange.
JWTAuthorizationBearer <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.
asset_id?stringID of asset to query balance information for.
^[1-9][0-9]*$1 <= lengthasset_name?stringName of asset to query balance information for. ASCII alphanumeric only.
^[a-zA-Z0-9_-]+$1 <= lengthclient_id?stringExchange generated client ID to query balance information for.
^[1-9][0-9]*$1 <= lengthx-truex-auth-timestamp*stringTimestamp 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.
Successful operation.
application/json- response
[index: integer]?curl -X GET 'https://api.truex.co/v1/cefi/balances' \ -H 'x-truex-auth-timestamp: string'[ { "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" } ] }]