Skip to main content
GET
/
events
/
candlesticks
Get Event Candlesticks (Multiple Events)
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/events/candlesticks
{
  "events": [
    {
      "event_ticker": "<string>",
      "market_tickers": [
        "<string>"
      ],
      "market_candlesticks": [
        [
          {
            "end_period_ts": 123,
            "yes_bid": {
              "open": 123,
              "open_dollars": "<string>",
              "low": 123,
              "low_dollars": "<string>",
              "high": 123,
              "high_dollars": "<string>",
              "close": 123,
              "close_dollars": "<string>"
            },
            "yes_ask": {
              "open": 123,
              "open_dollars": "<string>",
              "low": 123,
              "low_dollars": "<string>",
              "high": 123,
              "high_dollars": "<string>",
              "close": 123,
              "close_dollars": "<string>"
            },
            "price": {
              "open": 123,
              "open_dollars": "<string>",
              "low": 123,
              "low_dollars": "<string>",
              "high": 123,
              "high_dollars": "<string>",
              "close": 123,
              "close_dollars": "<string>",
              "mean": 123,
              "mean_dollars": "<string>",
              "previous": 123,
              "previous_dollars": "<string>",
              "min": 123,
              "min_dollars": "<string>",
              "max": 123,
              "max_dollars": "<string>"
            },
            "volume": 123,
            "open_interest": 123
          }
        ]
      ],
      "adjusted_end_ts": 123
    }
  ]
}

Query Parameters

event_tickers
string
required

Comma-separated list of event tickers

start_ts
integer
required

Start timestamp for the range

end_ts
integer
required

End timestamp for the range

period_interval
enum<integer>
required

Specifies the length of each candlestick period, in minutes. Must be one minute, one hour, or one day.

Available options:
1,
60,
1440

Response

Event candlesticks retrieved successfully

events
object[]
required

Array of event candlestick responses, one for each event ticker.