{"uid":"cap_nTC7B2K3_qX64-RuIzJGy","slug":"base-nft-metadata-uri-lookup-c9f26054","name":"Base NFT Metadata URI Lookup","description":"NFT metadata URI for an ERC721 token on Base mainnet via tokenURI - the on-chain pointer (IPFS, HTTP, or data URI), not a fetch of the document itself.","url":"https://x402.agentindex.world/base/nft-metadata?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","title":"Token"},"token_id":{"type":"integer","title":"Token Id","minimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LV8c39o2Q0iPcz3T3la2g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the tokenURI (IPFS, HTTP, or data URI) for a given ERC721 token on Base mainnet, providing the on-chain metadata pointer without fetching the document itself.","exampleAgentPrompt":"What's the tokenURI stored on-chain for token ID 1337 of the NFT contract 0xd4307e0acd12cf46fd6cf93bc264f5d5d1598792 on Base mainnet?","exampleUseCases":[{"title":"Verify NFT metadata source before purchase","prompt":"Before I buy token ID 88 from the contract 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d on Base, can you tell me where its metadata is stored — is it IPFS, a centralized server, or an on-chain data URI?"},{"title":"Build NFT gallery with metadata links","prompt":"I'm building a gallery and need the tokenURI for token IDs on Base — can you grab the on-chain metadata pointer for token 0 of the contract 0xa0cf798816d4b9b9866b5330eea46a18382f251e?"},{"title":"Debug NFT display issue","prompt":"My NFT isn't showing up correctly — can you check what tokenURI is actually stored on-chain for token ID 5 of contract 0x7d8820fa92eb1584636f4f5b8515b5476b75171a on Base mainnet so I can see if the pointer is broken?"}],"resultDescription":"Returns the raw tokenURI string as stored on-chain for the specified ERC721 token — this may be an IPFS URI (ipfs://...), an HTTP/HTTPS URL, or a base64-encoded data URI. The endpoint does NOT fetch or decode the document at that URI; it only returns the pointer itself.","failureModes":["Contract address does not exist on Base mainnet — call reverts or returns empty","Token ID does not exist or has not been minted — tokenURI call reverts","Contract is not ERC721 or does not implement tokenURI — returns error or empty string","Malformed contract address input — validation error","Network congestion or RPC timeout — slow or failed response","Token has been burned — tokenURI may revert"],"whenToPreferThis":"Choose this endpoint when you need the raw on-chain tokenURI pointer for an ERC721 NFT on Base mainnet — for example, to verify where metadata is hosted (IPFS vs centralized), to build indexers, or to check if a URI is still valid before fetching. Prefer this over off-chain NFT APIs when you need the ground-truth on-chain value rather than a cached or enriched version. If you need the actual metadata document contents (name, image, traits), you'll need to follow up by fetching the returned URI separately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:44:20.925Z","isFirstParty":false,"canonicalSlug":"base-nft-metadata-uri-lookup-c9f26054"}