Skip to main content
GET
/
margin
/
risk
Get Risk
curl --request GET \
  --url https://external-api.kalshi.com/trade-api/v2/margin/risk \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "total_position_notional": "0.5600",
  "total_maintenance_margin": "0.5600",
  "positions": [
    {
      "subaccount": 123,
      "market_ticker": "<string>",
      "position": "10.00",
      "mark_price": "0.5600",
      "position_notional": "0.5600",
      "maintenance_margin_required": "0.5600",
      "position_leverage": 123,
      "estimated_liquidation_price": "0.5600"
    }
  ],
  "account_leverage": 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

Response

Margin risk data retrieved successfully

​
total_position_notional
string
required

Sum of absolute position notional values across all positions in fixed-point dollars

Example:

"0.5600"

​
total_maintenance_margin
string
required

Sum of maintenance margin requirements across all positions in fixed-point dollars

Example:

"0.5600"

​
positions
object[]
required

Per-position risk breakdown grouped by subaccount and market

​
account_leverage
number<double> | null

Account-level leverage (total_position_notional / total_maintenance_margin). Null when total maintenance margin is zero.