Skip to main content
GET
/
portfolio
/
orders
Get Orders
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>'
{
  "orders": [
    {
      "order_id": "<string>",
      "user_id": "<string>",
      "client_order_id": "<string>",
      "ticker": "<string>",
      "side": "yes",
      "action": "buy",
      "type": "limit",
      "status": "resting",
      "yes_price": 123,
      "no_price": 123,
      "yes_price_dollars": "0.5000",
      "no_price_dollars": "0.5000",
      "fill_count": 123,
      "remaining_count": 123,
      "initial_count": 123,
      "taker_fees": 123,
      "maker_fees": 123,
      "taker_fill_cost": 123,
      "maker_fill_cost": 123,
      "taker_fill_cost_dollars": "<string>",
      "maker_fill_cost_dollars": "<string>",
      "queue_position": 123,
      "taker_fees_dollars": "<string>",
      "maker_fees_dollars": "<string>",
      "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": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "cancel_order_on_pause": true
    }
  ],
  "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 ticker of desired positions. Multiple event tickers can be provided as a comma-separated list (maximum 10).

min_ts
integer

Filter items after this Unix timestamp

max_ts
integer

Filter items before this Unix timestamp

status
string

Filter by status. Possible values depend on the endpoint.

limit
integer
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.

Response

Orders retrieved successfully

orders
object[]
required
cursor
string
required
I