Skip to main content

What one separately managed account holds right now

GET/strategies/{strategyId}/accounts/{address}/holdings

A 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_usdc is the sum of every position's usd_value, every stablecoin's amount and gas_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_usdc and as_of are null.
  • A balance or price read that does not complete is never answered with a partial figure: the call answers 503 and 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 answers 503 portfolio_busy; retry after Retry-After.
  • The read is unavailable for a short window around the daily valuation (00:03 to 00:40 UTC): the call answers 503 portfolio_busy; retry after Retry-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​

OK