For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/institutional/get-balance-activity-cefi.md.
Get balance activity
Query balance update activity (settlements and adjustments) for a specific client and/or asset. Returns only balance update messages, ordered by timestamp.
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.
client_id?stringExchange generated client ID to filter activity for.
^[1-9][0-9]*$1 <= lengthasset_id?stringExchange generated asset ID to filter activity for.
^[1-9][0-9]*$1 <= lengthskip?integerNumber of records to skip for pagination.
0 <= value0size?integerMaximum number of records to return.
1 <= value <= 10010x-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/activity' \ -H 'x-truex-auth-timestamp: string'[ { "msg_type": "UPDATE", "msg_action": "ACCEPT", "amount": "100.50", "client_id": "78901985055342602", "asset_id": "78901985048264711", "type": "TRADE_SETTLEMENT", "timestamp": "1752159930192000004", "ownership": { "client_id": "string" } }]