CLOB Read (Public)
Post Books Batch
Polymarket-compat POST /books.
Body: [{token_id}, ...] (PM-compat) or
{items: [{token_id}, ...]} (legacy wrapped form). Returns one
full OrderBookSnapshot per token (PM-compat shape including
market, asset_id, hash, tick_size, neg_risk,
last_trade_price). Tokens with no book are omitted from the
response (rather than returning empty snapshots — saves SDK-side
filtering).
POST
Post Books Batch
Body
application/json
- BatchTokenIdsRequest · object
- TokenIdRequest · object[]
Response
Successful Response
Previous
List events with their markets (event-first shape).List events with their child markets and live prices.
Thin delegate to the legacy ``GET /events`` handler in
``app.main.list_events``. The legacy path stays the implementation
surface — this wrapper exists so SDK consumers can discover the
events feed via the v1 OpenAPI schema instead of having to know
about the root-mounted ``/events`` route.
Response shape:
``{ events: [...], total: int, limit: int, offset: int,
cache_source: str, has_sports: bool, message?: str }``
On a cold poller cache, the legacy handler returns a 503 with
``Retry-After: 5``; this wrapper passes that response through
unchanged so SDK retry logic stays uniform.
Next
Post Books Batch