NFT APINFT API EndpointsNft Metadata Endpoints

NFT Metadata By Token ID

getNFTMetadata - Retrieves the metadata associated with a specific NFT. 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](https://dashboard.alchemy.com/chains).

Path parameters

apiKeystringRequiredDefaults to docs-demo

Query parameters

contractAddressstringRequiredDefaults to 0xe785E82358879F061BC3dcAC6f0444462D4b5330

String - Contract address for the NFT contract (ERC721 and ERC1155 supported).

tokenIdstringRequiredDefaults to 44

String - The ID of the token. Can be in hex or decimal format.

tokenTypestringOptional

String - ‘ERC721’ or ‘ERC1155’; specifies type of token to query for. API requests will perform faster if this is specified.

tokenUriTimeoutInMsintegerOptional

No set timeout by default - When metadata is requested, this parameter is the timeout (in milliseconds) for the website hosting the metadata to respond. If you want to only access the cache and not live fetch any metadata for cache misses then set this value to 0.

refreshCachebooleanOptionalDefaults to false
Defaults to false for faster response times. If true will refresh metadata for given token. If false will check the cache and use it or refresh if cache doesn't exist.

Response

Returns the metadata of the specified NFT.
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.

animationobject or null
mintobject or null
ownerslist of strings or null
List of all addresses that own the given NFT.