Skip to main content

Balance

GET /v1/account/balance
Returns your current account balance, P&L metrics, and starting capital.

Request

curl -H "X-API-Key: $API_KEY" \
  https://api.polysimulator.com/v1/account/balance

Response

{
  "user_id": 1,
  "balance": "993.50",
  "currency": "USD",
  "starting_balance": "1000.00",
  "pnl": "-6.50",
  "pnl_percent": "-0.65",
  "unrealized_pnl": "0.50"
}
FieldDescription
balanceCurrent cash balance (available for trading)
currencyAlways USD
starting_balanceInitial capital ($1,000 for virtual accounts)
pnlRealized profit/loss since account creation
pnl_percentP&L as percentage of starting balance
unrealized_pnlUnrealized P&L from open positions
Your total portfolio value = balance + market value of open positions. Use the Portfolio endpoint for a complete snapshot.

Next Steps