Orders
Get User Orders
List a wallet’s orders across the stock books you can reach
GET
/
orderbooks
/
stocks
/
api
/
users
/
{userAddress}
/
orders
curl "https://api.trusset.org/orderbooks/stocks/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/orders?status=OPEN&limit=25" \
-H "X-API-Key: trusset_your_key_here"
const params = new URLSearchParams({ status: 'OPEN', limit: '25' });
const res = await fetch(
`https://api.trusset.org/orderbooks/stocks/api/users/${address}/orders?${params}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(`${data.orders.length} of ${data.total}`);
{
"success": true,
"data": {
"orders": [
{
"orderId": "b7c1e0d4-6f2a-4f1e-9d33-5c8a1f0b2e77",
"orderBookId": "clx_ob_stock_002",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"side": "BUY",
"orderType": "LIMIT",
"price": "182350000",
"quantity": "5000000",
"filledQuantity": "1000000",
"remainingQuantity": "4000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"createdAt": "2025-06-15T12:00:00.000Z",
"orderBook": { "id": "clx_ob_stock_002", "symbol": "NYF1" }
}
],
"total": 1,
"limit": 25,
"offset": 0
}
}
Returns orders placed by one wallet, newest first. Without
orderBookId the search covers every stock book your instance owns or has imported. With it, the search is confined to that book, which must resolve for your instance.
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, REJECTED or AUCTION_PENDING.integer
default:"50"
Page size, capped at 100.
integer
default:"0"
Rows to skip.
Response Fields
object
curl "https://api.trusset.org/orderbooks/stocks/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/orders?status=OPEN&limit=25" \
-H "X-API-Key: trusset_your_key_here"
const params = new URLSearchParams({ status: 'OPEN', limit: '25' });
const res = await fetch(
`https://api.trusset.org/orderbooks/stocks/api/users/${address}/orders?${params}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(`${data.orders.length} of ${data.total}`);
{
"success": true,
"data": {
"orders": [
{
"orderId": "b7c1e0d4-6f2a-4f1e-9d33-5c8a1f0b2e77",
"orderBookId": "clx_ob_stock_002",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"side": "BUY",
"orderType": "LIMIT",
"price": "182350000",
"quantity": "5000000",
"filledQuantity": "1000000",
"remainingQuantity": "4000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"createdAt": "2025-06-15T12:00:00.000Z",
"orderBook": { "id": "clx_ob_stock_002", "symbol": "NYF1" }
}
],
"total": 1,
"limit": 25,
"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/stocks/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/orders?status=OPEN&limit=25" \
-H "X-API-Key: trusset_your_key_here"
const params = new URLSearchParams({ status: 'OPEN', limit: '25' });
const res = await fetch(
`https://api.trusset.org/orderbooks/stocks/api/users/${address}/orders?${params}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(`${data.orders.length} of ${data.total}`);
{
"success": true,
"data": {
"orders": [
{
"orderId": "b7c1e0d4-6f2a-4f1e-9d33-5c8a1f0b2e77",
"orderBookId": "clx_ob_stock_002",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"side": "BUY",
"orderType": "LIMIT",
"price": "182350000",
"quantity": "5000000",
"filledQuantity": "1000000",
"remainingQuantity": "4000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"createdAt": "2025-06-15T12:00:00.000Z",
"orderBook": { "id": "clx_ob_stock_002", "symbol": "NYF1" }
}
],
"total": 1,
"limit": 25,
"offset": 0
}
}