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,
          "open_interest": 123
        }
      ]
    }
  ]
}

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,
          "open_interest": 123
        }
      ]
    }
  ]
}

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:

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

markets

object[]

required

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

Show child attributes

markets.market_ticker

string

required

Market ticker string (e.g., 'INXD-24JAN01').

markets.candlesticks

object[]

required

Array of candlestick data points for the market. Includes an initial data point at the start timestamp when available.

Show child attributes

markets.candlesticks.end_period_ts

integer<int64>

required

Unix timestamp for the inclusive end of the candlestick period.

markets.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

markets.candlesticks.yes_bid.open

integer

required

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

markets.candlesticks.yes_bid.open_dollars

string

required

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

Example:

"0.5600"

markets.candlesticks.yes_bid.low

integer

required

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

markets.candlesticks.yes_bid.low_dollars

string

required

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

Example:

"0.5600"

markets.candlesticks.yes_bid.high

integer

required

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

markets.candlesticks.yes_bid.high_dollars

string

required

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

Example:

"0.5600"

markets.candlesticks.yes_bid.close

integer

required

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

markets.candlesticks.yes_bid.close_dollars

string

required

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

Example:

"0.5600"

markets.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

markets.candlesticks.yes_ask.open

integer

required

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

markets.candlesticks.yes_ask.open_dollars

string

required

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

Example:

"0.5600"

markets.candlesticks.yes_ask.low

integer

required

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

markets.candlesticks.yes_ask.low_dollars

string

required

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

Example:

"0.5600"

markets.candlesticks.yes_ask.high

integer

required

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

markets.candlesticks.yes_ask.high_dollars

string

required

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

Example:

"0.5600"

markets.candlesticks.yes_ask.close

integer

required

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

markets.candlesticks.yes_ask.close_dollars

string

required

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

Example:

"0.5600"

markets.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

markets.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.

markets.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"

markets.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.

markets.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"

markets.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.

markets.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"

markets.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.

markets.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"

markets.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.

markets.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"

markets.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.

markets.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"

markets.candlesticks.price.min

integer | null

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

markets.candlesticks.price.min_dollars

string | null

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

Example:

"0.5600"

markets.candlesticks.price.max

integer | null

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

markets.candlesticks.price.max_dollars

string | null

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

Example:

"0.5600"

markets.candlesticks.volume

integer<int64>

required

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

markets.candlesticks.open_interest

integer<int64>

required

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

Get Market Get Event Candlesticks

⌘I

exchange

orders

order-groups

portfolio

api-keys

search

market

events

live-data

incentive-programs

fcm

structured-targets

milestone

communications

multivariate

Batch Get Market Candlesticks

Query Parameters

Response