NFT Metadata By Token ID [Batch]

1 import requests 2 3 url = "https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/getNFTMetadataBatch" 4 5 payload = { "tokens": [ 6 { 7 "contractAddress": "0xe785E82358879F061BC3dcAC6f0444462D4b5330", 8 "tokenId": "44" 9 } 10 ] } 11 headers = {"Content-Type": "application/json"} 12 13 response = requests.post(url, json=payload, headers=headers) 14 15 print(response.json())

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 objectsRequired

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.

contractobject or null

The contract object that has details of a contract

tokenIdstring or nullDefaults to 44

tokenTypestring or null

namestring or null

String - Name of the NFT asset.

descriptionstring or null

String - Brief human-readable description

imageobject or null

Details of the image corresponding to this contract

rawobject or null

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

collectionobject or null

The collection object that has details of a collection

tokenUristring or null

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.

timeLastUpdatedstring or null

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

acquiredAtobject or null

Only present if the request specified orderBy=transferTime.