A wallet's token holdings + native SOL, valued in USD — read off the chain, priced with our reconciled prices (Jupiter spot fallback, labelled per item).
Path parameters
Field
Type
Description
addressrequired
string
Wallet address (base58).
Query parameters
Field
Type
Description
networkoptional
mainnet | devnet
Network to read. Devnet returns an empty payload (with a note) until its ingestor lands. default mainnet
Response fields
Field
Type
Description
totalUsd
number
Sum of all valued holdings.
tokenCount
number
Number of holdings (incl. native SOL).
items[].mint / symbol
—
The held token.
items[].uiAmount
number
Balance held.
items[].priceUsd / valueUsd
number | null
Unit price and position value.
items[].priceSource
string | null
indexed (our price) or jupiter (spot).
items[].isNative
boolean
True for the native SOL row.
Holdings are on-chain (getTokenAccountsByOwner + native SOL). Tokens we don't index are valued at a Jupiter spot price (priceSource:"jupiter"); unpriceable ones return valueUsd null.