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

Create order

POST
/v1/cefi/orders

Create a new order for a specific instrument.

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.

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.

Request Body

Order new request context.

application/json
  1. body
external_id?string

A unique identifier created by the client. Must be in one of the following formats:

  • UUID version 4 in its human readable form, with hypens, and in lowercase.
  • ASCII character string of up to 18 characters containing only the unreserved URL characters: letters (a–z, A–Z), digits (0–9), hyphen (-), underscore (_), period (.), and tilde (~).
info*

Response Body

Successful operation.

application/json
  1. response
id?string
status?string

The current status of the order.

  • INITIALIZED Order has been created, but not sent yet.
  • NEW_PENDING Order has been sent, but not confirmed by the exchange or downstream process.
  • REJECTED An order setting or market condition prevents the order from getting processed.
  • ACTIVE The order was accepted by the system and open to trading (order and market conditions permitting).
  • FILLED The entire order traded.
  • CANCEL_PENDING Indicates a cancel request was received and being processed.
  • CANCELED The order was canceled from a cancel request, order conditions, or market conditions.
  • MODIFY_PENDING Indicates a modification request was received and being processed.
Value in"INITIALIZED""NEW_PENDING""REJECTED""ACTIVE""FILLED""CANCEL_PENDING""CANCELED""MODIFY_PENDING"
order_info?
modify_info?
external_id?string

A unique identifier created by the client. Must be in one of the following formats:

  • UUID version 4 in its human readable form, with hypens, and in lowercase.
  • ASCII character string of up to 18 characters containing only the unreserved URL characters: letters (a–z, A–Z), digits (0–9), hyphen (-), underscore (_), period (.), and tilde (~).
ref_external_id?string

A unique identifier created by the client. Must be in one of the following formats:

  • UUID version 4 in its human readable form, with hypens, and in lowercase.
  • ASCII character string of up to 18 characters containing only the unreserved URL characters: letters (a–z, A–Z), digits (0–9), hyphen (-), underscore (_), period (.), and tilde (~).
pending_qty?string

Order quantity that has been acknowledge by the exchange but is not yet trading.

leaves_qty?string

Order quantity that is currently active in the market.

executed_qty?string

Amount of quantity currently executed.

executed_vwap?string

Volume weighted average price calculation for all executions on the order.

Example Request
curl -X POST 'https://api.truex.co/v1/cefi/orders' \  -H 'x-truex-auth-timestamp: string' \  -H 'Content-Type: application/json' \  -d '{  "info": {    "client_id": "78901949710204932",    "instrument_id": "78901949723181070",    "qty": "0.00145",    "price": "111067",    "side": "BUY",    "type": "LIMIT"  }}'
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"}