For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/institutional/get-orders-status-cefi.md.
Status order
Fetches the current status of a specific order identified by ref_id.
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.
ref_id*stringID of order to status. For id_type=exchange (default): positive integer. For id_type=client: 1-18 char ASCII string or 36-char UUID.
^(?!^0$)[a-zA-Z0-9-]+$1 <= lengthid_type?stringType of ID the ref_id is, must be either 'client' or 'exchange'. If omitted will default to 'exchange'
"client""exchange"x-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/orders/status/123456789' \ -H 'x-truex-auth-timestamp: string'[ { "id": "799477895858487977", "status": "ACTIVE", "order_info": { "msg_id": "799477895858487977", "parent_id": "432351810263056385", "client_id": "78901949710204932", "instrument_id": "78901949723181070", "qty": "0.00145", "price": "111067", "flags": [ "USE_AGGRESSIVE_PRICING" ], "side": "BUY", "type": "LIMIT", "tif": "GTC", "exec_inst_flags": [ "ALO" ], "hold_fee_bps": "20", "hold_fee_rate": "0.002", "stp": "NONE" }, "modify_info": { "msg_id": "1", "parent_id": "1", "client_id": "1", "prev_modify": "0", "new_qty": "0", "new_price": "0", "new_type": "MARKET" }, "external_id": "EXT-ORDER-123", "ref_external_id": "REF-EXT-ORDER-123", "pending_qty": "0", "leaves_qty": "0.00145", "executed_qty": "0.00239", "executed_vwap": "111050.5", "total": "3500000", "timestamp": "1752159930164131767", "update_timestamp": "1752159930192000004" }]