NFT Metadata By Token ID [Batch]

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.
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.