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.

Path parameters

apiKeystringRequired

Query parameters

contractAddressstringRequired

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

tokenIdstringRequired

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.

contractobjectOptional

The contract object that has details of a contract

tokenIdstringOptionalDefaults to 44

tokenTypestringOptional

namestringOptional

String - Name of the NFT asset.

descriptionstringOptional

String - Brief human-readable description

imageobjectOptional

Details of the image corresponding to this contract

rawobjectOptional

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

collectionobjectOptional

The collection object that has details of a collection

tokenUristringOptional

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.

timeLastUpdatedstringOptional

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

acquiredAtobjectOptional

Only present if the request specified orderBy=transferTime.

1	{
2	"contract": {
3	"address": "foo",
4	"name": "foo",
5	"symbol": "foo",
6	"totalSupply": "foo",
7	"tokenType": "ERC721",
8	"contractDeployer": "foo",
9	"deployedBlockNumber": 42,
10	"openseaMetadata": {
11	"floorPrice": 42,
12	"collectionName": "foo",
13	"safelistRequestStatus": "foo",
14	"imageUrl": "foo",
15	"description": "foo",
16	"externalUrl": "foo",
17	"twitterUsername": "foo",
18	"discordUrl": "foo",
19	"lastIngestedAt": "foo"
20	},
21	"isSpam": "foo",
22	"spamClassifications": [
23	"foo"
24	]
25	},
26	"tokenId": "44",
27	"tokenType": "foo",
28	"name": "foo",
29	"description": "foo",
30	"image": {
31	"cachedUrl": "foo",
32	"thumbnailUrl": "foo",
33	"pngUrl": "foo",
34	"contentType": "foo",
35	"size": 42,
36	"originalUrl": "foo"
37	},
38	"raw": {
39	"tokenUri": "foo",
40	"metadata": {
41	"image": "foo",
42	"name": "foo",
43	"description": "foo",
44	"attributes": [
45	{
46	"value": "foo",
47	"trait_type": "foo"
48	}
49	]
50	},
51	"error": "foo"
52	},
53	"collection": {
54	"name": "foo",
55	"slug": "foo",
56	"externalUrl": "foo",
57	"bannerImageUrl": "foo"
58	},
59	"tokenUri": "foo",
60	"timeLastUpdated": "foo",
61	"acquiredAt": {
62	"blockTimestamp": "foo",
63	"blockNumber": "foo"
64	}
65	}

1	curl -G https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/getNFTMetadata \
2	-d contractAddress=0xe785E82358879F061BC3dcAC6f0444462D4b5330 \
3	-d tokenId=44