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

All order trades

GET
/v1/cefi/orders/trade

Fetches all trades for a client executed within the past 24 hours on 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

size?integer

Number of records to return per page. Maximum allowed value is 100.

Range1 <= value <= 100
Default10
skip?integer

Number of records to skip before returning results.

Range0 <= value <= 2147483647
timestamp*string

A Unix UTC timestamp in nanoseconds used as a reference point for fetching trades.

Match^[0-9]{19}$
client_id?string

Comma-separated list of client IDs to filter results. Only returns trades for the specified clients.

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]?

Activity event for a trade execution.

Example Request
curl -X GET 'https://api.truex.co/v1/cefi/orders/trade?timestamp=1741523275598727336' \  -H 'x-truex-auth-timestamp: string'
Example Response
[  {    "client_id": "78975249877368840",    "external_id": "550e8400-e29b-41d4-a716-446655440000",    "instrument_id": "78975249883267118",    "timestamp": "1770919994854735762",    "side": "BUY",    "msg_type": "REPORT_TRADE",    "order_id": "2312760665443598349",    "trade_price": "111480.5",    "trade_qty": "0.06089",    "trade_fee_bps": "5",    "trade_fee_rate": "0.0005",    "liq_flag": "TAKER",    "match_id": "147670564223998146302870408890920992792"  }]