Get Polymarket Raw Orderbook Deltas
Retrieve raw orderbook delta data for a Polymarket market. Each row represents either a single orderbook change event (delta) or a full orderbook snapshot, identified by the payload_type field.
What you get
- For deltas: price, size delta, and side of the change
- For snapshots: full bid and ask price/size arrays
- Outcome label resolved from the token ID
- Server and ingest timestamps
Use cases
- Reconstruct full orderbook history tick-by-tick
- Analyze order flow and liquidity dynamics
- Build high-frequency trading signals
- Study market microstructure
Example
- Request:
GET /api/v1/poly/0xb09a659b55f0eab385d75ef14d180e9a6b2f02290a427504e38bf803e35d25d6/raw_deltas?limit=10 - Header:
X-API-Key: YOUR_API_KEY
Authorizations
Your API key (get one from the test-key endpoint above)
Path Parameters
Polymarket condition ID
Query Parameters
Maximum number of rows to return (default: 10 in docs, max: 10000). Use a higher limit in your code.
Response
Raw orderbook delta data
Venue identifier
Venue-specific token identifier
Venue-specific market identifier (condition_id)
Outcome label for this token (e.g., Yes, No, or a named outcome)
Server timestamp (nanoseconds)
Ingest timestamp (nanoseconds)
Type of payload: delta (single change) or snapshot (full state)
Price level of the delta (null for snapshots)
Size change at this price level (null for snapshots)
Side of the delta: bid or ask (null for snapshots)
Bid price levels (for snapshots)
Bid sizes at each price level (for snapshots)
Ask price levels (for snapshots)
Ask sizes at each price level (for snapshots)