Portfolio
Get balances
GET
appIdbearerAuthheader
x-app-id<token>Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.
header
AuthorizationBearer <JWT>JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.
mode?stringValue in
"live""paper"custody?stringValue in
"managed""self"200
application/json- response
cash*array<>Stablecoin cash, one entry per token, with per-chain rows.
positions*array<>Value of open positions, one entry per venue.
venueCash?array<>Cash held inside venue accounts, separate from on-chain cash. Omitted when no such venue is available.
paper?Paper-account summary. Present only in paper mode.
curl -X GET 'https://api.t.sufwankhalid.com/execution/balances'Example Response
{ "cash": [ { "tokenSymbol": "USDC", "totalRaw": "125000000", "availableRaw": "125000000", "reservedRaw": "0", "decimals": 6, "chains": [ { "chainId": 137, "tokenAddress": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "balanceRaw": "100000000", "decimals": 6, "lastSyncedAt": "2026-09-29T15:10:02.000Z", "address": "0x8e2d6a1c4f7b0e3d9a5c2f8b1e6d4a7c0f3b9e25", "custodyKind": "DEPOSIT_WALLET" }, { "chainId": 8453, "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "balanceRaw": "25000000", "decimals": 6, "lastSyncedAt": "2026-09-29T15:10:02.000Z", "address": "0x8e2d6a1c4f7b0e3d9a5c2f8b1e6d4a7c0f3b9e25", "custodyKind": "DEPOSIT_WALLET" } ] } ], "positions": [ { "venue": "polymarket", "balance": 16.2, "costBasis": 15.3, "unrealizedPnl": 0.9, "realizedPnl": 0, "priceSource": "orderbook", "bookQuality": "healthy" }, { "venue": "limitless", "balance": 9.72, "costBasis": 9.63, "unrealizedPnl": 0.09, "realizedPnl": 0, "priceSource": "orderbook", "bookQuality": "healthy" } ]}