--- title: "Get list of NFTs" method: GET path: "/v1/nfts/" tags: ["nfts"] --- # Get list of NFTs `GET /v1/nfts/` This endpoint returns list of NFTs by using different parameters. It returns NFTs of both types - ERC721 and ERC1155. This endpoint supports testnets. To get data for testnets use `X-Env` header. > 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. ## Query parameters - `filter[references]` string - `currency` 'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf' - `include` string[] ## Headers - `X-Env` 'testnet' ## Response `200` Response for requested list of NFTs - Response16 - `links` ResponseLinks17, required - `self` string, required — Link to the current response - `data` Container5[], required - `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. - `name` string — The name of the NFT - `description` string — The description of the NFT - `tags` string[] — The list of tags associated with the NFT - `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 - `attributes` Attribute[] — The list of attributes associated with the NFT - `key` string, required — Attribute key. The key is not unique and is it possible to have several attributes with the same key. - `value` string — Attribute value - `market_data` MarketData2 - `prices` MarketDataPrices — The prices associated with the NFT expressed in the currency specified in the request parameters. - `floor` number, float — The lowest known price for the NFT. - `last_sale` LastSale — Information about last sale of the NFT. - `price` number, float — The last known sale price of the NFT in the currency specified in the request parameters. - `quantity` object — The quantity of the NFT in the last sale. - `int` string, required — Objective on-chain raw amount in base units. Use this value for building on-chain transactions. - `decimals` integer, required — Decimal number precision of the quantity - digits after the floating point. - `float` number, float, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `numeric` string, required — Ready-to-display value = int / 10^decimals. For Token-2022 ScaledUiAmount assets (a small subset of Solana tokens), the display value is int × multiplier / 10^decimals. - `external_links` ExternalLink[] — A list of relevant URLs. - `type` string — Type of the link - `name` string — Displayable name of the link - `url` string, url, required — Link to the external resource - `flags` Flags3 - `is_spam` boolean — Indicates whether the NFT spam or not. - `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. - `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_collection` object — The collection that the NFT belongs to. - `data` ContainerShort4, required - `type` string — NFT collections resource type. - `id` integer — Unique NFT collection ID. - `included` ContainerNoMarketData[] - `type` string — NFT collections resource type. - `id` integer — Unique NFT collection ID. - `attributes` ContainerAttributesNoMarketData — Represents an NFT collection attributes corresponding to JSON API specification. - `metadata` Metadata2 — Metadata associated with the NFT. - `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 - `payment_token_symbol` string — The symbol for the payment token used by the collection. - `implementations` Implementation2[] — List of blockchain implementations where this collection is deployed - `chain_id` string, required — The chain ID where the collection is deployed. - `address` string, nullable, required — The contract address of the collection on the chain. ## Other responses - `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)