{"uid":"cap_b3JZff8_iYYUYPQBkptv9","slug":"agent402-kalshi-live-market-data-f9c3a16a","name":"Agent402 Kalshi Live Market Data","description":"The live feed a Kalshi event settles on, from Kalshi's free live_data tier: a crypto event returns the CF Benchmarks price series, candlesticks (15M, 1M) and the maturity time; an economic-data event (CPI, jobs) returns the provider's series with the target period. Pass an eventTicker, or a seriesTicker (e.g. KXBTC) and the soonest open event is resolved for you. The type field names the schema of details.","url":"https://agent402.tools/api/kalshi-live-data?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","description":"Newest points to keep per series and per candlestick interval (default 200, max 1000)."},"range":{"type":"string","description":"Chart range hint for types that support it: 15min, 1h, 3h, 1d, 1w, 1m, 1y, 5y, all."},"eventTicker":{"type":"string","description":"Kalshi event ticker, e.g. KXBTC-26SEP1817. Either this or seriesTicker."},"seriesTicker":{"type":"string","description":"Kalshi series ticker, e.g. KXBTC or KXCPI - the soonest open event of the series is resolved."}}},"responseSchema":{"type":"json","example":{"coin":"BTC","type":"crypto","range":null,"latest":{"time":"2026-09-18T16:22:00.000Z","value":80867.31},"series":[{"time":"2026-09-18T16:22:00.000Z","value":80867.31}],"source":"kalshi","details":{"coin":"BTC","event_ticker":"KXBTC-26SEP1817","maturity_ts_ms":1789765200000},"eventTicker":"KXBTC-26SEP1817","seriesCount":5,"candlesticks":[{"count":5,"candles":[{"low":80664.65,"high":80868.42,"open":80703.13,"time":"2026-09-18T16:15:00.000Z","close":80867.31}],"interval":"15M"}],"defaultRange":"1h","isHistorical":false,"maturityTime":"2026-09-18T21:00:00.000Z","rangeOptions":["15min","1h","3h"],"resolvedFrom":{"title":"BTC price range on Sep 18, 2026 at 5pm EDT?","strikeDate":"2026-09-18T21:00:00Z","seriesTicker":"KXBTC"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_COSPGcDerGrJZOA9KnRT4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live price series, candlestick chart data, and event details for a Kalshi prediction market contract by event or series ticker","exampleAgentPrompt":"Pull the latest live market data for the Kalshi BTC series KXBTC, showing the 1-hour chart range with up to 200 data points, so I can see the current price and candlestick history.","exampleUseCases":[{"title":"Monitor live BTC Kalshi contract","prompt":"What's the current price and latest candlestick data for the Kalshi BTC event KXBTC-26SEP1817? Give me the 1-hour chart view."},{"title":"Track CPI prediction market","prompt":"Fetch the live Kalshi data for the KXCPI series — I want to see the latest value, maturity time, and a 1-day chart range with up to 500 data points."},{"title":"Crypto event price alert","prompt":"Get me the most recent price point and OHLC candlesticks for the Kalshi event KXBTC-26SEP1817 using a 15-minute range so I can track short-term movement."}],"resultDescription":"Returns a JSON object containing the latest price point with timestamp, a time series array, OHLC candlestick data grouped by interval, event metadata (ticker, maturity timestamp), the data source ('kalshi'), available range options, and a flag indicating whether the event is historical or live.","failureModes":["Invalid or unknown eventTicker/seriesTicker returns an error or empty result","Requesting a range not supported by the event type may return null range","Exceeding limit max of 1000 is silently capped","Event already resolved may return isHistorical=true with no live data","x402 payment failure if insufficient USDC balance"],"whenToPreferThis":"Choose this endpoint when you need live or recent Kalshi prediction market data — including price series, OHLC candlesticks, and event maturity details — for crypto or macro events like BTC price or CPI outcomes. Prefer it over generic crypto price APIs when you specifically need Kalshi contract pricing or want to track a prediction market rather than a spot exchange price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T06:51:00.164Z","isFirstParty":false,"canonicalSlug":"agent402-kalshi-live-market-data-f9c3a16a"}