Skip to main content
POST
get_wallet_token_holdings

Reading the result

The response example uses made-up values and shows selected fields. Fields vary by network and available data.
  • data lists holdings. balance is the token amount; usd_value is its USD value or "N/A" when a price is unavailable.
  • summary contains formatted currency strings. total_value_displayed covers the returned holdings and protocol positions; it is not necessarily the full wallet balance.
  • protocol_positions appears when protocol positions are available. Fields such as price, chain, and logo_url are included when available.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
wallet_address
string
required

Wallet address to analyze. Use the address format for the selected network.

network
string
required

Network to query, for example ethereum. See Supported Networks for coverage. Use all to query supported networks together.

limit
integer
default:10

Maximum number of holdings to include in the result.

Response

Token holdings (symbol, balance, USD value) for a wallet on one network or 'all'. Fields vary by network and available data. Check for status: no_data, status: error, or an error field even when HTTP status is 200. See Errors & status.

Response fields depend on the network and available data. The example shows selected fields; see Reading the result for details.