KAkalshi
historical

Get Historical Cutoff Timestamps

Changed on

Returns the archive's cutoff timestamps. For positions, the cutoff is the backfill horizon; visibility in the historical API waits for a buffered, whole-event handoff.

Cutoff fields

  • market_settled_ts : Markets that settled before this timestamp, and their candlesticks, must be accessed via GET /historical/markets and GET /historical/markets/{ticker}/candlesticks.
  • trades_created_ts : Trades that were filled before this timestamp must be accessed via GET /historical/fills.
  • orders_updated_ts : Orders that were canceled or fully executed before this timestamp must be accessed via GET /historical/orders. Resting (active) orders are always available in GET /portfolio/orders.
  • market_positions_last_updated_ts : Backfill horizon for settled positions, not a guaranteed archive-visibility boundary. An event moves to GET /historical/positions only after its buffered handoff completes. Until then, its settled positions remain available via GET /portfolio/positions?settlement_status=settled. Unsettled positions remain available in GET /portfolio/positions.
get/historical/cutoff

Request

  • Base URL
    https://external-api.kalshi.com/trade-api/v2
  • URL
    https://external-api.kalshi.com/trade-api/v2/historical/cutoff
  • Auth
    none declared

Response

Historical cutoff timestamps retrieved successfully

market_settled_tsstring date-time required

Cutoff based on market settlement time. Markets and their candlesticks that settled before this timestamp must be accessed via GET /historical/markets and GET /historical/markets/{ticker}/candlesticks.

trades_created_tsstring date-time required

Cutoff based on trade fill time. Fills that occurred before this timestamp must be accessed via GET /historical/fills.

orders_updated_tsstring date-time required

Cutoff based on order cancellation or execution time. Orders canceled or fully executed before this timestamp must be accessed via GET /historical/orders. Resting (active) orders are always available in GET /portfolio/orders.

market_positions_last_updated_tsstring date-time

Cutoff based on position last-update time. Settled positions archived from the live data set before this timestamp are served through the historical section of position reads.

Changes