Orders
Get Order
Retrieve one order with its book and its fills
GET
/
orderbooks
/
external-securities
/
api
/
orders
/
{orderId}
curl "https://api.trusset.org/orderbooks/external-securities/api/orders/c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/orders/${orderId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.status, data.remainingQuantity, data.expiresAt);
{
"success": true,
"data": {
"id": "clx_order_812",
"orderId": "c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320",
"orderBookId": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"accountId": "clx_acct_12",
"side": "BUY",
"orderType": "LIMIT",
"price": "104200000",
"quantity": "10000000",
"filledQuantity": "4000000",
"remainingQuantity": "6000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"postOnly": false,
"selfTradePreventionMode": "NONE",
"lockId": "clx_lock_204",
"cancelReason": null,
"expiresAt": "2025-06-22T12:00:00.000Z",
"auctionId": null,
"createdAt": "2025-06-15T12:00:00.000Z",
"updatedAt": "2025-06-15T12:03:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG", "status": "ACTIVE" },
"makerTrades": [],
"takerTrades": [
{
"tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
"price": "104200000",
"quantity": "4000000",
"makerFee": "0",
"takerFee": "4000",
"side": "BUY",
"origin": "CLOB",
"settlementStatus": "CONFIRMED",
"createdAt": "2025-06-15T12:03:00.000Z"
}
]
}
}
Returns a single order, the book it sits on, and every trade it took part in on either side. Resolves only if the order’s book is an external securities book your instance owns or has imported.
expiresAt is the deadline from the signed order. Past it the signature can no longer settle, even though the row may still read OPEN until a sweeper or an incoming order retires it.
Path Parameters
string
required
The order’s
orderId.Response Fields
object
Show child attributes
Show child attributes
string
Internal row ID.
string
Public order ID.
string
Book the order sits on.
string
Instance that submitted the order.
string
Trader’s wallet, lower-cased.
string
Trading account, or
null.string
BUY or SELL.string
LIMIT.string
Limit price in order book units.
string
Original quantity in order book units.
string
Quantity filled so far.
string
Quantity still working.
string
OPEN, PARTIALLY_FILLED, FILLED, CANCELLED, EXPIRED or REJECTED.string
GTC, IOC or FOK.boolean
Whether the order refused to take.
string
Self-trade policy in force.
string
Reservation backing the order, or
null once released.string
Why the order closed, or
null. Beyond USER_CANCELLED this can name a chain-side retirement: cancelled on chain, nonce invalidated, or filled on chain.string
Deadline from the signed order, as ISO 8601.
string
null on this venue.string
ISO 8601 timestamp.
string
ISO 8601 timestamp.
object
The full order book record. See Get Order Book.
array
Trades where this order was the resting side.
array
Trades where this order was the aggressing side.
The signed struct behind the order, meaning its hash, signature, nonce and salt, is not returned here. Keep the
orderHash from Submit Order if you need to reconcile against the chain.curl "https://api.trusset.org/orderbooks/external-securities/api/orders/c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/orders/${orderId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.status, data.remainingQuantity, data.expiresAt);
{
"success": true,
"data": {
"id": "clx_order_812",
"orderId": "c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320",
"orderBookId": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"accountId": "clx_acct_12",
"side": "BUY",
"orderType": "LIMIT",
"price": "104200000",
"quantity": "10000000",
"filledQuantity": "4000000",
"remainingQuantity": "6000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"postOnly": false,
"selfTradePreventionMode": "NONE",
"lockId": "clx_lock_204",
"cancelReason": null,
"expiresAt": "2025-06-22T12:00:00.000Z",
"auctionId": null,
"createdAt": "2025-06-15T12:00:00.000Z",
"updatedAt": "2025-06-15T12:03:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG", "status": "ACTIVE" },
"makerTrades": [],
"takerTrades": [
{
"tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
"price": "104200000",
"quantity": "4000000",
"makerFee": "0",
"takerFee": "4000",
"side": "BUY",
"origin": "CLOB",
"settlementStatus": "CONFIRMED",
"createdAt": "2025-06-15T12:03:00.000Z"
}
]
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
ORDER_NOT_FOUND | 404 | No order with that ID, or its book is not reachable from your instance |
SERVICE_NOT_ENABLED | 403 | The Trading service is not enabled on this instance |
⌘I
curl "https://api.trusset.org/orderbooks/external-securities/api/orders/c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/orders/${orderId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.status, data.remainingQuantity, data.expiresAt);
{
"success": true,
"data": {
"id": "clx_order_812",
"orderId": "c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320",
"orderBookId": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"accountId": "clx_acct_12",
"side": "BUY",
"orderType": "LIMIT",
"price": "104200000",
"quantity": "10000000",
"filledQuantity": "4000000",
"remainingQuantity": "6000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"postOnly": false,
"selfTradePreventionMode": "NONE",
"lockId": "clx_lock_204",
"cancelReason": null,
"expiresAt": "2025-06-22T12:00:00.000Z",
"auctionId": null,
"createdAt": "2025-06-15T12:00:00.000Z",
"updatedAt": "2025-06-15T12:03:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG", "status": "ACTIVE" },
"makerTrades": [],
"takerTrades": [
{
"tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
"price": "104200000",
"quantity": "4000000",
"makerFee": "0",
"takerFee": "4000",
"side": "BUY",
"origin": "CLOB",
"settlementStatus": "CONFIRMED",
"createdAt": "2025-06-15T12:03:00.000Z"
}
]
}
}