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.

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.

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