{"uid":"cap_2Ph2KPRj2ZO7WIi7v3hrN","slug":"ethereum-nft-token-metadata-75e48c66","name":"Ethereum NFT Token Metadata","description":"Pay-per-call data for AI agents, paid in USDC on Base with x402: token risk checks (rug check) on Base, Ethereum, Arbitrum, Optimism, Polygon and Solana, onchain reads (balances, transactions, gas, contracts, NFTs, whale trades, new pools, ENS and Basenames), ECB exchange rates, and Canadian sales tax and business days.","url":"https://ca-tax-api-mainnet.lxtap.workers.dev/eth/nft?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":["contract","tokenId"],"properties":{"tokenId":{"type":"string","pattern":"^\\d{1,78}$","description":"Token id as a decimal string"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"NFT collection contract on Ethereum"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"eth","owner":"0x46EFbAedc92067E6d60E84ED6395099723252496","tokenId":"1","contract":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D","imageUrl":"https://nft2-cdn.alchemy.com/eth-mainnet/65558a4d0c5b0c56fbc50bf03f55e3fa","metadata":{"image":"ipfs://QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi","attributes":[{"value":"Grin","trait_type":"Mouth"},{"value":"Vietnam Jacket","trait_type":"Clothes"},{"value":"Orange","trait_type":"Background"},{"value":"Blue Beams","trait_type":"Eyes"},{"value":"Robot","trait_type":"Fur"}]},"standard":"ERC-721","tokenUri":"ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1","collection":"BoredApeYachtClub","fetchedFrom":"Alchemy NFT API cache (token URI host unavailable)"}},"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_k_E5grlrUydUHiiUs1JjT","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":"Fetches on-chain and off-chain metadata for an ERC-721 or ERC-1155 token on Ethereum mainnet, including collection name, owner, token URI, and fully resolved metadata JSON with a browser-loadable image URL.","exampleAgentPrompt":"Can you pull the full metadata and image for token ID 1234 from the CryptoPunks contract at 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB on Ethereum mainnet?","exampleUseCases":[{"title":"NFT provenance and ownership check","prompt":"Who currently owns token ID 7804 from the CryptoPunks contract 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB on Ethereum? Also grab the name and image for it."},{"title":"NFT gallery display data","prompt":"I'm building a gallery page — can you fetch the collection name, image URL, and all metadata attributes for token 3429 from the Bored Ape Yacht Club contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?"},{"title":"NFT due-diligence before purchase","prompt":"Before I buy it, can you show me the full token metadata, current owner, and resolved image for token ID 88 on the Azuki contract 0xED5AF388653567Af2F388E6224dC7C4b3241C544 on Ethereum mainnet?"}],"resultDescription":"Returns a JSON object containing the collection name, current owner address (for ERC-721), token URI, and fully decoded metadata JSON fetched from IPFS, Arweave, HTTPS, or an inline data URI — including a browser-loadable image URL and any token attributes or description fields present in the metadata.","failureModes":["Invalid contract address format returns a validation error","Non-existent or burned token ID returns a not-found or revert error","IPFS/Arweave gateway timeout may delay or fail metadata resolution","Contracts without standard tokenURI method may return incomplete data","Malformed or unparseable metadata JSON at the token URI returns partial results","Non-NFT contract address returns an error or empty response"],"whenToPreferThis":"Use this endpoint when you need fully resolved NFT metadata on Ethereum mainnet — including off-chain content fetched from IPFS, Arweave, or HTTPS — in a single call. Prefer it over raw RPC calls when you need the decoded metadata JSON and a browser-ready image URL without implementing gateway resolution yourself. Choose the Base equivalent for Base-chain NFTs or the Solana endpoint for SPL tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:41:08.949Z","isFirstParty":false,"canonicalSlug":"ethereum-nft-token-metadata-75e48c66"}