Wallets
These privileged endpoints expose balances and trading volume for an arbitrary wallet address, broken down by market. They are intended for operators and aggregators rather than individual traders - to query your own account use Vault balance and Trade History.
Access is restricted to bearer tokens carrying the wallet:read_any scope; tokens without it receive 403. See Authentication for how to obtain a token.
Balances cover both the wallet (ERC-20 or native) and vault (withdrawable) holdings of the base and quote tokens for every market. All balances are read at a single block for a consistent snapshot; pass blockNumber to pin the read, otherwise the current block is used and returned in the response.
GET /v0/wallets/{wallet}/balance
Volume sums the wallet's base and quote turnover per market over a half-open time range [since, until), counting trades where the wallet was taker or maker. until defaults to the current time and since to until - 7 days; the range must not exceed 40 days.
GET /v0/wallets/{wallet}/volume
Smart Wallets
Resolve smart wallets maps a signer / login externally-owned account (EOA) to the smart wallet(s) provisioned for the owning user. dreamDEX keys on-chain activity (orders, balances, volume) by the smart wallet address while users authenticate with their EOA; this endpoint bridges the two.
The mapping is looked up against the authoritative wallet provider, so it resolves even for counterfactual (not-yet-deployed) smart wallets. A 200 with an empty smartWallets array means the EOA is unknown or has no smart wallet provisioned yet. Access requires the wallet:read_any scope.