Market Data
Get Order Book Trades
Read the executed trade tape for one book
GET
/
orderbooks
/
commodities
/
api
/
order-books
/
{orderBookId}
/
trades
curl "https://api.trusset.org/orderbooks/commodities/api/order-books/clx_ob_comm_001/trades?limit=25" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/commodities/api/order-books/${orderBookId}/trades?limit=25`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"trades": [
{
"tradeId": "b40e7c12-3a86-4d95-8f01-6e2c9a5d7031",
"orderBookId": "clx_ob_comm_001",
"takerOrderBookId": "clx_ob_comm_055",
"origin": "CLOB",
"makerOrderId": "clx_order_612",
"takerOrderId": "clx_order_640",
"makerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"takerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"price": "2410000000",
"quantity": "2000000",
"makerFee": "400",
"takerFee": "1600",
"side": "SELL",
"settlementId": "clx_settle_92",
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:02:00.000Z"
}
],
"total": 9,
"limit": 25,
"offset": 0
}
}
Returns executed trades on a book, newest first. When the book pools depth with other books in its fungibility class, the tape widens to the whole eligible set, so a fill booked on a peer venue appears here too.
Unlike the aggregates on Get Order Book Snapshot, this list includes trades whose settlement failed. Read
settlementStatus before treating a row as a completed transfer.
Path Parameters
string
required
Order book ID.
Query Parameters
integer
default:"50"
Page size, capped at 100.
integer
default:"0"
Rows to skip.
Response Fields
object
Show child attributes
Show child attributes
array
Show child attributes
Show child attributes
string
Trade ID.
string
Maker’s book.
string
Taker’s book when the fill crossed a pooled peer.
string
CLOB.string
Resting order row.
string
Aggressing order row.
string
Resting side.
string
Aggressing side.
string
Execution price in order book units.
string
Base quantity in order book units.
string
Fee charged to the maker, as base quantity in order book units.
string
Fee charged to the taker, as base quantity in order book units.
string
Side of the aggressing order.
string
Settlement grouping this trade, or
null.string
PROCESSING, CONFIRMED, FAILED, or null.string
Why settlement failed, or
null.string
ISO 8601 timestamp.
integer
Total trades on the scope.
integer
Page size applied.
integer
Offset applied.
curl "https://api.trusset.org/orderbooks/commodities/api/order-books/clx_ob_comm_001/trades?limit=25" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/commodities/api/order-books/${orderBookId}/trades?limit=25`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"trades": [
{
"tradeId": "b40e7c12-3a86-4d95-8f01-6e2c9a5d7031",
"orderBookId": "clx_ob_comm_001",
"takerOrderBookId": "clx_ob_comm_055",
"origin": "CLOB",
"makerOrderId": "clx_order_612",
"takerOrderId": "clx_order_640",
"makerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"takerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"price": "2410000000",
"quantity": "2000000",
"makerFee": "400",
"takerFee": "1600",
"side": "SELL",
"settlementId": "clx_settle_92",
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:02:00.000Z"
}
],
"total": 9,
"limit": 25,
"offset": 0
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
ORDER_BOOK_NOT_FOUND | 404 | No such commodity book on this instance, and not imported |
SERVICE_NOT_ENABLED | 403 | The Trading service is not enabled on this instance |
⌘I
curl "https://api.trusset.org/orderbooks/commodities/api/order-books/clx_ob_comm_001/trades?limit=25" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/commodities/api/order-books/${orderBookId}/trades?limit=25`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"trades": [
{
"tradeId": "b40e7c12-3a86-4d95-8f01-6e2c9a5d7031",
"orderBookId": "clx_ob_comm_001",
"takerOrderBookId": "clx_ob_comm_055",
"origin": "CLOB",
"makerOrderId": "clx_order_612",
"takerOrderId": "clx_order_640",
"makerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"takerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"price": "2410000000",
"quantity": "2000000",
"makerFee": "400",
"takerFee": "1600",
"side": "SELL",
"settlementId": "clx_settle_92",
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:02:00.000Z"
}
],
"total": 9,
"limit": 25,
"offset": 0
}
}