historical

Get Historical Orders

Changed on

Endpoint for getting orders that have been archived to the historical database. API keys restricted to a subaccount return only that subaccount's orders. If supplied, subaccount must match the key's restriction.

get/historical/orders

Request

  • Base URL
    https://external-api.kalshi.com/trade-api/v2
  • URL
    https://external-api.kalshi.com/trade-api/v2/historical/orders
  • Auth
    API key in header KALSHI-ACCESS-KEY and API key in header KALSHI-ACCESS-SIGNATURE and API key in header KALSHI-ACCESS-TIMESTAMP

Query parameters

tickerstring

Filter by market ticker

min_tsinteger

Filter items after this Unix timestamp

max_tsinteger

Filter items before this Unix timestamp

limitinteger

Number of results per page. Defaults to 100.

cursorstring

Pagination cursor. Use the cursor value returned from the previous response to get the next page of results. Leave empty for the first page.

subaccountinteger

Subaccount number (0 for primary, 1-63 for subaccounts). If omitted, defaults to all subaccounts.

Response

Historical orders retrieved successfully

cursorstring required

Example response

{
  "orders": [
    {
      "yes_price_dollars": "0.5600",
      "no_price_dollars": "0.5600",
      "fill_count_fp": "10.00",
      "remaining_count_fp": "10.00",
      "initial_count_fp": "10.00",
      "taker_fill_cost_dollars": "0.5600",
      "maker_fill_cost_dollars": "0.5600",
      "taker_fees_dollars": "0.5600",
      "maker_fees_dollars": "0.5600"
    }
  ]
}

Changes