Get Polymarket order books
Get the order books of up to 150 Polymarket outcome tokens in one request.
Headers
Get your API keyAPI key (`sfk_...`)
Outcome token ids, 1–150. Repeat the parameter or separate ids with commas. Token ids are the `tokenId` of a market outcome.
Price levels returned per side, 1–200. Default: 20. Levels run from the best price outward.
≥ 1 · ≤ 200
Endpoint-specific response payload.
One entry per requested token id, in request order.
The token id as requested.
`not_found` when the token has no order book: unknown, or its market has closed.
one of: found, not_found
An order book.
Condition id of the market.
Time of this book snapshot (ISO-8601, UTC).
Hash identifying this version of the book.
Buy orders, best (highest) price first.
Price as a probability between 0 and 1.
Shares available at this price.
Sell orders, best (lowest) price first.
Price as a probability between 0 and 1.
Shares available at this price.
Price levels on the bid side before trimming to `depth`.
Price levels on the ask side before trimming to `depth`.
Price of the last trade.
Smallest price step.
Smallest order size in shares.
Whether the market is part of a winner-takes-all group.
Counts across the batch.
Token ids requested.
Token ids with data.
Token ids with no data: unknown, or the market has closed and no longer has an order book.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/books?tokenIds=54533043819946592547517511176940999955633860128497669742211153063842200957669" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket order books.