portfolio

Endpoint for getting all fills for the member. A fill is when a trade you have is matched. Registered partners may also use a user OAuth access token with the explicitly granted read::compliance_partner scope. Fills that occurred before the historical cutoff are only available via GET /historical/fills. See Historical Data for details.

get/portfolio/fills

Request

  • Base URL
    https://external-api.kalshi.com/trade-api/v2
  • URL
    https://external-api.kalshi.com/trade-api/v2/portfolio/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. Accepts a comma-separated list of up to 100 market tickers.

order_idstring

Filter by order ID

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.

exchange_indexinteger

Filter results by exchange shard. Omit to return results from all exchange shards.

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