Refresh NFT Metadata | Alchemy Docs

Submits a request for Alchemy to refresh the cached metadata of a specific NFT token.

Please note that this endpoint is only supported on Ethereum (Mainnet & Sepolia), Polygon (Mainnet, Mumbai & Amoy), Arbitrum One (mainnet), Optimism (mainnet) & Base (mainnet). For other chains, you could use the getNFTMetadata endpoint with the refreshCache parameter set to true to refresh the metadata!

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.

contractAddressstringRequired

Contract address of the token you want to refresh.

tokenIdstringRequired

Token ID of the token you want to refresh. Must belong to the contract address.

Response

Returns the status of the refresh request along with the estimated time to complete.

statusstring or null

If the token is successfully queued for ingestion the value will be "Queued".

estimatedMsToRefreshstring or null

Estimated time until the metadata refresh is complete for this token.

1	import requests
2
3	url = "https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/refreshNftMetadata"
4
5	payload = {
6	"contractAddress": "0xe785E82358879F061BC3dcAC6f0444462D4b5330",
7	"tokenId": "44"
8	}
9	headers = {"Content-Type": "application/json"}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())