{"uid":"cap_eeuXbHmISk97r0SyWXkGX","slug":"nft-metadata-tokenuri-uri-lookup-648621f7","name":"NFT Metadata – tokenURI / uri Lookup","description":"Pay-per-call x402 APIs for AI agents: OpenAI-compatible LLM chat, perp funding and arbitrage spreads, crypto prices, gas, FX, Solana SPL mint audit, token price by contract, x402 delivery-receipt verification, web search, clean page extraction, batch tools and deterministic code-security scanning. USDC on Base or Solana, no signup, no API key, from $0.0001 a call.","url":"https://scanpay-edge.alextaghiashvili.workers.dev/api/v1/nft-metadata?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address","token_id"],"properties":{"address":{"type":"string"},"network":{"enum":["base","ethereum"],"type":"string"},"token_id":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"note":"token_uri is returned as-is; external URIs are not fetched.","address":"0x0000000000000000000000000000000000000001","network":"base","product":"scanpay.nft_metadata","chain_id":"eip155:8453","standard":"erc721","token_id":1,"price_usd":0.008,"token_uri":"ipfs://QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco/1","uri_scheme":"ipfs","is_contract":true,"collection_name":"Example NFT","collection_symbol":"EXMPL"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U1b4KCTTuFjjmRPsTSdLp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches ERC-721 or ERC-1155 NFT metadata (tokenURI/uri, collection name, and symbol) for a given token ID via eth_call on Base or Ethereum.","exampleAgentPrompt":"Can you look up the tokenURI, collection name, and symbol for token ID 1234 of the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?","exampleUseCases":[{"title":"Resolve NFT image for display","prompt":"What is the metadata URI for token ID 7777 of the contract 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB on Ethereum? I want to know what image it points to."},{"title":"Verify NFT collection name and symbol","prompt":"Can you confirm the collection name and symbol for the NFT contract 0x2953399124F0cBB46d2CbACD8A89cF0599974963 on Base? I need to make sure it's the right project before listing it."},{"title":"Enrich NFT portfolio with metadata","prompt":"For each of these NFTs I hold, fetch the tokenURI and collection name — token ID 5 from contract 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 on Ethereum and token ID 12 from 0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401 on Ethereum."}],"resultDescription":"Returns the tokenURI (for ERC-721) or uri (for ERC-1155) exactly as stored on-chain, plus the collection's name and symbol retrieved via eth_call — all for the specified contract address, token ID, and chain (Base or Ethereum).","failureModes":["Invalid or non-existent contract address returns an error or empty result","Token ID does not exist on the contract — may return empty/zero tokenURI","Contract does not implement ERC-721 or ERC-1155 — eth_call may revert or return unexpected data","Unsupported chain specified — only Base and Ethereum are supported","Network or RPC timeout on the underlying eth_call","Payment not processed (x402 payment required at $0.01 USDC per call)"],"whenToPreferThis":"Choose this endpoint when you need on-chain tokenURI/uri and collection name/symbol for a specific ERC-721 or ERC-1155 token on Base or Ethereum without setting up your own RPC node or indexer. It is ideal for lightweight, per-token metadata resolution where you don't need full indexing or historical data. Prefer this over general-purpose blockchain RPC endpoints when you want a single paid, low-latency call that bundles tokenURI and collection info together.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:50:58.949Z","isFirstParty":false,"canonicalSlug":"nft-metadata-tokenuri-uri-lookup-648621f7"}