Skip to main content
GET
/
orderbooks
/
stocks
/
api
/
order-books
/
{orderBookId}
/
trades
curl -X GET "https://api.trusset.org/orderbooks/stocks/api/order-books/ob_abc123/trades?limit=20" \
  -H "x-api-key: trusset_{instanceRef}_{secret}"

{
  "success": true,
  "data": [
    {
      "id": "trade_001",
      "orderBookId": "ob_abc123",
      "price": "100000000000000000000",
      "quantity": "2000000000000000000",
      "makerOrderId": "ord_aaa",
      "takerOrderId": "ord_bbb",
      "timestamp": "2025-01-15T10:30:00.000Z"
    }
  ],
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:30:00.000Z",
    "instanceId": "inst_abc"
  }
}
Returns a paginated list of executed trades for the specified order book, ordered by most recent first.

​
Authentication

Requires an instance API key with the trading service enabled.

​
Path Parameters

​
orderBookId
string
required
The order book identifier.

​
Query Parameters

​
limit
integer
Number of trades to return. Default 50, maximum 100.
​
offset
integer
Offset for pagination. Default 0.
curl -X GET "https://api.trusset.org/orderbooks/stocks/api/order-books/ob_abc123/trades?limit=20" \
  -H "x-api-key: trusset_{instanceRef}_{secret}"

{
  "success": true,
  "data": [
    {
      "id": "trade_001",
      "orderBookId": "ob_abc123",
      "price": "100000000000000000000",
      "quantity": "2000000000000000000",
      "makerOrderId": "ord_aaa",
      "takerOrderId": "ord_bbb",
      "timestamp": "2025-01-15T10:30:00.000Z"
    }
  ],
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:30:00.000Z",
    "instanceId": "inst_abc"
  }
}