historical

Get Historical Fills

Changed on

Endpoint for getting all historical fills for the member. A fill is when a trade you have is matched. API keys restricted to a subaccount return only that subaccount's fills. If supplied, subaccount must match the key's restriction. Registered partners may also use a user OAuth access token with the explicitly granted read::compliance_partner scope.

get/historical/fills

Request

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

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

Fills retrieved successfully

cursorstring required

Example response

{
  "fills": [
    {
      "count_fp": "10.00",
      "yes_price_dollars": "0.5600",
      "no_price_dollars": "0.5600",
      "fee_cost": "0.5600"
    }
  ]
}

Changes