getNFTMetadataBatch | Alchemy Docs

1 import requests 2 3 url = "https://eth-mainnet.g.alchemy.com/nft/v2/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 }, 6 "id": { 7 "tokenId": "44", 8 "tokenMetadata": { 9 "tokenType": "ERC721" 10 } 11 }, 12 "balance": "foo", 13 "title": "foo", 14 "description": "foo", 15 "tokenUri": { 16 "raw": "foo", 17 "gateway": "foo" 18 }, 19 "media": { 20 "raw": "foo", 21 "gateway": "foo", 22 "thumbnail": "foo", 23 "format": "foo", 24 "bytes": 42 25 }, 26 "metadata": { 27 "image": "foo", 28 "external_url": "foo", 29 "background_color": "foo", 30 "name": "foo", 31 "description": "foo", 32 "attributes": [ 33 { 34 "value": "foo", 35 "trait_type": "foo" 36 } 37 ], 38 "media": [ 39 { 40 "raw": "foo", 41 "gateway": "foo", 42 "thumbnail": "foo", 43 "format": "foo", 44 "bytes": 42 45 } 46 ] 47 }, 48 "timeLastUpdated": "foo", 49 "error": "foo", 50 "contractMetadata": { 51 "name": "foo", 52 "symbol": "foo", 53 "totalSupply": "foo", 54 "tokenType": "ERC721", 55 "contractDeployer": "foo", 56 "deployedBlockNumber": 42, 57 "opensea": { 58 "floorPrice": 42, 59 "collectionName": "foo", 60 "safelistRequestStatus": "foo", 61 "imageUrl": "foo", 62 "description": "foo", 63 "externalUrl": "foo", 64 "twitterUsername": "foo", 65 "discordUrl": "foo", 66 "lastIngestedAt": "foo" 67 } 68 }, 69 "spamInfo": { 70 "isSpam": "foo", 71 "spamClassifications": [ 72 "foo" 73 ] 74 }, 75 "acquiredAt": { 76 "blockTimestamp": "foo", 77 "blockNumber": "foo" 78 } 79 } 80 ]

Gets the metadata associated with up to 100 given NFT contracts.

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

contractobject or null

Object - Contract for returned NFT

idobject or null

balancestring or null

String - Token balance

titlestring or null

String - Name of the NFT asset.

descriptionstring or null

String - Brief human-readable description

tokenUriobject or null

mediaobject or null

metadataobject or null

Relevant metadata for NFT contract. This is useful for viewing image url, traits, etc. without having to follow the metadata url in tokenUri to parse manually.

timeLastUpdatedstring or null

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

errorstring or null

String - A string describing a particular reason that we were unable to fetch complete metadata for the NFT.

contractMetadataobject or null

spamInfoobject or null

Information about whether and why a contract was marked as spam.

acquiredAtobject or null

Only present if the request specified orderBy=transferTime.