ZEzerion
wallets

Get wallet NFT positions

Changed on

Returns the NFT positions 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-positions/

Request

  • Base URL
    https://api.zerion.io
  • URL
    https://api.zerion.io/v1/wallets/{address}/nft-positions/
  • 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 positions 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"
]
filter[collections_ids]integer[]

Keep only positions from these collection IDs (comma-separated list). The IDs are returned in the collection field of each NFT.

sort'created_at' | '-created_at' | 'floor_price' | '-floor_price'
Example:-floor_price

Sort order for the results.

includestring[]

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

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

Denominated currency value of returned prices

afterstring nullable

This field is used for result pagination. You SHOULD NOT use this parameter directly. To get the next page of the results you should use links.next field. Omit it to return the first page.

sizeinteger

Set maximum number of items per a page in the pagination.

Pagination parameters

Headers

X-Env'testnet'

Set to testnet to return testnet data instead of mainnet.

Response

Response for requested list of NFT positions.

Changes

  • 719a229a555dRevision changes
    • breaking

      added the pattern ^0x[a-fA-F0-9]{40}$ to the path request parameter address

    • info

      for the path request parameter address, the type was generalized from no type to string