{"uid":"cap_E1sLKhamwBDhEZAh6wy3g","slug":"aether-nft-metadata-lookup-base-14cb40a6","name":"Aether NFT Metadata Lookup (Base)","description":"Pay-per-call Base onchain data, token risk verdicts and x402 payability audits over x402 (USDC on Base).","url":"https://aether-x402.vercel.app/v1/base/nft-metadata?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokenId":{"type":["string","integer"],"pattern":"^[0-9]+$"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"responseSchema":{"type":"json","example":{"metadata":{"name":"...","image":"ipfs://..."},"tokenURI":"ipfs://..."}},"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_A71C5RM7O-1am63wNjmL4","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 on-chain NFT metadata (name, image, tokenURI) for a given contract and token ID on the Base network, paid via x402 (USDC on Base).","exampleAgentPrompt":"What's the name and image for NFT token ID 42 from the Base contract 0x1234567890abcdef1234567890abcdef12345678?","exampleUseCases":[{"title":"NFT portfolio display enrichment","prompt":"I have a list of Base NFTs in my wallet — can you pull the name and image for token 101 from contract 0xabcdef1234567890abcdef1234567890abcdef12 so I can show it in my dashboard?"},{"title":"Verify NFT authenticity details","prompt":"Can you fetch the on-chain metadata for token ID 7 from Base NFT contract 0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef and tell me what the tokenURI and image resolve to?"},{"title":"NFT marketplace listing prep","prompt":"I'm listing token 305 from Base contract 0xfeedface00000000000000000000000000000001 — grab its on-chain name and IPFS image so I can auto-fill the listing details."}],"resultDescription":"A JSON object containing the NFT's metadata (name, image URI, and other on-chain attributes) plus the raw tokenURI (often an IPFS link), enabling downstream display or verification of the asset.","failureModes":["Invalid contract address format (not a valid 0x-prefixed 40-char hex) returns a 400 error","Token ID does not exist on the contract returns a not-found or null metadata response","Contract is not an NFT contract (ERC-721/1155) may return empty or error response","IPFS gateway timeouts can cause slow or failed metadata resolution","Payment failure or insufficient USDC balance results in 402 Payment Required","Rate limits or network congestion on Base may cause transient failures"],"whenToPreferThis":"Choose this endpoint when you need to resolve NFT metadata (name, image, tokenURI) for a specific token on the Base L2 network and want a pay-per-call model with no subscription. It is particularly useful for AI agents that already operate in the x402 micropayment ecosystem using USDC on Base, and need lightweight, on-demand NFT lookups without standing up their own RPC infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:38:39.617Z","isFirstParty":false,"canonicalSlug":"aether-nft-metadata-lookup-base-14cb40a6"}