CLOB Public API Reference

This page documents public CLOB endpoints intended for market data consumption.

Base Path

https://api.speculite.com/clob

1) Orderbook Snapshot

GET /clob/orderbook?market_id=<uuid>

Returns raw orderbook data for a single market.

Query parameters:

Name	Type	Required	Description
market_id	UUID string	yes	market identifier

Example request:

curl "https://api.speculite.com/clob/orderbook?market_id=5f2d8f5d-86b2-4ca8-a451-4b7b4669ed28"

Example response (truncated):

{
  "market_id": "5f2d8f5d-86b2-4ca8-a451-4b7b4669ed28",
  "bids": [
    {
      "id": "...",
      "price": "0.61000000",
      "size": "400",
      "token_id": 0
    }
  ],
  "asks": [
    {
      "id": "...",
      "price": "0.61500000",
      "size": "350",
      "token_id": 0
    }
  ],
  "last_price": "0.61200000",
  "timestamp": "2026-02-20T15:40:05.000Z"
}

Common errors:

• 400: missing/invalid market_id
• 404: market not found

2) Batch Market Prices

POST /clob/market-prices/batch

Returns lightweight price snapshots for multiple markets.

Request body:

Field	Type	Required	Description
market_ids	string[]	yes	list of market UUIDs, max 100

Example request:

curl -X POST "https://api.speculite.com/clob/market-prices/batch" \
  -H "Content-Type: application/json" \
  -d '{"market_ids":["5f2d8f5d-86b2-4ca8-a451-4b7b4669ed28","f2ea64ee-95af-4b13-adf4-c8b6190c7e8b"]}'

Example response:

{
  "data": [
    {
      "market_id": "5f2d8f5d-86b2-4ca8-a451-4b7b4669ed28",
      "best_bid": "0.61000000",
      "best_ask": "0.61500000",
      "midpoint_price": "0.61250000",
      "last_price": "0.61200000",
      "spread": "0.00500000",
      "timestamp": "2026-02-20T15:41:02Z"
    },
    {
      "market_id": "f2ea64ee-95af-4b13-adf4-c8b6190c7e8b",
      "timestamp": "2026-02-20T15:41:02Z"
    }
  ]
}

Common errors:

• 400: invalid body, empty market list, or more than 100 market IDs

Notes

• CLOB write/order-management endpoints are currently app-facing and not part of the public developer surface.
• A separate developer trading API will be documented after key-based auth/signing release.