--- title: "Get wallet NFT positions" method: GET path: "/v1/wallets/{address}/nft-positions/" tags: ["wallets"] --- # Get wallet NFT positions `GET /v1/wallets/{address}/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. ## Path parameters - `address` union, required — A wallet address, which can be either an EVM or Solana address - string — Ethereum-compatible address (EVM). - string — Solana address ## Query parameters - `filter[chain_ids]` string[] - `filter[collections_ids]` integer[] - `sort` 'created_at' | '-created_at' | 'floor_price' | '-floor_price' - `include` string[] - `currency` 'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf' - `page` object - `after` string, 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. - `size` integer — Set maximum number of items per a page in the pagination. ## Headers - `X-Env` 'testnet' ## Response `200` Response for requested list of NFT positions. - ResponseMany - `links` ResponseManyLinks, required - `self` string, url, required - `data` Container8[], required - `type` string, required — NFT positions resource type. - `id` string, required — NFT position's unique ID. - `attributes` Attributes6, required - `changed_at` string — The date and the time when the position was updated in ISO format. - `amount` string — The quantity of the NFT position. - `price` number, float — The lowest price (floor) of the position's NFT. Measured in the requested currency. - `value` number, float — The lowest value of the NFT position (floor). Measured in the requested currency. - `nft_info` Info2 - `contract_address` string, required — Address of the contract of the NFT. - `token_id` string, required — Unique identifier of the NFT inside the contract. - `name` string, required — Name of the NFT. - `interface` 'erc721' | 'erc1155', required — The standard that the NFT contract follows, e.g. ERC-721. - `content` Content - `preview` object — The URL of the preview image - `url` string, url, required — URL to the content - `content_type` string — MIME content type - `detail` object — The URL of the full-size image - `url` string, url, required — URL to the content - `content_type` string — MIME content type - `audio` object — The URL of the audio file - `url` string, url, required — URL to the content - `content_type` string — MIME content type - `video` object — The URL of the video file - `url` string, url, required — URL to the content - `content_type` string — MIME content type - `flags` Flags3, required - `is_spam` boolean — Indicates whether the NFT spam or not. - `collection_info` Info3 — Represents an NFT collection short info. - `name` string — The name of the collection. - `description` string — The description of the collection. - `content` Content2 - `icon` object — Icon related to object. - `url` string, url, nullable — URL of the icon. - `banner` object — The URL for the collection's banner image. - `url` string, url, required — URL to the content - `content_type` string — MIME content type - `relationships` Relationships3 - `chain` object, required — The blockchain on which the NFT position exists. - `links` RelationshipLinks, required - `related` string, url, required — URL to the current chain. - `data` ContainerShort, required - `type` string, required — Chain resource type. - `id` string, required — Chain unique identifier. - `nft` object — The NFT which represents the position. - `data` ContainerShort3, required - `type` string, required — NFTs resource type. - `id` string, required — Unique identifier of the NFT. - `nft_collection` object, required — The NFT collection which the NFT belongs to. - `data` ContainerShort4, required - `type` string — NFT collections resource type. - `id` integer — Unique NFT collection ID. - `included` union[] - union - Container5 — Represents a non-fungible token (NFT). - `type` string, required — NFTs resource type. - `id` string, required — Unique identifier of the NFT. - `attributes` Attributes7 — Represents attributes of a non-fungible token (NFT) corresponding to JSON API specification. - `contract_address` string, required — The address of the contract that manages the NFT. - `token_id` string, required — The unique identifier for the NFT within its contract. - `interface` 'erc721' | 'erc1155' — The standard that the NFT contract follows, e.g. ERC-721. - `metadata` Metadata — Metadata associated with the NFT. - … - `market_data` MarketData2 - … - `external_links` ExternalLink[] — A list of relevant URLs. - … - `flags` Flags3 - … - `relationships` Relationships4 — Represents relationships of a non-fungible token (NFT) corresponding to JSON API specification. - `chain` object, required — The blockchain on which the NFT exists. - … - `nft_collection` object — The collection that the NFT belongs to. - … - Container6 - `type` string — NFT collections resource type. - `id` integer — Unique NFT collection ID. - `attributes` ContainerAttributes — Represents an NFT collection attributes corresponding to JSON API specification. - `metadata` Metadata2 — Metadata associated with the NFT. - … - `market_data` MarketData3 — Contains marketplace data for a collection of NFTs. - … - `implementations` Implementation2[] — List of blockchain implementations where this collection is deployed - … - Container7 — The NFT collection held by the wallet. - `type` string, required — NFT collection resource type. - `id` integer, required — NFT collection's unique ID. - `attributes` Attributes8, required - `min_changed_at` string, nullable — The earliest `changed_at` date and time alongside all wallet's positions from the collection. - `max_changed_at` string, nullable — The most recent `changed_at` date and time alongside all wallet's positions from the collection. - `nfts_count` string, required — The total quantity of the wallet's NFT positions from the collection. - `total_floor_price` number, float, required — The lowest price (floor) of the all wallet's NFTs positions from the collection. Measured in the requested currency. - `collection_info` Info3 — Represents an NFT collection short info. - … - `relationships` Relationships5 - `chains` Relationship[], required — The blockchain on which the NFT collection exists. - … - `nft_collection` object, required — The NFT collection itself. - … ## Other responses - `202` — Request accepted, but NFT positions are still being aggregated. - `400` — Parameters are malformed - `401` — Unathenticated request - `429` — Too many requests error --- [API](https://skmtc.dev/zerion/apis/rest-api.md) · [All operations](https://skmtc.dev/zerion/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zerion/rest-api/revisions/2ef116ef914f/schema)