Skip to main content

Portfolio

Returns a complete portfolio snapshot combining balance, positions, and aggregate metrics. By default this endpoint reports the caller’s API wallet (baseline Pro: 10,000/Pro+:10,000 / Pro+: 25,000), so the nested 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