ZEzerion
wallets

Get wallet NFT collections

Returns the NFT collections held by 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) · Filtering and the 2000-character URL limit · Resource IDs

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

Request

  • Base URL
    https://api.zerion.io
  • URL
    https://api.zerion.io/v1/wallets/{address}/nft-collections/
  • 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

filter[chain_ids]string[]

Keep only collections from the specified chains (comma-separated list). Only chains reporting supports_nft_positions in the flags of GET /v1/chains/ are accepted here. Naming a chain that fails that gate returns 400 rather than an empty result, with detail reading chain <id> does not support NFT positions (for example chain bob does not support NFT positions). When the filter is omitted, chains that fail the gate are left out of data silently, with no error and no meta signal.

[
  "ethereum",
  "polygon"
]
sort'-max_changed_at' | 'min_changed_at' | 'total_floor_price' | '-total_floor_price'
Example:-total_floor_price

The order of NFTs in the result.

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

Denominated currency value of returned prices

includestring[]

Related resources to include in the response (comma-separated list), following the JSON:API include convention.

[
  "nft_collections"
]

Headers

X-Env'testnet'

Set to testnet to return testnet data instead of mainnet.

Response

Response for requested list of NFT collections.

Example response

{
  "links": {
    "self": "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/nft-collections/"
  },
  "data": [
    {
      "type": "wallet_nft_collections",
      "id": 14,
      "attributes": {
        "min_changed_at": "2020-02-28T19:24:39Z",
        "max_changed_at": "2023-02-28T19:24:39Z",
        "nfts_count": "1",
        "collection_info": {
          "content": {
            "icon": {
              "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
            },
            "banner": {
              "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
              "content_type": "image/png"
            }
          }
        }
      },
      "relationships": {
        "chains": [
          {
            "links": {
              "related": "https://api.zerion.io/v1/chains/polygon"
            },
            "data": {
              "type": "chains",
              "id": "polygon"
            }
          }
        ],
        "nft_collection": {
          "data": {
            "type": "nft_collections",
            "id": 14
          }
        }
      },
      "included": [
        {
          "type": "nft_collections",
          "id": 14,
          "attributes": {
            "metadata": {
              "content": {
                "icon": {
                  "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
                },
                "banner": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                }
              }
            },
            "implementations": [
              {
                "chain_id": "ethereum",
                "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
              }
            ]
          }
        }
      ]
    }
  ]
}

Changes