{"uid":"cap_WAhieyqTVZYH42xTnbiCs","slug":"base-nft-token-metadata-lookup-26897633","name":"Base NFT Token Metadata Lookup","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/base/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 Base"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","owner":"0x2211d1D0020DAEA8039E46Cf1367962070d77DA9","tokenId":"20339294690710288616623341905746354430592698944139542544116293784975432873833","contract":"0x03c4738Ee98aE44591e1A4A4F3CaB6641d95DD9a","imageUrl":"https://www.base.org/api/basenames/jesse.base.eth/assets/cardImage.svg","metadata":{"name":"jesse.base.eth","image":"https://www.base.org/api/basenames/jesse.base.eth/assets/cardImage.svg","description":"jesse.base.eth, a Basename","nameExpires":2510960049,"external_url":"https://www.base.org/name/jesse"},"standard":"ERC-721","tokenUri":"https://base.org/api/basenames/metadata/20339294690710288616623341905746354430592698944139542544116293784975432873833","collection":"Basenames","fetchedFrom":"https://base.org/api/basenames/metadata/20339294690710288616623341905746354430592698944139542544116293784975432873833"}},"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_0IVemXKwU3SNVgZ_jNQSc","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 full metadata for an ERC-721 or ERC-1155 token on Base: collection name, owner, token URI, and decoded metadata JSON (including a browser-loadable image URL) from IPFS, Arweave, HTTPS, or inline data URIs.","exampleAgentPrompt":"Look up the full metadata for token ID 1234 in the Base NFT contract at 0xd4e4078ca3495DE5B1d4dB434BEbc5a986197782 — I want the collection name, current owner, and a browser-loadable image URL.","exampleUseCases":[{"title":"NFT portfolio image display","prompt":"I need the image URL and metadata for token ID 88 in the Base NFT contract 0x5180db8F5c931aaE63c74266b211F580155ecac8 so I can display it in my portfolio viewer."},{"title":"On-chain ownership verification","prompt":"Can you check who currently owns token 501 in the Base ERC-721 collection at contract 0xa7d8d9ef8D8Ce8992Df33D8b8CF4Aebabd5bD270?"},{"title":"NFT trait and rarity research","prompt":"Fetch all the attributes and traits for token ID 9999 at Base contract 0xBc4CA0EdA7647A8aB7C2061c2E118A18a936f13D — I want to see its rarity properties and the decoded metadata JSON."}],"resultDescription":"Returns the NFT collection name, current owner address (for ERC-721), token URI, and the fully decoded metadata JSON fetched from wherever it is stored (IPFS, Arweave, HTTPS, or inline data URI), including a browser-loadable image URL derived from the metadata.","failureModes":["Invalid contract address format returns a validation error","Token ID does not exist on the contract returns a not-found or revert error","IPFS or Arweave gateway unavailable causes metadata fetch failure","Contract is not an ERC-721 or ERC-1155 causes decode failure","Payment not provided or insufficient USDC results in HTTP 402"],"whenToPreferThis":"Use this endpoint when you need rich, decoded NFT metadata for a specific token on Base — particularly when the metadata is stored on IPFS or Arweave and you need it resolved to a browser-loadable image URL without building your own gateway logic. Prefer this over raw RPC calls when you also need the owner and collection name in one round-trip.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:44:51.223Z","isFirstParty":false,"canonicalSlug":"base-nft-token-metadata-lookup-26897633"}