{"uid":"cap_H7wEGgQ-0llcbtXUSAL3Q","slug":"polymarket-historical-orderbook-snapshots-69e994ed","name":"Polymarket Historical Orderbook Snapshots","description":"Get historical orderbook snapshots for a token","url":"https://sol.blockrun.ai/api/v1/pm/polymarket/orderbooks","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0075","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.0095/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0095","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0095","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hwRfiM75fXx9I7rLiotCg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0095","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical orderbook snapshots for a Polymarket prediction market token","exampleAgentPrompt":"Can you pull up the historical orderbook snapshots for the Polymarket token on the 'Will Biden drop out?' market so I can see how the bid/ask depth evolved over time?","exampleUseCases":[{"title":"Backtesting prediction market strategies","prompt":"Pull the historical orderbook snapshots for the Polymarket 'US 2024 Election' outcome token so I can backtest a market-making strategy using past bid/ask spreads."},{"title":"Detecting liquidity shifts before a market event","prompt":"Show me the orderbook snapshots for the Polymarket token on the Fed rate cut market leading up to the announcement date — I want to see if liquidity dried up ahead of the event."},{"title":"Researching smart money activity","prompt":"Get me the historical orderbook data for the Polymarket outcome token on the SuperBowl winner market — I want to see how the book changed as large orders came in."}],"resultDescription":"Returns historical orderbook snapshot data for a specified Polymarket token, including bid and ask price levels, order sizes, and depth at various points in time, structured as a JSON object under a 'data' key.","failureModes":["Invalid or unknown token ID returns empty or error response","Token with no historical orderbook activity returns empty dataset","Rate limiting or payment failure (x402) if USDC payment is not properly handled","Malformed request parameters may return a 400-level error","Data may be incomplete for very old or illiquid markets"],"whenToPreferThis":"Use this endpoint when you need historical orderbook depth data (bid/ask levels over time) specifically for Polymarket tokens. Prefer this over OHLCV endpoints when you need granular liquidity and spread information rather than price candles, and over live market queries when you need past state rather than current conditions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:41.113Z","isFirstParty":false}