{"uid":"cap_79xwZLUjERiebUHWoqm0V","slug":"ethereum-nft-metadata-resolver-ab6b94c6","name":"Ethereum NFT Metadata Resolver","description":"Call when an agent needs parsed ERC-721 or ERC-1155 metadata for an Ethereum contract and token id. The URI is fetched only from fixed IPFS and Arweave gateways, or parsed from a data JSON URI. ERC-1155 substitutes {id}. No arbitrary URL. Send JSON {\"contract\":\"0x1111111111111111111111111111111111111111\",\"token_id\":\"1\"}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/eth-nft-metadata first.","url":"https://agentshelf.syntexa.ch/v1/eth-nft-metadata?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"contract":{"type":"string","examples":["0x1111111111111111111111111111111111111111"],"description":"NFT contract on Ethereum mainnet. Example: 0x1111111111111111111111111111111111111111. tokenURI or uri is read-only."},"standard":{"enum":["erc721","erc1155"],"type":"string","default":"erc721","description":"Token standard. erc721 (default) uses ownerOf or tokenURI. erc1155 uses balanceOf(owner, id) or uri(id) with {id} substitution."},"token_id":{"type":"string","pattern":"^(0|[1-9]\\d*)$","examples":["1"],"description":"Token id as a decimal integer. Example: 1. ERC-1155 substitutes this id into {id} in the URI. A missing token errors."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ULfNzmH7Dd8pXKbszxokh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and parses on-chain ERC-721 or ERC-1155 token metadata (name, image, attributes, etc.) for a given Ethereum contract address and token ID, resolving only from IPFS, Arweave, or data URIs.","exampleAgentPrompt":"Can you fetch the metadata for token ID 1 of the ERC-721 contract at 0x1111111111111111111111111111111111111111 on Ethereum — I want to see the name, image, and any traits?","exampleUseCases":[{"title":"NFT trait lookup for rarity analysis","prompt":"Pull the metadata for token ID 4269 on the ERC-721 contract at 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D — I need to see all the attributes and traits listed for it."},{"title":"ERC-1155 game item metadata retrieval","prompt":"Fetch the metadata for token ID 37 on the ERC-1155 contract at 0x76BE3b62873462d2142405439777e971754E8E4 so I can see the item name, description, and image."},{"title":"NFT portfolio display enrichment","prompt":"I have a list of NFTs in a wallet and need to display them nicely — can you get the metadata for token ID 12 on contract 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB using the ERC-721 standard so I can show the image and name?"}],"resultDescription":"A parsed JSON object containing the NFT token's metadata fields such as name, description, image URL, animation URL, external URL, and an array of attributes/traits, resolved from IPFS, Arweave, or an inline data URI.","failureModes":["Invalid or non-existent contract address returns an error","Token ID does not exist on the contract returns an error","Token URI points to an unsupported gateway (not IPFS or Arweave) returns an error","Malformed or unparseable metadata JSON at the resolved URI returns an error","Missing or incorrect token standard causes wrong ABI call and an error","Unpaid or underpaid request returns a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need to resolve and parse NFT token metadata from Ethereum mainnet for ERC-721 or ERC-1155 tokens, especially when the metadata is stored on IPFS or Arweave. It is preferable to calling the blockchain and IPFS yourself because it handles {id} substitution for ERC-1155, gateway resolution, and JSON parsing in one step. Best for agents that need structured NFT metadata (name, image, attributes) without managing raw RPC calls or IPFS gateway logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:04.187Z","isFirstParty":false,"canonicalSlug":"ethereum-nft-metadata-resolver-ab6b94c6"}