Refresh NFT Metadata

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.

contractAddressstringOptionalDefaults to 0xe785E82358879F061BC3dcAC6f0444462D4b5330

Contract address of the token you want to refresh.

tokenIdstringOptionalDefaults to 44

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.

statusstringOptional

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

estimatedMsToRefreshstringOptional

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