Returns a list of NFT assets in a given collection.
Endpoint: getNftAssets
Method: POST
Arguments
| Name | Type | Description |
|---|---|---|
| address | String! | The contract address of the NFT collection. Required |
| cursor | String | The cursor to use for pagination. |
| fetchMissingAssets | Boolean | Whether to trigger fetching onchain metadata for missing assets. Defaults to false. Fetch results are delayed and can be ingested realtime via onNftAssetsCreated subscription. Free tier API users are limited to 1 missing asset fetch per request, and may only retry fetching a missing asset once per week. To remove these limitations, please upgrade your API plan at https://www.dashboard.defined.fi/plan. |
| limit | Int | The maximum number of NFT assets to return. |
| networkId | Int! | The network ID the NFT collection is deployed on. Required |
| tokenIds | [String] | An optional list of token IDs to filter by. |
Response
| Name | Type | Description |
|---|---|---|
| cursor | String | A cursor for use in pagination. |
| itemErrors | [NftAssetError] | A list of errors encountered while fetching the NFT assets. Errors correspond to null values in items by array index. |
| items | [NftAsset] | A list of NFT assets. |
| Name | Type | Description |
|---|---|---|
| address | String! | The contract address of the NFT collection. |
| attributes | [NftAssetAttribute!] | The attributes for the NFT asset. |
| description | String | The description of the NFT asset. |
| id | String! | The ID of the NFT asset (address:networkId). |
| media | NftAssetMedia | The NFT asset media. |
| name | String | The name of the NFT asset. |
| networkId | Int! | The network ID the NFT collection is deployed on. |
| originalImage | String | The source image URI linked by smart contract metadata. |
| quantity | String | The number of NFT assets with the same NFT token ID. Only applicable for ERC1155 tokens. |
| tokenId | String! | The token ID of the NFT asset. |
| uri | String | The URI provided by the smart contract. Typically JSON that contains metadata. |
Explore
Ask questions, share what you're working on and request new features 👬👭