Begins the cancellation process of an existing active order from the exchange. N.B. it is still possible to receive trades on the order that is being canceled.
APIs
/- CeFi
- REST
/
All orders
TrueX REST API (v1.0.3)
This API allows clients to interact with the TrueX trading platform for order management, market data retrieval, and account information.
Certain API requests must be authenticated using HMAC-SHA256 signature authentication.
The API uses date-based versioning via the X-Truex-Version header. To request a specific API version, include the header in your request:
X-Truex-Version: v2024_01_01Supported Versions:
| Version | Status | Description |
|---|---|---|
v2024_01_01 | Current (Default) | Original API format - responses return raw data arrays/objects |
v2026_01_23 | Current | New envelope format - responses wrapped in { "data": [...], "pagination": {...} } |
If no version header is provided, the API defaults to v2024_01_01. Use the /api/v1/versions endpoint to discover supported versions programmatically.
Response Format by Version:
- v2024_01_01:
[{...}, {...}](raw array) or{...}(raw object) - v2026_01_23:
{ "data": [...], "pagination": { "limit": 10, "next_cursor": "..." } }
Error Response Format by Version:
- v2024_01_01: RFC 7807 Problem Details format
- v2026_01_23:
{ "error": { ...RFC 7807 Problem Details... } }
Deprecation Policy: When a version is deprecated, responses will include RFC 8594 headers:
Deprecation: Date when the version was deprecatedSunset: Date when the version will be removed
- 📖 Full API Documentation: https://docs.truex.co/
- 📧 Support: support@truex.co
Overview
Languages
Servers
Mock server
https://docs.truemarkets.co/_mock/apis/cefi/rest/v1/
https://prod.truex.co/
- Mock server
https://docs.truemarkets.co/_mock/apis/cefi/rest/v1/api/v1/orders/{ref_id}
https://prod.truex.co/api/v1/orders/{ref_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.truemarkets.co/_mock/apis/cefi/rest/v1/api/v1/orders/{ref_id}?id_type=client' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-truex-auth-signature: string' \
-H 'x-truex-auth-timestamp: string' \
-H 'x-truex-auth-token: string' \
-H 'x-truex-auth-userid: string'Successful operation.
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.
Enum"INITIALIZED""NEW_PENDING""REJECTED""ACTIVE""FILLED""CANCEL_PENDING""CANCELED""MODIFY_PENDING"
Example: "ACTIVE"
A unique identifier created by the client. Must be in one the follower 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 (~).
Example: "EXT-ORDER-123"
A unique identifier created by the client. Must be in one the follower 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 (~).
Example: "REF-EXT-ORDER-123"
Order quantity that has been acknowledge by the exchange but is not yet trading.
Example: "0"
Response
application/json
{ "id": "799477895858487977", "status": "ACTIVE", "order_info": { "msg_id": "799477895858487977", "parent_id": "432351810263056385", "client_id": "78901949710204932", "instrument_id": "78901949723181070", "qty": "0.00145", "price": "111067", "flags": [ … ], "side": "BUY", "type": "LIMIT", "tif": "GTC", "exec_inst_flags": [ … ], "hold_fee_rate": "0.002", "stp": "NONE" }, "modify_info": { "msg_id": "0", "parent_id": "0", "client_id": "0", "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", "exeuted_qty": "0.00239", "executed_vwap": "111050.5" }
- Mock server
https://docs.truemarkets.co/_mock/apis/cefi/rest/v1/api/v1/orders/list
https://prod.truex.co/api/v1/orders/list
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.truemarkets.co/_mock/apis/cefi/rest/v1/api/v1/orders/list?query=string&skip=0&size=10' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-truex-auth-signature: string' \
-H 'x-truex-auth-timestamp: string' \
-H 'x-truex-auth-token: string' \
-H 'x-truex-auth-userid: string'Successful operation.
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.
Enum"INITIALIZED""NEW_PENDING""REJECTED""ACTIVE""FILLED""CANCEL_PENDING""CANCELED""MODIFY_PENDING"
Example: "ACTIVE"
A unique identifier created by the client. Must be in one the follower 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 (~).
Example: "EXT-ORDER-123"
A unique identifier created by the client. Must be in one the follower 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 (~).
Example: "REF-EXT-ORDER-123"
Order quantity that has been acknowledge by the exchange but is not yet trading.
Example: "0"
Volume weighted average price calculation for all executions on the order.
Example: "111050.5"
UNIX UTC nanosecond timestamp of when the order was created.
Example: "1752159930164131767"
UNIX UTC nanosecond timestamp of when the order was last updated.
Example: "1752159930192000004"
Response
application/json
[ { "id": "799477895858487977", "status": "ACTIVE", "order_info": { … }, "modify_info": { … }, "external_id": "EXT-ORDER-123", "ref_external_id": "REF-EXT-ORDER-123", "pending_qty": "0", "leaves_qty": "0.00145", "exeuted_qty": "0.00239", "executed_vwap": "111050.5", "total": "3500000", "timestamp": "1752159930164131767", "update_timestamp": "1752159930192000004" } ]
- Mock server
https://docs.truemarkets.co/_mock/apis/cefi/rest/v1/api/v1/orders/active
https://prod.truex.co/api/v1/orders/active
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.truemarkets.co/_mock/apis/cefi/rest/v1/api/v1/orders/active?id=string' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-truex-auth-signature: string' \
-H 'x-truex-auth-timestamp: string' \
-H 'x-truex-auth-token: string' \
-H 'x-truex-auth-userid: string'Successful operation.
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.
Enum"INITIALIZED""NEW_PENDING""REJECTED""ACTIVE""FILLED""CANCEL_PENDING""CANCELED""MODIFY_PENDING"
Example: "ACTIVE"
A unique identifier created by the client. Must be in one the follower 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 (~).
Example: "EXT-ORDER-123"
A unique identifier created by the client. Must be in one the follower 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 (~).
Example: "REF-EXT-ORDER-123"
Order quantity that has been acknowledge by the exchange but is not yet trading.
Example: "0"
Volume weighted average price calculation for all executions on the order.
Example: "111050.5"
Response
application/json
[ { "id": "799477895858487977", "status": "ACTIVE", "order_info": { … }, "modify_info": { … }, "external_id": "EXT-ORDER-123", "ref_external_id": "REF-EXT-ORDER-123", "pending_qty": "0", "leaves_qty": "0.00145", "exeuted_qty": "0.00239", "executed_vwap": "111050.5" } ]