Orders
Get User Orders
List a wallet’s orders across the security books you can reach
GET
/
orderbooks
/
external-securities
/
api
/
users
/
{userAddress}
/
orders
curl "https://api.trusset.org/orderbooks/external-securities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/orders?status=OPEN" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/users/${address}/orders?status=OPEN`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"orders": [
{
"orderId": "c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320",
"orderBookId": "clx_ob_extsec_001",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"side": "BUY",
"orderType": "LIMIT",
"price": "104200000",
"quantity": "10000000",
"filledQuantity": "4000000",
"remainingQuantity": "6000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"expiresAt": "2025-06-22T12:00:00.000Z",
"createdAt": "2025-06-15T12:00:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG" }
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}
Returns orders placed by one wallet, newest first. Without
orderBookId the search covers every external securities book your instance owns or has imported. With it, the search is confined to that book, which must resolve for your instance.
Filter on OPEN and PARTIALLY_FILLED for the trader’s live exposure. Each of those orders holds a reservation against their tradable balance, which is why an order left resting reduces what a new order can draw on.
Path Parameters
string
required
Wallet address. Matched case-insensitively.
Query Parameters
string
Restrict to one book. Ignored if longer than 100 characters.
string
Restrict to one status:
OPEN, PARTIALLY_FILLED, FILLED, CANCELLED, EXPIRED or REJECTED.integer
default:"50"
Page size, capped at 100.
integer
default:"0"
Rows to skip.
Response Fields
object
curl "https://api.trusset.org/orderbooks/external-securities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/orders?status=OPEN" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/users/${address}/orders?status=OPEN`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"orders": [
{
"orderId": "c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320",
"orderBookId": "clx_ob_extsec_001",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"side": "BUY",
"orderType": "LIMIT",
"price": "104200000",
"quantity": "10000000",
"filledQuantity": "4000000",
"remainingQuantity": "6000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"expiresAt": "2025-06-22T12:00:00.000Z",
"createdAt": "2025-06-15T12:00:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG" }
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
VALIDATION_ERROR | 400 | userAddress is not a valid address |
ORDER_BOOK_NOT_FOUND | 404 | The orderBookId filter names a book your instance cannot reach |
SERVICE_NOT_ENABLED | 403 | The Trading service is not enabled on this instance |
⌘I
curl "https://api.trusset.org/orderbooks/external-securities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/orders?status=OPEN" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/users/${address}/orders?status=OPEN`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"orders": [
{
"orderId": "c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320",
"orderBookId": "clx_ob_extsec_001",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"side": "BUY",
"orderType": "LIMIT",
"price": "104200000",
"quantity": "10000000",
"filledQuantity": "4000000",
"remainingQuantity": "6000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"expiresAt": "2025-06-22T12:00:00.000Z",
"createdAt": "2025-06-15T12:00:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG" }
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}