Sign in

v1

latestOpenAPI 3.0.32026-07-2639188178.2 KB
wallets

Get wallet NFT portfolio

This endpoint returns the NFT portfolio overview of a web3 wallet.

This endpoint supports testnets. To get data for testnets use X-Env header.

If the address was not added before it is possible that this endpoint will return 202 status. It means that portfolio for the wallet is not prepared yet, but will be available soon. In that case the client have to request this endpoint periodically, while 200 status wasn't returned.

NOTE: Don't forget to stop retries after some reasonable period of time. If the 200 status is not returned within 2 minutes it most probably means that some unexpected error occurred and the client should stop the polling.

get/v1/wallets/{address}/nft-portfolio

Path parameters

string required

Ethereum-compatible address (EVM).

OR
string required

Solana address

Example:0x42b9df65b219b3dd36ff330a4dd8f327a6ada990

The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion.

Query parameters

currency'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'

Denominated currency value of returned prices

Headers

X-Env'testnet'

Custom header that allows you to get data for testnets.

Response

Response for requested wallet's portfolio

Example response

{
  "links": {
    "self": "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/nft-portfolio/?currency=usd"
  },
  "data": {
    "type": "wallet_nft_portfolio",
    "id": "nft-portfolio-0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
    "attributes": {
      "positions_distribution_by_chain": {
        "arbitrum": 140.14877478334236,
        "aurora": 75.59585404617037,
        "avalanche": 54.39483513803602,
        "binance-smart-chain": 1439.98965199211,
        "ethereum": 1439.98965199211,
        "fantom": 104.5039957833603,
        "optimism": 55.111921042409875,
        "polygon": 37.55943746454931,
        "xdai": 74.08441891963194
      }
    }
  }
}