Get Market Candlesticks

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

{
  "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

series

{series_ticker}

markets

{ticker}

candlesticks

Get Market Candlesticks

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

{
  "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
    }
  ]
}

Path Parameters

series_ticker

string

required

Series ticker - the series that contains the target market

ticker

string

required

Market ticker - unique identifier for the specific market

Query Parameters

start_ts

integer<int64>

required

Start timestamp (Unix timestamp). Candlesticks will include those ending on or after this time.

end_ts

integer<int64>

required

End timestamp (Unix timestamp). Candlesticks will include those ending on or before this time.

period_interval

enum<integer>

required

Time period length of each candlestick in minutes. Valid values are 1 (1 minute), 60 (1 hour), or 1440 (1 day).

Available options:

1,

60,

1440

Response

Candlesticks retrieved successfully

ticker

string

required

Unique identifier for the market.

candlesticks

object[]

required

Array of candlestick data points for the specified time range.

Show child attributes

candlesticks.end_period_ts

integer<int64>

required

Unix timestamp for the inclusive end of the candlestick period.

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

candlesticks.yes_bid.open

integer

required

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

candlesticks.yes_bid.open_dollars

string

required

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

Example:

"0.5600"

candlesticks.yes_bid.low

integer

required

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

candlesticks.yes_bid.low_dollars

string

required

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

Example:

"0.5600"

candlesticks.yes_bid.high

integer

required

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

candlesticks.yes_bid.high_dollars

string

required

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

Example:

"0.5600"

candlesticks.yes_bid.close

integer

required

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

candlesticks.yes_bid.close_dollars

string

required

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

Example:

"0.5600"

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

candlesticks.yes_ask.open

integer

required

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

candlesticks.yes_ask.open_dollars

string

required

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

Example:

"0.5600"

candlesticks.yes_ask.low

integer

required

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

candlesticks.yes_ask.low_dollars

string

required

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

Example:

"0.5600"

candlesticks.yes_ask.high

integer

required

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

candlesticks.yes_ask.high_dollars

string

required

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

Example:

"0.5600"

candlesticks.yes_ask.close

integer

required

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

candlesticks.yes_ask.close_dollars

string

required

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

Example:

"0.5600"

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

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.

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"

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.

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"

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.

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"

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.

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"

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.

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"

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.

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"

candlesticks.price.min

integer | null

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

candlesticks.price.min_dollars

string | null

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

Example:

"0.5600"

candlesticks.price.max

integer | null

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

candlesticks.price.max_dollars

string | null

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

Example:

"0.5600"

candlesticks.volume

integer<int64>

required

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

candlesticks.open_interest

integer<int64>

required

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

Get Filters for Sports Get Trades

⌘I

exchange

orders

order-groups

portfolio

api-keys

search

market

events

live-data

incentive-programs

fcm

structured-targets

milestone

communications

multivariate

Get Market Candlesticks

Path Parameters

Query Parameters

Response