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

GET
/v1/cefi/orders/status/{ref_id}

Fetches the current status of a specific order identified by ref_id.

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.

Path Parameters

ref_id*string

ID of order to status. For id_type=exchange (default): positive integer. For id_type=client: 1-18 char ASCII string or 36-char UUID.

Match^(?!^0$)[a-zA-Z0-9-]+$
Length1 <= length

Query Parameters

id_type?string

Type of ID the ref_id is, must be either 'client' or 'exchange'. If omitted will default to 'exchange'

Value in"client""exchange"

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/orders/status/123456789' \  -H 'x-truex-auth-timestamp: string'
Example Response
[  {    "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"  }]