{"uid":"cap_3x_-eWFlLzgO3Y1svBypx","slug":"sitecheck-polymarket-clob-price-history-cdedb116","name":"SiteCheck Polymarket CLOB Price History","description":"Fetches historical price points for a Polymarket outcome token across standard intervals (1h, 6h, 1d, 1w, max) or with custom fidelity. Timestamps formatted in ISO. Maximum 1,000 points. Information only, not financial advice.","url":"https://api.sitecheck-api.workers.dev/api/pm/history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["tokenId"],"properties":{"limit":{"type":"string","description":"Maximum data points to return (max 1000)"},"tokenId":{"type":"string","description":"Outcome CLOB token ID (numeric string)"},"fidelity":{"type":"string","description":"Minutes between points, 1 to 1440 (e.g. 60 for hourly); default: Polymarket's own resolution for the interval"},"interval":{"type":"string","description":"Time interval: 1h, 6h, 1d, 1w, or max"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"source":"Polymarket CLOB API (clob.polymarket.com/prices-history)","history":[{"price":0.455,"timestamp":"2026-10-08T19:00:26.000Z"},{"price":0.455,"timestamp":"2026-10-08T20:00:24.000Z"},{"price":0.455,"timestamp":"2026-10-08T21:00:45.000Z"}],"tokenId":"98961942092312242488092499568359433586418736677157512843097593070222397872380","interval":"1w","checkedAt":"2026-10-15T18:21:04.342Z","truncated":false,"disclaimer":"Information only, not financial advice.","pointsCount":167}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vaunwcI1U8pcDfqBhLTYM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical price data for a Polymarket prediction market outcome token over a specified time interval","exampleAgentPrompt":"Can you pull the 1-week price history for Polymarket CLOB token 98961942092312242488092499568359433586418736677157512843097593070222397872380 with hourly data points?","exampleUseCases":[{"title":"Track election outcome probability over time","prompt":"Show me the full price history for Polymarket token 98961942092312242488092499568359433586418736677157512843097593070222397872380 at 60-minute intervals over the past week so I can see how the market probability shifted."},{"title":"Chart short-term prediction market movement","prompt":"Get me the last 6 hours of price data for Polymarket CLOB token 12345678901234567890 with 1-minute fidelity so I can see recent market activity."},{"title":"Analyze long-term prediction market trend","prompt":"Fetch the maximum available price history for Polymarket token 98765432109876543210987654321098765432109876543210987654321098765432 using daily granularity and cap it at 500 data points."}],"resultDescription":"Returns a JSON object containing a source attribution, an array of timestamped price points (each with a price float and ISO timestamp), the queried token ID, interval, check timestamp, a truncated flag indicating if the result was capped, a point count, and a disclaimer that the data is informational only.","failureModes":["Missing or invalid tokenId returns an error — tokenId is required and must be a valid numeric string","Invalid interval value (not 1h, 6h, 1d, 1w, or max) may return an error or default behavior","Fidelity value outside 1-1440 range may be rejected","Limit exceeding 1000 is capped or rejected","Token ID not found on Polymarket CLOB returns empty history or error","Upstream Polymarket CLOB API unavailability causes failure"],"whenToPreferThis":"Use this endpoint when you need historical price (probability) time-series data for a specific Polymarket prediction market outcome token, especially when building charts, analyzing market movements, or backtesting prediction strategies. Prefer this over general crypto price endpoints because it is specifically wired to the Polymarket CLOB API and returns outcome token prices (0-1 probability scale) rather than asset prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:43:14.755Z","isFirstParty":false,"canonicalSlug":"sitecheck-polymarket-clob-price-history-cdedb116"}