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

{
  "success": true,
  "data": [
    {
      "id": "ob_abc123",
      "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "quoteTokenAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "name": "ACME Corp Shares / EURC",
      "symbol": "ACME/EURC",
      "status": "ACTIVE",
      "settlementMode": "ON_CHAIN",
      "makerFeeBps": 10,
      "takerFeeBps": 25
    }
  ],
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:30:00.000Z",
    "instanceId": "inst_abc"
  }
}
Returns all on-chain order books belonging to the authenticated instance, optionally filtered by status.

​
Authentication

Requires an instance API key with the trading service enabled.

​
Query Parameters

​
status
string
Filter by order book status. One of ACTIVE, PAUSED, or CLOSED.
curl -X GET "https://api.trusset.org/orderbooks/stocks/api/order-books?status=ACTIVE" \
  -H "x-api-key: trusset_{instanceRef}_{secret}"

{
  "success": true,
  "data": [
    {
      "id": "ob_abc123",
      "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "quoteTokenAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "name": "ACME Corp Shares / EURC",
      "symbol": "ACME/EURC",
      "status": "ACTIVE",
      "settlementMode": "ON_CHAIN",
      "makerFeeBps": 10,
      "takerFeeBps": 25
    }
  ],
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:30:00.000Z",
    "instanceId": "inst_abc"
  }
}