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

Get orders

GET
/v1/cefi/orders

Fetches all orders for a client entered within the past 24 hours on the exchange. A filter can be provided to limit the results.

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. Used for offset-based pagination.

Range0 <= value <= 2147483647
timestamp*string

A Unix UTC timestamp in nanoseconds used as a reference point for fetching orders. The query will retrieve results created before this timestamp, enabling precise time-based filtering and ensuring stable pagination. If omitted, the server responds with 400 BAD REQUEST.

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

Comma-separated list of order statuses to filter by.

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

A single trade execution against an order.

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