getNFTMetadataBatch | Alchemy Docs

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

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 objectsOptional

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

tokenUriTimeoutInMsintegerOptional

refreshCachebooleanOptionalDefaults to false

Response

contractobjectOptional

Object - Contract for returned NFT

idobjectOptional

balancestringOptional

String - Token balance

titlestringOptional

String - Name of the NFT asset.

descriptionstringOptional

String - Brief human-readable description

tokenUriobjectOptional

mediaobjectOptional

metadataobjectOptional

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.

timeLastUpdatedstringOptional

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

errorstringOptional

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

contractMetadataobjectOptional

spamInfoobjectOptional

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

acquiredAtobjectOptional

Only present if the request specified orderBy=transferTime.