Skip to main content
GET
/
fcm
/
positions
Get FCM Positions
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/fcm/positions \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "market_positions": [
    {
      "ticker": "<string>",
      "total_traded": 123,
      "total_traded_dollars": "0.5600",
      "position": 123,
      "market_exposure": 123,
      "market_exposure_dollars": "0.5600",
      "realized_pnl": 123,
      "realized_pnl_dollars": "0.5600",
      "resting_orders_count": 123,
      "fees_paid": 123,
      "fees_paid_dollars": "0.5600",
      "last_updated_ts": "2023-11-07T05:31:56Z"
    }
  ],
  "event_positions": [
    {
      "event_ticker": "<string>",
      "total_cost": 123,
      "total_cost_dollars": "0.5600",
      "total_cost_shares": 123,
      "event_exposure": 123,
      "event_exposure_dollars": "0.5600",
      "realized_pnl": 123,
      "realized_pnl_dollars": "0.5600",
      "fees_paid": 123,
      "fees_paid_dollars": "0.5600"
    }
  ],
  "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

​
subtrader_id
string
required

Restricts the response to positions for a specific subtrader (FCM members only)

​
ticker
string

Ticker of desired positions

​
event_ticker
string

Event ticker of desired positions

​
count_filter
string

Restricts the positions to those with any of following fields with non-zero values, as a comma separated list

​
settlement_status
enum<string>

Settlement status of the markets to return. Defaults to unsettled

Available options:
all,
unsettled,
settled
​
limit
integer

Parameter to specify the number of results per page. Defaults to 100

Required range: 1 <= x <= 1000
​
cursor
string

The Cursor represents a pointer to the next page of records in the pagination

Response

Positions retrieved successfully

​
market_positions
object[]
required

List of market positions

​
event_positions
object[]
required

List of event positions

​
cursor
string

The Cursor represents a pointer to the next page of records in the pagination. Use the value returned here in the cursor query parameter for this end-point to get the next page containing limit records. An empty value of this field indicates there is no next page.