ZEzerion
wallets

Get wallet NFT portfolio

Returns the NFT portfolio overview of a wallet.

First request for a new wallet. If the address has not been indexed before, this endpoint returns a 202 while the data is being prepared. Poll until you get a 200, and give up after about two minutes: past that, a 202 almost always means something went wrong rather than that the wallet is still loading.

See also: Testnets (X-Env: testnet)

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

Request

  • Base URL
    https://api.zerion.io
  • URL
    https://api.zerion.io/v1/wallets/{address}/nft-portfolio
  • Auth
    HTTP basic

Path parameters

addressstring required

Ethereum-compatible address (EVM).

Example:0x42b9df65b219b3dd36ff330a4dd8f327a6ada990

The web3 wallet address. Must be a valid EVM address. Returns 400 if the address is not one Zerion tracks, such as a token contract, router or exchange hot wallet. Smart-contract wallets like Safe and ERC-4337 accounts are tracked as normal.

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'

Set to testnet to return testnet data instead of mainnet.

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
      }
    }
  }
}

Changes