Portfolio
This endpoint returns the authenticated wallet's trading metrics over a selected timeframe: a cumulative trading-PnL series, per-bucket and total PnL, money-weighted rate of return (MWRR), trading volume, and fees saved versus a centralized exchange.
The wallet is taken from the bearer token, so this endpoint always reports the caller's own portfolio and requires no wallet:read_any scope. See Authentication for how to obtain a token.
Metrics are computed from the wallet's fills alone, not its on-chain balances. The engine reconstructs the wallet's net base position from its trades and marks it to market at each bucket's price (priced in USDso, treated as 1 USD), so only realized and unrealized trading PnL counts: deposits and withdrawals are structurally invisible and cannot inflate the return. Inventory floors at zero, so base sold without a matching recorded buy (sourced off the exchange) is dropped.
The equity series is therefore cumulative trading PnL, not an account value: it starts at 0 and its final point equals total PnL. Accordingly, EquityPoint.valueUsd and mwrr.depositedUsd are signed. The series ends slightly behind real time to allow for trade-ingestion latency.