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

GET
/v1/cefi/balances/activity

Query balance update activity (settlements and adjustments) for a specific client and/or asset. Returns only balance update messages, ordered by timestamp.

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

client_id?string

Exchange generated client ID to filter activity for.

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

Exchange generated asset ID to filter activity for.

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

Number of records to skip for pagination.

Range0 <= value
Default0
size?integer

Maximum number of records to return.

Range1 <= value <= 100
Default10

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/activity' \  -H 'x-truex-auth-timestamp: string'
Example Response
[  {    "msg_type": "UPDATE",    "msg_action": "ACCEPT",    "amount": "100.50",    "client_id": "78901985055342602",    "asset_id": "78901985048264711",    "type": "TRADE_SETTLEMENT",    "timestamp": "1752159930192000004",    "ownership": {      "client_id": "string"    }  }]