KAkalshi
historical

Get Historical Market Candlesticks

Changed on

Endpoint for fetching historical candlestick data for markets that have been archived from the live data set. Time period length of each candlestick in minutes. Valid values: 1 (1 minute), 60 (1 hour), 1440 (1 day).

get/historical/markets/{ticker}/candlesticks

Request

  • Base URL
    https://external-api.kalshi.com/trade-api/v2
  • URL
    https://external-api.kalshi.com/trade-api/v2/historical/markets/{ticker}/candlesticks
  • Auth
    none declared

Path parameters

tickerstring required

Market ticker - unique identifier for the specific market

Query parameters

start_tsinteger required

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

end_tsinteger required

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

period_interval1 | 60 | 1440 required

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

Response

Candlesticks retrieved successfully

tickerstring required

Unique identifier for the market.

Example response

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

Changes