Sign in

v1

latestOpenAPI 3.0.32026-07-2639188178.2 KB
wallets

Get wallet NFT positions

This endpoint returns a list of the NFT positions held by a specific wallet.

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

If the wallet address has not been previously added, this endpoint may return a 202 status code. This indicates that the wallet's positions are not yet available, but will be in the near future. In this case, the client should periodically request this endpoint until a 200 status code is returned.

NOTE: It is important to stop retrying after a reasonable period of time. If a 200 status code is not returned within 2 minutes, it is likely that an unexpected error has occurred and the client should stop polling.

NOTE: This endpoint provides support for filters, sorting, and pagination parameters. Ensure that the length of the request URL falls within a safe range for your platform. Typically, a length of 2000 characters is a safe limit for most combinations of client and server software.

NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.

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

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

filter[chain_ids]string[]

Keep only positions from the specified chains (comma-separated list). Available chains IDs can be found in chains endpoint.

[
  "ethereum",
  "polygon"
]
filter[collections_ids]integer[]

Keep only positions from collections with specified IDs (comma-separated list). The IDs are returned inside the 'collection' field of each NFT.

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

The order of NFTs in the result.

includestring[]

Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.

[
  "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'

Custom header that allows you to get data for testnets.

Response

Response for requested list of NFT positions.