{"uid":"cap_AaXpPhXBWdCgtFZtEaDpc","slug":"blockrun-ai-2e324e09","name":"BlockRun.AI Polymarket Historical Orderbook Snapshots","description":"Get historical orderbook snapshots for a token","url":"https://blockrun.ai/api/v1/pm/polymarket/orderbooks","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":{"request":{"end_time":1730505600,"token_id":"21742633143463906290569050155826241533067272736897614950488156847949938836455","start_time":1730419200},"response":{"snapshots":[],"pagination":{"count":0,"limit":100,"has_more":false,"pagination_key":null}}},"exampleRequest":{"end_time":1730505600,"token_id":"21742633143463906290569050155826241533067272736897614950488156847949938836455","start_time":1730419200},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uc2ZzVbkFPCOLlMy0KAYy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical orderbook snapshots for a specific Polymarket prediction market token","exampleAgentPrompt":"Can you pull the historical orderbook snapshots for the Polymarket token for the 'Will Trump win 2024?' market so I can analyze how the bid-ask spread evolved over time?","exampleUseCases":null,"resultDescription":"Returns historical orderbook snapshot data for the specified Polymarket token, including bid and ask price levels, order sizes, and timestamps of snapshots captured over time.","failureModes":["Invalid or unknown token identifier returns empty or error response","Token not tracked by BlockRun.AI returns no data","Rate limiting or payment failure (x402) if USDC micropayment not processed","Malformed request parameters result in API error","Historical data may be unavailable for very old or inactive markets"],"whenToPreferThis":"Choose this endpoint when you need historical orderbook depth and bid/ask snapshot data specifically from Polymarket prediction markets. It is distinct from live orderbook feeds and is best suited for backtesting, liquidity analysis, or studying how market sentiment evolved over time on a specific outcome token.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:45:17.973Z","isFirstParty":false}