Get Event Candlesticks

curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/series/{series_ticker}/events/{ticker}/candlesticks

{
  "market_tickers": [
    "<string>"
  ],
  "market_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,
        "open_interest": 123
      }
    ]
  ],
  "adjusted_end_ts": 123
}

GET

series

{series_ticker}

events

{ticker}

candlesticks

Get Event Candlesticks

curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/series/{series_ticker}/events/{ticker}/candlesticks

{
  "market_tickers": [
    "<string>"
  ],
  "market_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,
        "open_interest": 123
      }
    ]
  ],
  "adjusted_end_ts": 123
}

Path Parameters

ticker

string

required

The event ticker

series_ticker

string

required

The series ticker

Query Parameters

start_ts

integer<int64>

required

Start timestamp for the range

end_ts

integer<int64>

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

market_tickers

string[]

required

Array of market tickers in the event.

market_candlesticks

object[][]

required

Array of market candlestick arrays, one for each market in the event.

Show child attributes

market_candlesticks.end_period_ts

integer<int64>

required

Unix timestamp for the inclusive end of the candlestick period.

market_candlesticks.yes_bid

object

required

Open, high, low, close (OHLC) data for YES buy offers on the market during the candlestick period.

Show child attributes

market_candlesticks.yes_bid.open

integer

required

Offer price on the market at the start of the candlestick period (in cents).

market_candlesticks.yes_bid.open_dollars

string

required

Offer price on the market at the start of the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.yes_bid.low

integer

required

Lowest offer price on the market during the candlestick period (in cents).

market_candlesticks.yes_bid.low_dollars

string

required

Lowest offer price on the market during the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.yes_bid.high

integer

required

Highest offer price on the market during the candlestick period (in cents).

market_candlesticks.yes_bid.high_dollars

string

required

Highest offer price on the market during the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.yes_bid.close

integer

required

Offer price on the market at the end of the candlestick period (in cents).

market_candlesticks.yes_bid.close_dollars

string

required

Offer price on the market at the end of the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.yes_ask

object

required

Open, high, low, close (OHLC) data for YES sell offers on the market during the candlestick period.

Show child attributes

market_candlesticks.yes_ask.open

integer

required

Offer price on the market at the start of the candlestick period (in cents).

market_candlesticks.yes_ask.open_dollars

string

required

Offer price on the market at the start of the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.yes_ask.low

integer

required

Lowest offer price on the market during the candlestick period (in cents).

market_candlesticks.yes_ask.low_dollars

string

required

Lowest offer price on the market during the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.yes_ask.high

integer

required

Highest offer price on the market during the candlestick period (in cents).

market_candlesticks.yes_ask.high_dollars

string

required

Highest offer price on the market during the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.yes_ask.close

integer

required

Offer price on the market at the end of the candlestick period (in cents).

market_candlesticks.yes_ask.close_dollars

string

required

Offer price on the market at the end of the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.price

object

required

Open, high, low, close (OHLC) and more data for trade YES contract prices on the market during the candlestick period.

Show child attributes

market_candlesticks.price.open

integer | null

First traded YES contract price on the market during the candlestick period (in cents). May be null if there was no trade during the period.

market_candlesticks.price.open_dollars

string | null

First traded YES contract price on the market during the candlestick period (in dollars). May be null if there was no trade during the period.

Example:

"0.5600"

market_candlesticks.price.low

integer | null

Lowest traded YES contract price on the market during the candlestick period (in cents). May be null if there was no trade during the period.

market_candlesticks.price.low_dollars

string | null

Lowest traded YES contract price on the market during the candlestick period (in dollars). May be null if there was no trade during the period.

Example:

"0.5600"

market_candlesticks.price.high

integer | null

Highest traded YES contract price on the market during the candlestick period (in cents). May be null if there was no trade during the period.

market_candlesticks.price.high_dollars

string | null

Highest traded YES contract price on the market during the candlestick period (in dollars). May be null if there was no trade during the period.

Example:

"0.5600"

market_candlesticks.price.close

integer | null

Last traded YES contract price on the market during the candlestick period (in cents). May be null if there was no trade during the period.

market_candlesticks.price.close_dollars

string | null

Last traded YES contract price on the market during the candlestick period (in dollars). May be null if there was no trade during the period.

Example:

"0.5600"

market_candlesticks.price.mean

integer | null

Mean traded YES contract price on the market during the candlestick period (in cents). May be null if there was no trade during the period.

market_candlesticks.price.mean_dollars

string | null

Mean traded YES contract price on the market during the candlestick period (in dollars). May be null if there was no trade during the period.

Example:

"0.5600"

market_candlesticks.price.previous

integer | null

Last traded YES contract price on the market before the candlestick period (in cents). May be null if there were no trades before the period.

market_candlesticks.price.previous_dollars

string | null

Last traded YES contract price on the market before the candlestick period (in dollars). May be null if there were no trades before the period.

Example:

"0.5600"

market_candlesticks.price.min

integer | null

Minimum close price of any market during the candlestick period (in cents).

market_candlesticks.price.min_dollars

string | null

Minimum close price of any market during the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.price.max

integer | null

Maximum close price of any market during the candlestick period (in cents).

market_candlesticks.price.max_dollars

string | null

Maximum close price of any market during the candlestick period (in dollars).

Example:

"0.5600"

market_candlesticks.volume

integer<int64>

required

Number of contracts bought on the market during the candlestick period.

market_candlesticks.open_interest

integer<int64>

required

Number of contracts bought on the market by end of the candlestick period (end_period_ts).

adjusted_end_ts

integer<int64>

required

Adjusted end timestamp if the requested candlesticks would be larger than maxAggregateCandidates.

Batch Get Market Candlesticks Get Events

⌘I

exchange

orders

order-groups

portfolio

api-keys

search

market

events

live-data

incentive-programs

fcm

structured-targets

milestone

communications

multivariate

Get Event Candlesticks

Path Parameters

Query Parameters

Response