{"uid":"cap_OIiCethAkMrADefg38yQZ","slug":"prediction-market-price-history-5cb5d769","name":"Prediction Market Price History","description":"Historical pricing for a single prediction market on one exchange.","url":"https://d2ngmd5yvdfkqu.cloudfront.net/price-history","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":["event","exchangeId"],"properties":{"to":{"type":"string","description":"UTC end timestamp in ISO-8601 format."},"from":{"type":"string","description":"UTC start timestamp in ISO-8601 format."},"event":{"type":"string","description":"Event ticker or market identifier (from /prediction-markets)."},"limit":{"type":"string","description":"Maximum number of buckets to return (e.g. 288 for 24h of 5m candles)."},"interval":{"type":"string","description":"Bucket size in milliseconds (e.g. 300000 for 5-minute candles)."},"exchangeId":{"type":"string","description":"Numeric exchange ID. 4141=Kalshi, 4137=Polymarket, 4008=Gemini."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ADgwcdxatlfmMNO-2PFzr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns time-bucketed historical price data for a single prediction market event on a specified exchange (Kalshi, Polymarket, or Gemini).","exampleAgentPrompt":"Pull the 5-minute price candles for the Polymarket event 'TRUMP-WIN-2024' (exchange ID 4137) from 2024-11-04T00:00:00Z to 2024-11-05T00:00:00Z, returning up to 288 buckets.","exampleUseCases":null,"resultDescription":"Returns a time series of price buckets (candles) for the specified prediction market event on the chosen exchange, covering the requested time window. Each bucket represents aggregated price data for the given interval (e.g. open, high, low, close within a 5-minute window).","failureModes":["Missing required 'event' parameter returns 400 error","Missing required 'exchangeId' parameter returns 400 error","Unknown event ticker returns empty or 404 response","Invalid exchangeId (not 4141, 4137, or 4008) returns error","Timestamps outside available data range return empty results","Malformed ISO-8601 timestamps return 400 validation error","Payment failure (x402) returns 402 Payment Required before data is served"],"whenToPreferThis":"Use this endpoint when you need historical price data for a specific prediction market event on a known exchange (Kalshi=4141, Polymarket=4137, Gemini=4008). Ideal for charting price movement, analyzing volatility, or backtesting signals on event contracts. Prefer this over volume or open-interest endpoints when the primary need is price (not trading activity or positioning).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:39.422Z","isFirstParty":false}