Skip to main content
GET
/
markets
/
candlesticks
Batch Get Market Candlesticks
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/markets/candlesticks
{
  "markets": [
    {
      "market_ticker": "<string>",
      "candlesticks": [
        {
          "end_period_ts": 123,
          "yes_bid": {
            "open": 123,
            "open_dollars": "0.5600",
            "low": 123,
            "low_dollars": "0.5600",
            "high": 123,
            "high_dollars": "0.5600",
            "close": 123,
            "close_dollars": "0.5600"
          },
          "yes_ask": {
            "open": 123,
            "open_dollars": "0.5600",
            "low": 123,
            "low_dollars": "0.5600",
            "high": 123,
            "high_dollars": "0.5600",
            "close": 123,
            "close_dollars": "0.5600"
          },
          "price": {
            "open": 123,
            "open_dollars": "0.5600",
            "low": 123,
            "low_dollars": "0.5600",
            "high": 123,
            "high_dollars": "0.5600",
            "close": 123,
            "close_dollars": "0.5600",
            "mean": 123,
            "mean_dollars": "0.5600",
            "previous": 123,
            "previous_dollars": "0.5600",
            "min": 123,
            "min_dollars": "0.5600",
            "max": 123,
            "max_dollars": "0.5600"
          },
          "volume": 123,
          "volume_fp": "10.00",
          "open_interest": 123,
          "open_interest_fp": "10.00"
        }
      ]
    }
  ]
}

Query Parameters

​
market_tickers
string
required

Comma-separated list of market tickers (maximum 100)

​
start_ts
integer<int64>
required

Start timestamp in Unix seconds

​
end_ts
integer<int64>
required

End timestamp in Unix seconds

​
period_interval
integer<int32>
required

Candlestick period interval in minutes

Required range: x >= 1
​
include_latest_before_start
boolean
default:false

If true, prepends the latest candlestick available before the start_ts. This synthetic candlestick is created by:

  1. Finding the most recent real candlestick before start_ts
  2. Projecting it forward to the first period boundary (calculated as the next period interval after start_ts)
  3. Setting all OHLC prices to null, and previous_price to the close price from the real candlestick

Response

Market candlesticks retrieved successfully

​
markets
object[]
required

Array of market candlestick data, one entry per requested market.