What one separately managed account holds right now
/strategies /{strategyId} /accounts /{address} /holdingsA live read of one account of your SMA strategy: its stock positions, its stablecoins and the value of the network gas it holds, read from the chains when you call. Name the account by either of the addresses the accounts list serves.
- The parts add up:
nav_usdcis the sum of every position'susd_value, every stablecoin'samountandgas_usdc. - Stablecoins with a zero balance are left out.
- When the account is not currently assigned to the strategy, or is assigned but its first
deposit has not yet been credited (even if the funds have arrived), nothing is read: the
lists are empty and
gas_usdc,nav_usdcandas_ofarenull. - A balance or price read that does not complete is never answered with a partial figure:
the call answers
503and you retry shortly. That includes gas the account holds that has no price. A read that could only be answered from earlier results rather than from the chains answers503portfolio_busy; retry afterRetry-After. - The read is unavailable for a short window around the daily valuation (00:03 to 00:40
UTC): the call answers
503portfolio_busy; retry afterRetry-After, which carries the seconds until the window ends.
This read has its own budget of 20 calls a minute per credential kind (your keys share one, your dashboard sessions another), on top of the plane-wide one.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 503
OK
invalid_address: the address is neither a Solana nor an EVM address. invalid_request: any query parameter. invalid_strategy_id when the path segment is empty or longer than 64 characters.
unauthorized: no credential was sent at all (breaking change: this used to beinvalid_api_key), or a dashboard session failed verification: the access token is missing, malformed or expired, or the identity token is missing or belongs to a different login.invalid_api_key:X-API-Keyis malformed, unknown, or belongs to a different Treasures API.key_revoked: this key has been revoked; mint a new one or ask Treasures.
strategy_forbidden: this strategy is not assigned to you. The same response is returned for a strategy id that does not exist, so the id space cannot be probed; check the id with your Treasures contact. It is decided before the query string is read.manager_suspended: your account is suspended; every key you hold and your dashboard session are refused until Treasures reactivates it.manager_not_linked: a valid dashboard login that is a Member of no Organization with a manager account.organization_suspendedandpermission_deniedas on every route.
strategy_not_sma: the strategy is yours but its audience is retail. account_not_found: the address is not an account of this strategy.
More than 20 holdings reads in the last minute across your keys, or across your dashboard sessions (each kind its own budget); the plane-wide budget also applies. The Retry-After header carries the seconds to wait.
Response Headers
Seconds to wait before retrying.
A balance or price read did not complete; retry shortly.
portfolio_partial: a balance could not be read.portfolio_unpriced: a position, or gas the account holds, has no price.portfolio_read_timeout: the read ran past its time budget.portfolio_busy: too many reads are in flight, the read could only be answered from earlier results rather than from the chains, or the call fell in the daily valuation window; theRetry-Afterheader carries the seconds to wait.
Response Headers
Seconds to wait before retrying; sent with portfolio_busy.