Skip to main content
GET
/
margin
/
positions
Get Positions
curl --request GET \
  --url https://external-api.kalshi.com/trade-api/v2/margin/positions \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "positions": [
    {
      "market_ticker": "<string>",
      "position": "10.00",
      "entry_price": "0.5600",
      "unrealized_pnl": "0.5600",
      "margin_used": "0.5600",
      "fees": "0.5600",
      "roe": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.kalshi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
subaccount
integer

Subaccount number (0 for primary, 1-32 for subaccounts)

​
ticker
string

Filter positions by market ticker

Response

Positions retrieved successfully

​
positions
object[]
required