{"uid":"cap_voqlV490kuD585yL9SLVJ","slug":"lukka-prediction-markets-price-history-b0845db0","name":"Lukka Prediction Markets Price History","description":"Historical pricing for a single prediction market on one exchange.","url":"https://api.predictionmarketdata.io/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":{"type":"json","example":{"data":[{"ts":"2026-06-07T20:25:00Z","markets":[{"volume":"5817.81","lowPrice":"0.55","highPrice":"0.55","openPrice":"0.55","volumeUsd":"3199.79","closePrice":"0.55","tradeCount":49,"lukkaSymbol":"KXNBAGAME-26JUN08SASNYK-NYK_yes.KALSHI"}]}],"count":1,"dataType":"predictionHistoryCandles","lastDate":"2026-06-07T20:25:00Z","sourceId":4141,"firstDate":"2026-06-07T20:25:00Z","eventTicker":"KXNBAGAME-26JUN08SASNYK.KALSHI"}},"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_eyBPxS66LZLW69tEfYn0J","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 OHLCV candlestick price history for a specific prediction market event on exchanges like Kalshi, Polymarket, or Gemini.","exampleAgentPrompt":"Pull 5-minute candle price history for the Kalshi NBA game contract KXNBAGAME-26JUN08SASNYK on exchange 4141 (Kalshi) for the last 24 hours — give me up to 288 buckets using a 300000ms interval.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of time-bucketed OHLCV candles for the specified prediction market event, including open, high, low, close prices, volume in contract units and USD, trade count per bucket, and metadata like firstDate, lastDate, eventTicker, and sourceId (exchange).","failureModes":["Missing required 'event' query param returns validation error","Missing required 'exchangeId' returns validation error","Unknown or invalid exchangeId returns empty or error response","Event ticker not found on specified exchange returns empty data array","Invalid ISO-8601 timestamps in 'from'/'to' cause parse errors","Payment failure (402) if USDC micropayment not attached","Interval/limit combination producing too many buckets may be rejected or truncated"],"whenToPreferThis":"Use this endpoint when you need time-series OHLCV candlestick data for a specific prediction market contract on Kalshi, Polymarket, or Gemini. Prefer this over general market listings when you already have the event ticker and need granular price history for charting, analysis, or monitoring price movements over a defined time window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:34.196Z","isFirstParty":false}