Portfolio
balance object uses API-wallet
figures — never the $1,000 UI MAIN wallet. wallet_id accepts
all / api / <integer id> (404 WALLET_NOT_FOUND for ids you don’t
own) — see Wallets → Scoping account reads.
With wallet_id=all, positions and trade stats span every wallet you own
while the balance object keeps the API-wallet cash basis (the same
blended view as Profile Analysis).
Authentication
API key only —X-API-Key: <key> (or the PM-compat POLY_API_KEY /
Authorization: Bearer ps_live_... aliases). A Supabase Bearer JWT is
not accepted here (unlike GET /v1/account/balance).
Request
Response
Bot Integration
Errors
All errors return{"error": "<CODE>", "message": "<human-readable>"}.
Next Steps
- Trade History — View filled orders
- Equity Curve — Portfolio value over time