Off-Chain Settlement
Get Off-Chain Trades
Read the executed trade tape for an off-chain book
GET
/
orderbooks
/
stocks
/
api
/
offchain
/
order-books
/
{orderBookId}
/
trades
curl "https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/clx_ob_stock_001/trades?limit=25" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/${orderBookId}/trades?limit=25`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"trades": [
{
"tradeId": "1c9e0f22-2b74-4a51-9f8e-73c1a0d4b6e5",
"orderBookId": "clx_ob_stock_001",
"takerOrderBookId": null,
"origin": "CLOB",
"makerAddress": "offchain:cust_1042",
"takerAddress": "offchain:cust_2288",
"price": "182350000",
"quantity": "1000000",
"makerFee": "500",
"takerFee": "1500",
"side": "BUY",
"settlementId": null,
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:02:00.000Z"
}
],
"total": 12,
"limit": 25,
"offset": 0
}
}
Returns executed trades on a book, newest first, in the same shape as Get Order Book Trades.
Off-chain trades carry no settlement transaction. Their
This route resolves the book as a
STOCK_TOKEN book. A book created without an explicit tokenType defaults to LIGHT_TOKEN and returns ORDER_BOOK_NOT_FOUND here, even though the same book reads fine from Get Off-Chain Order Book and its snapshot. Create off-chain stock books with tokenType: "STOCK_TOKEN" to keep the whole surface consistent.settlementStatus reflects the ledger transfer, and makerAddress and takerAddress carry offchain:<customerRef> rather than wallet addresses.
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
Trade records. See Get Order Book Trades for the field list.
integer
Total trades on the scope.
integer
Page size applied.
integer
Offset applied.
curl "https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/clx_ob_stock_001/trades?limit=25" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/${orderBookId}/trades?limit=25`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"trades": [
{
"tradeId": "1c9e0f22-2b74-4a51-9f8e-73c1a0d4b6e5",
"orderBookId": "clx_ob_stock_001",
"takerOrderBookId": null,
"origin": "CLOB",
"makerAddress": "offchain:cust_1042",
"takerAddress": "offchain:cust_2288",
"price": "182350000",
"quantity": "1000000",
"makerFee": "500",
"takerFee": "1500",
"side": "BUY",
"settlementId": null,
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:02:00.000Z"
}
],
"total": 12,
"limit": 25,
"offset": 0
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
ORDER_BOOK_NOT_FOUND | 404 | No such stock book on this instance, or the book’s token type is not STOCK_TOKEN |
⌘I
curl "https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/clx_ob_stock_001/trades?limit=25" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/${orderBookId}/trades?limit=25`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"trades": [
{
"tradeId": "1c9e0f22-2b74-4a51-9f8e-73c1a0d4b6e5",
"orderBookId": "clx_ob_stock_001",
"takerOrderBookId": null,
"origin": "CLOB",
"makerAddress": "offchain:cust_1042",
"takerAddress": "offchain:cust_2288",
"price": "182350000",
"quantity": "1000000",
"makerFee": "500",
"takerFee": "1500",
"side": "BUY",
"settlementId": null,
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:02:00.000Z"
}
],
"total": 12,
"limit": 25,
"offset": 0
}
}