Skip to main content
GET
/
historical
/
markets
/
{ticker}
/
candlesticks
Get Historical Market Candlesticks
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/historical/markets/{ticker}/candlesticks
{
  "ticker": "<string>",
  "candlesticks": [
    {
      "end_period_ts": 123,
      "yes_bid": {
        "open": "0.5600",
        "low": "0.5600",
        "high": "0.5600",
        "close": "0.5600"
      },
      "yes_ask": {
        "open": "0.5600",
        "low": "0.5600",
        "high": "0.5600",
        "close": "0.5600"
      },
      "price": {
        "open": "0.5600",
        "low": "0.5600",
        "high": "0.5600",
        "close": "0.5600",
        "mean": "0.5600",
        "previous": "0.5600"
      },
      "volume": "10.00",
      "open_interest": "10.00"
    }
  ]
}

Path Parameters

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