{"uid":"cap_BOvsAW3azQ99tJH5NRV86","slug":"erc721-token-metadata-uri-lookup-c2c41f5d","name":"ERC721 Token Metadata URI Lookup","description":"Metadata URI for one ERC721 token — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/erc721-token-uri?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string"},"tokenId":{"type":"integer","minimum":0},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"erc721-token-uri","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.003,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kx_LqQ1McWVW-fD2Xhm9d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the metadata URI for a specific ERC721 NFT token by contract address and token ID on supported EVM chains","exampleAgentPrompt":"What is the metadata URI for token ID 1337 of the ERC721 contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?","exampleUseCases":[{"title":"NFT metadata discovery for marketplace","prompt":"Can you fetch the metadata URI for token ID 5000 of the contract 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB on Ethereum? I need to know where its JSON metadata is hosted."},{"title":"Cross-chain NFT metadata audit","prompt":"I need to check the token URI for token 1 on the ERC721 contract 0x23581767a106ae21c074b2276D25e5C3e136a68b on Base — can you pull that for me?"},{"title":"NFT rarity tool data pipeline","prompt":"Pull the metadata URI for token ID 888 of the NFT contract 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 on Polygon so I can fetch its traits."}],"resultDescription":"Returns a JSON object containing ok status, the type field 'erc721-token-uri', a payment receipt with transaction hash, USD amount, and receipt ID, plus a generated_at ISO 8601 timestamp. The core output is the token URI string pointing to the NFT's metadata (typically an IPFS or HTTPS URL).","failureModes":["Invalid contract address format (must be 0x-prefixed 40-hex address)","Token ID does not exist on the specified contract","Contract is not an ERC721 contract or does not implement tokenURI","Chain not in supported list (ethereum, base, polygon, arbitrum, optimism, bsc, avalanche, gnosis, linea, scroll)","RPC node unavailability or timeout for the requested chain","Payment failure or insufficient x402 funds"],"whenToPreferThis":"Use this endpoint when you need the raw tokenURI from an ERC721 contract on any of the ten supported EVM chains and want a paid, reliable API call with a receipt — especially when you don't have direct RPC access or want a chain-abstracted, multi-network solution without managing your own node connections.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:35:32.690Z","isFirstParty":false,"canonicalSlug":"erc721-token-metadata-uri-lookup-c2c41f5d"}