NFT Metadata By Token ID [Batch]

POST

/v3/{apiKey}/getNFTMetadataBatch

getNFTMetadataBatch - Retrieves metadata for up to 100 specified NFT contracts in a single request. This endpoint is supported on Ethereum and many L2s, including Polygon, Arbitrum, Optimism, Base, World Chain and more. See the full list of supported networks here.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request Body

Responses

200

Returns an array of NFT metadata corresponding to the batch query.

Array of NFT objects corresponding to the query

POST/nft/v3/{apiKey}/getNFTMetadataBatch

curl --request POST \  --url https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/getNFTMetadataBatch \  --header 'Content-Type: application/json' \  --data '{  "tokens": [    {      "contractAddress": "0xe785E82358879F061BC3dcAC6f0444462D4b5330",      "tokenId": "44",      "tokenType": "string"    }  ],  "tokenUriTimeoutInMs": 1,  "refreshCache": false}'

200Returns an array of NFT metadata corresponding to the batch query.

[  {    "contract": {      "address": "string",      "name": "string",      "symbol": "string",      "totalSupply": "string",      "tokenType": "ERC721",      "contractDeployer": "string",      "deployedBlockNumber": 1,      "openseaMetadata": {        "floorPrice": 1,        "collectionName": "string",        "safelistRequestStatus": "string",        "imageUrl": "string",        "description": "string",        "externalUrl": "string",        "twitterUsername": "string",        "discordUrl": "string",        "bannerImageUrl": "string",        "lastIngestedAt": "string"      },      "isSpam": "string",      "spamClassifications": [        "string"      ]    },    "tokenId": "44",    "tokenType": "string",    "name": "string",    "description": "string",    "image": {      "cachedUrl": "string",      "thumbnailUrl": "string",      "pngUrl": "string",      "contentType": "string",      "size": 1,      "originalUrl": "string"    },    "raw": {      "tokenUri": "string",      "metadata": {        "image": "string",        "name": "string",        "description": "string",        "attributes": [          {            "value": "string",            "trait_type": "string"          }        ]      },      "error": "string"    },    "collection": {      "name": "string",      "slug": "string",      "externalUrl": "string",      "bannerImageUrl": "string"    },    "tokenUri": "string",    "timeLastUpdated": "string",    "acquiredAt": {      "blockTimestamp": "string",      "blockNumber": "string"    },    "animation": {      "cachedUrl": "string",      "contentType": "string",      "size": 1,      "orginalUrl": "string"    },    "mint": {      "mintAddress": "string",      "blockNumber": 1,      "timestamp": "string",      "transactionHash": "string"    },    "owners": [      "string"    ]  }]

Was this page helpful?