Skip to main content
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": "<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
    }
  ]
}

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
required

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

end_ts
integer
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.

I