List sub-accounts with balances (paginated)
GET/account/subaccounts/all
Returns the entity's sub-accounts (the primary appears as "Main") with
their non-zero balances nested per row, each row carrying a totalUsdc
value, plus a portfolioTotalUsdc computed across ALL sub-accounts
regardless of pagination or filter. filteredTotalUsdc is scoped to the
tag filter ONLY (tagFilter / excludeTagFilter); label / category /
publicIds are ignored for it, so a section total stays stable while the
user searches within the section. With no tag filter it equals
portfolioTotalUsdc. Requires the treasury.balances.read permission.
Request
Responses
- 200
- 400
- 401
- 403
OK
Invalid query param (e.g. non-numeric publicIds, unknown tagFilter/excludeTagFilter/sort/order value, or limit above 100)
Missing/invalid JWT or entity selection (RBAC_ENTITY_SELECTION_REQUIRED)
Caller lacks the treasury.balances.read permission (RBAC_PERMISSION_DENIED)