Skip to main content
GET
/
portfolio
/
fills
Get Fills
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/portfolio/fills \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "fills": [
    {
      "fill_id": "<string>",
      "trade_id": "<string>",
      "order_id": "<string>",
      "ticker": "<string>",
      "market_ticker": "<string>",
      "side": "yes",
      "action": "buy",
      "count": 123,
      "price": 123,
      "yes_price": 123,
      "no_price": 123,
      "yes_price_fixed": "<string>",
      "no_price_fixed": "<string>",
      "is_taker": true,
      "client_order_id": "<string>",
      "created_time": "2023-11-07T05:31:56Z",
      "ts": 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

​
order_id
string

Filter by order ID

​
min_ts
integer<int64>

Filter items after this Unix timestamp

​
max_ts
integer<int64>

Filter items before this Unix timestamp

​
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.

Response

Fills retrieved successfully

​
fills
object[]
required
​
cursor
string
required