Skip to main content
GET
/
margin
/
balance
Get Balance
curl --request GET \
  --url https://external-api.kalshi.com/trade-api/v2/margin/balance \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "subaccount_balances": [
    {
      "subaccount": 123,
      "position_value": "0.5600",
      "account_equity": "0.5600",
      "maintenance_margin": "0.5600",
      "initial_margin": "0.5600",
      "resting_orders_margin": "0.5600",
      "available_balance": "0.5600"
    }
  ],
  "settled_funds": "0.5600"
}

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.

Rate limit: 5 tokens per request, or 50 tokens when compute_available_balance=true (the available-balance computation scans all resting orders). Other endpoints use the default cost of 10 tokens per request unless noted on their own page. See Rate Limits and Tiers.

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

​
compute_available_balance
boolean
default:false

When true, computes available_balance per subaccount at an increased rate limit cost. Available balance is 0 when the flag is false or omitted.

Response

Margin balance retrieved successfully

​
subaccount_balances
object[]
required

Per-subaccount balance breakdown

​
settled_funds
string
required

Total settled funds across all subaccounts in fixed-point dollars

Example:

"0.5600"