NFT Metadata By Token ID [Batch]

1 curl -X POST https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/getNFTMetadataBatch \ 2 -H "Content-Type: application/json" \ 3 -d '{}'

1 [ 2 { 3 "contract": { 4 "address": "foo", 5 "name": "foo", 6 "symbol": "foo", 7 "totalSupply": "foo", 8 "tokenType": "ERC721", 9 "contractDeployer": "foo", 10 "deployedBlockNumber": 42, 11 "openseaMetadata": { 12 "floorPrice": 42, 13 "collectionName": "foo", 14 "safelistRequestStatus": "foo", 15 "imageUrl": "foo", 16 "description": "foo", 17 "externalUrl": "foo", 18 "twitterUsername": "foo", 19 "discordUrl": "foo", 20 "lastIngestedAt": "foo" 21 }, 22 "isSpam": "foo", 23 "spamClassifications": [ 24 "foo" 25 ] 26 }, 27 "tokenId": "44", 28 "tokenType": "foo", 29 "name": "foo", 30 "description": "foo", 31 "image": { 32 "cachedUrl": "foo", 33 "thumbnailUrl": "foo", 34 "pngUrl": "foo", 35 "contentType": "foo", 36 "size": 42, 37 "originalUrl": "foo" 38 }, 39 "raw": { 40 "tokenUri": "foo", 41 "metadata": { 42 "image": "foo", 43 "name": "foo", 44 "description": "foo", 45 "attributes": [ 46 { 47 "value": "foo", 48 "trait_type": "foo" 49 } 50 ] 51 }, 52 "error": "foo" 53 }, 54 "collection": { 55 "name": "foo", 56 "slug": "foo", 57 "externalUrl": "foo", 58 "bannerImageUrl": "foo" 59 }, 60 "tokenUri": "foo", 61 "timeLastUpdated": "foo", 62 "acquiredAt": { 63 "blockTimestamp": "foo", 64 "blockNumber": "foo" 65 } 66 } 67 ]

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

apiKeystringRequired

Request

This endpoint expects an object.

tokenslist of objectsOptional

List of token objects to batch request NFT metadata for. Maximum 100.

tokenUriTimeoutInMsintegerOptional

refreshCachebooleanOptionalDefaults to false

Response

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

contractobjectOptional

The contract object that has details of a contract

tokenIdstringOptionalDefaults to 44

tokenTypestringOptional

namestringOptional

String - Name of the NFT asset.

descriptionstringOptional

String - Brief human-readable description

imageobjectOptional

Details of the image corresponding to this contract

rawobjectOptional

Raw details of the NFT like its tokenUri and metadata info obtained directly from the smart contract

collectionobjectOptional

The collection object that has details of a collection

tokenUristringOptional

String - Uri representing the location of the NFT’s original metadata blob. This is a backup for you to parse when the metadata field is not automatically populated.

timeLastUpdatedstringOptional

String - ISO timestamp of the last cache refresh for the information returned in the metadata field.

acquiredAtobjectOptional

Only present if the request specified orderBy=transferTime.