Get Orders

Restricts the response to orders that have a certain status: resting, canceled, or executed. Orders that have been canceled or fully executed before the historical cutoff are only available via GET /historical/orders. Resting orders will always be available through this endpoint. See Historical Data for details.

GET /portfolio/orders

Get Orders

cURL

curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/portfolio/orders \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'

200

{
  "orders": [
    {
      "order_id": "<string>",
      "user_id": "<string>",
      "client_order_id": "<string>",
      "ticker": "<string>",
      "side": "yes",
      "action": "buy",
      "type": "limit",
      "status": "resting",
      "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",
      "expiration_time": "2023-11-07T05:31:56Z",
      "created_time": "2023-11-07T05:31:56Z",
      "last_update_time": "2023-11-07T05:31:56Z",
      "self_trade_prevention_type": "taker_at_cross",
      "order_group_id": "<string>",
      "cancel_order_on_pause": true,
      "subaccount_number": 123
    }
  ],
  "cursor": "<string>"
}

Authorizations

KALSHI-ACCESS-KEY · string · header · required

Your API key ID

KALSHI-ACCESS-SIGNATURE · string · header · required

RSA-PSS signature of the request

KALSHI-ACCESS-TIMESTAMP · string · header · required

Request timestamp in milliseconds

Query Parameters

ticker · string

Filter by market ticker

event_ticker · string

Event tickers to filter by, as a comma-separated list (maximum 10).

min_ts · integer<int64>

Filter items after this Unix timestamp

max_ts · integer<int64>

Filter items before this Unix timestamp

status · string

Filter by status. Possible values depend on the endpoint.

limit · integer<int64> · default: 100

Number of results per page. Defaults to 100. Maximum value is 200.

Required range: 1 <= x <= 200

cursor · string

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

subaccount · integer

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

Response

200

application/json

Orders retrieved successfully

orders · object[] · required

Show child attributes

cursor · string · required