Skip to main content
GET
/
portfolio
/
balance
Get Balance
curl --request GET \
  --url https://external-api.kalshi.com/trade-api/v2/portfolio/balance \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "balance": 123,
  "balance_dollars": "0.5600",
  "portfolio_value": 123,
  "updated_ts": 123,
  "balance_breakdown": [
    {
      "exchange_index": 0,
      "balance": "0.5600"
    }
  ]
}

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). Defaults to 0.

Response

Balance retrieved successfully

balance
integer<int64>
required

Member's available balance in cents. This represents the amount available for trading.

balance_dollars
string
required

Member's available balance as a fixed-point dollar string. This represents the amount available for trading.

Example:

"0.5600"

portfolio_value
integer<int64>
required

Member's portfolio value in cents. This is the current value of all positions held.

updated_ts
integer<int64>
required

Unix timestamp of the last update to the balance.

balance_breakdown
object[]

Balance broken down per exchange index.