{"uid":"cap_pCoyC39j3NFMi2zrjZSkZ","slug":"2s-prediction-market-orderbook-lookup-8a5e56e9","name":"2s Prediction Market Orderbook Lookup","description":"Full CLOB order book (bids + asks with price and size) for a Polymarket outcome token. Use the clobTokenIds from predict.markets. Read-only depth snapshot from Polymarket's CLOB.","url":"https://2s.io/api/predict/orderbook","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["tokenId"],"properties":{"tokenId":{"type":"string","maxLength":120,"minLength":1,"description":"CLOB token id (outcome token)."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OQJgbZoFibxy7F-agdW7K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current orderbook (bids and asks) for a CLOB outcome token on a prediction market by token ID","exampleAgentPrompt":"Pull up the live orderbook for the prediction market outcome token with ID 0x1234abcd — I want to see the current bids and asks.","exampleUseCases":null,"resultDescription":"Returns the current orderbook state for the specified CLOB outcome token, including bid and ask price levels with quantities, enabling analysis of market depth and current best prices.","failureModes":["Invalid or unknown tokenId returns an error or empty orderbook","Token ID too short or too long (outside 1-120 chars) returns validation error","Token no longer active or delisted may return empty or stale data","Payment failure via x402 prevents data retrieval","Network timeout if market data feed is unavailable"],"whenToPreferThis":"Use this endpoint when you need real-time orderbook data for a specific CLOB prediction market outcome token and want pay-per-call access without API key signup. Prefer this over exchange-specific APIs when you need a single unified interface across multiple prediction market tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:03:03.639Z","isFirstParty":false}