{"uid":"cap_3n0mHkhHlU9Tn8CXPa4zk","slug":"agent-data-tools-revmesh2074-workers-dev-ethereum-nft-metadata-32dfd0ba","name":"Ethereum NFT Metadata","description":"NFT metadata on Ethereum: the token URI of one ERC-721 token id (tokenURI) and the JSON it points to (name, description, image, attributes), read from data: URIs, https or ipfs:// (through ipfs.io). Strings over 1,000 characters, such as on-chain SVG images, are shortened. Use to show or check what an NFT is; for its owner use eth_nft_owner. A token that does not exist is 422, uncharged; unreachable metadata is reported in metadataError.","url":"https://agent-data-tools.revmesh2074.workers.dev/eth/nft-metadata?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["contract","tokenId"],"properties":{"tokenId":{"type":"string","description":"Token id, a whole number"},"contract":{"type":"string","description":"0x ERC-721 collection contract address"}}},"responseSchema":{"type":"object","properties":{"name":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"chainId":{"type":"number"},"tokenId":{"type":"string"},"contract":{"type":"string"},"metadata":{"type":"object","properties":{"name":{"type":"string"},"image":{"type":"string"},"description":{"type":"string"}}},"tokenUri":{"type":"string"},"metadataError":{},"metadataSource":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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_Uvvt4kF8RI4xeu85fvbsy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Fetches the token URI and resolved JSON metadata (name, description, image, attributes) for a specific ERC-721 NFT on Ethereum mainnet.","exampleAgentPrompt":"Can you look up the metadata for Ethereum NFT token #1 from the Bored Ape Yacht Club contract at 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D — I want to see its name, image, and traits.","exampleUseCases":[{"title":"Display NFT in a gallery app","prompt":"Show me all the metadata for token ID 42 from the CryptoPunks contract at 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB on Ethereum — name, image, and any attributes."},{"title":"Verify NFT authenticity and traits","prompt":"Can you fetch the on-chain metadata for Ethereum ERC-721 token #7777 at contract 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 and tell me what its rarity traits are?"},{"title":"Debug unreachable NFT metadata","prompt":"I'm building a marketplace and need to check if token #500 of the contract 0xED5AF388653567Af2F388E6224dC7C4b3241C544 on Ethereum has reachable metadata — can you pull its tokenURI and any metadata errors?"}],"resultDescription":"Returns a JSON object containing the token's contract address, token ID, chain name, chain ID, symbol, tokenUri, and a resolved metadata object with name, description, and image fields. If the metadata could not be fetched, a metadataError field explains why. Strings longer than 1,000 characters (e.g. on-chain SVGs) are truncated.","failureModes":["Token does not exist — returns HTTP 422, no charge","Metadata URL unreachable (IPFS gateway timeout, dead HTTPS link) — returns metadataError field in response","Invalid contract address format — returns validation error","Contract is not ERC-721 — tokenURI call may revert or return unexpected data","Very long on-chain metadata (SVG) truncated at 1,000 characters"],"whenToPreferThis":"Use this endpoint when you need the descriptive metadata (name, image, description, attributes) for a specific ERC-721 token on Ethereum mainnet. It automatically handles data: URIs, HTTPS URLs, and IPFS links. Prefer it over general blockchain RPC calls when you want resolved, human-readable NFT metadata without writing your own IPFS or URI parsing logic. For ownership queries, use the companion eth_nft_owner endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:34:58.012Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-ethereum-nft-metadata-32dfd0ba"}