> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Order Book Trades
> Read the executed trade tape for one book
Returns executed trades on a book, newest first. When the book pools depth with peers, 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](/endpoints/external-securities-trading/get-order-book-snapshot), this list includes trades whose settlement failed and trades still waiting for one. Read `settlementStatus` before treating a row as a completed transfer.
## Path Parameters
Order book ID.
## Query Parameters
Page size, capped at 100.
Rows to skip.
## Response Fields
Trade ID.
Maker's book.
Taker's book when the fill crossed a pooled peer.
`CLOB`.
Resting order row.
Aggressing order row.
Resting side.
Aggressing side.
Execution price in order book units.
Base quantity in order book units.
Fee charged to the maker, as base quantity in order book units.
Fee charged to the taker, as base quantity in order book units.
Side of the aggressing order.
Settlement grouping this trade, or `null`.
`AWAITING_SIGNATURE`, `CONFIRMED` or `FAILED`.
Why settlement failed, or `null`.
ISO 8601 timestamp.
Total trades on the scope.
Page size applied.
Offset applied.
```bash cURL theme={null}
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books/clx_ob_extsec_001/trades?limit=25" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/order-books/${orderBookId}/trades?limit=25`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
```
```json Response theme={null}
{
"success": true,
"data": {
"trades": [
{
"tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
"orderBookId": "clx_ob_extsec_001",
"takerOrderBookId": null,
"origin": "CLOB",
"makerOrderId": "clx_order_799",
"takerOrderId": "clx_order_812",
"makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"price": "104200000",
"quantity": "10000000",
"makerFee": "0",
"takerFee": "10000",
"side": "BUY",
"settlementId": "clx_settle_77",
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:00:00.000Z"
}
],
"total": 6,
"limit": 25,
"offset": 0
}
}
```
## Error Codes
| Code | HTTP | Cause |
| ---------------------- | ----- | ------------------------------------------------------------------- |
| `ORDER_BOOK_NOT_FOUND` | `404` | No such external securities book on this instance, and not imported |
| `SERVICE_NOT_ENABLED` | `403` | The Trading service is not enabled on this instance |