market

Batch Get Market Candlesticks

Changed on Apr 13, 2026

Endpoint for retrieving candlestick data for multiple markets.

Accepts up to 100 market tickers per request
Returns up to 10,000 candlesticks total across all markets
Returns candlesticks grouped by market_id
Optionally includes a synthetic initial candlestick for price continuity (see include_latest_before_start parameter)

get/markets/candlesticks

Request

Base URL
https://external-api.kalshi.com/trade-api/v2
URL
https://external-api.kalshi.com/trade-api/v2/markets/candlesticks
Auth
none declared

Query parameters

market_tickersstring required

Comma-separated list of market tickers (maximum 100)

start_tsinteger required

Start timestamp in Unix seconds

end_tsinteger required

End timestamp in Unix seconds

period_intervalinteger required

Candlestick period interval in minutes

include_latest_before_startboolean

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

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

Response

Market candlesticks retrieved successfully

Example response

{
  "markets": [
    {
      "candlesticks": [
        {
          "yes_bid": {
            "open_dollars": "0.5600",
            "low_dollars": "0.5600",
            "high_dollars": "0.5600",
            "close_dollars": "0.5600"
          },
          "yes_ask": {
            "open_dollars": "0.5600",
            "low_dollars": "0.5600",
            "high_dollars": "0.5600",
            "close_dollars": "0.5600"
          },
          "price": {
            "open_dollars": "0.5600",
            "low_dollars": "0.5600",
            "high_dollars": "0.5600",
            "close_dollars": "0.5600",
            "mean_dollars": "0.5600",
            "previous_dollars": "0.5600",
            "min_dollars": "0.5600",
            "max_dollars": "0.5600"
          },
          "volume_fp": "10.00",
          "open_interest_fp": "10.00"
        }
      ]
    }
  ]
}

Changes

Apr 13, 2026218c1f661cbd Revision changes
- breaking
  removed the required property //// from the response with the status
- breaking
  removed the required property //// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- breaking
  removed the required property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
Jan 26, 2026ea5437268cb9 Revision changes
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status

Operation history (3 revisions)