Kalshi Get Market Candlesticks logo

Catalog action Utility

Get OHLC candlestick price history for a Kalshi market. Returns open, high, low, close prices, volume, and open interest per period. Supports 1-minute, 1-hour, and 1-day intervals. Ideal for: price charting, technical analysis, historical trend monitoring, backtesting strategies.

At a Glance

FieldValue
Action IDkalshi-get-market-candlesticks
CategoryUtility
ConnectorNot required
Requires gasNo
Funds movementNone declared
Tagskalshi, prediction-market, market-data, read

Payload Schema

FieldTypeRequiredDescription
seriesTickerstringYesThe series ticker (e.g., 'KXBTC')
tickerstringYesThe market ticker (e.g., 'KXBTC-25MAR14-B95500')
startTsnumberNoStart timestamp (Unix seconds) for the candlestick range
endTsnumberNoEnd timestamp (Unix seconds) for the candlestick range
periodIntervalnumberNoCandlestick period interval in minutes. 1 = 1 minute, 60 = 1 hour, 1440 = 1 day.

Result Schema

FieldTypeRequiredDescription
candlesticksarrayYesArray of candlestick data points
countnumberNoNumber of candlesticks returned
tickerstringNoMarket ticker
seriesTickerstringNoSeries ticker

Examples

json
{ "type": "kalshi-get-market-candlesticks", "payload": { "seriesTicker": "example-seriesTicker", "ticker": "example-ticker" }, "children": []}

Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.