{"uid":"cap_GLinWxpQ0Hwanhn9boWjN","slug":"beggar-bot-nft-metadata-lookup-base-mainnet-9e46a8df","name":"Beggar Bot NFT Metadata Lookup (Base mainnet)","description":"Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.","url":"https://beggar-bot-demand.beggarbot.workers.dev/v1/nftmeta?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["contract","token_id"],"properties":{"chain":{"type":"string","description":"base (default)"},"holder":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"optional"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"collection"},"token_id":{"type":"string","description":"token id"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nsELh8g27_iyrByTW_IX5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","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 for a given contract and token ID on Base mainnet, optionally checking holder ownership.","exampleAgentPrompt":"Can you pull the metadata for token ID 42 from the NFT collection at 0x1234567890abcdef1234567890abcdef12345678 on Base — I want to see its traits, name, and image.","exampleUseCases":[{"title":"Inspect NFT traits before buying","prompt":"What are the attributes and rarity traits for token ID 1337 in the collection at contract 0xd4e4078ca3495DE5B1d4dB434BEbc5a986197782 on Base?"},{"title":"Verify NFT ownership for gating","prompt":"Can you confirm whether wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 actually holds token ID 7 from the contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?"},{"title":"Display NFT info in a portfolio app","prompt":"Fetch the name, description, and image URL for token ID 500 from the NFT contract 0xabc123abc123abc123abc123abc123abc123abc1 on Base so I can display it in my portfolio."}],"resultDescription":"A JSON object containing NFT metadata for the specified token, including fields such as name, description, image URL, attributes/traits, and optionally holder ownership status. Returned from on-chain or indexed data for the Base network.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Token ID not found in the collection returns 404 or null metadata","Invalid Ethereum address format for contract or holder triggers schema validation failure","Payment not completed via x402 results in 402 Payment Required response","Unsupported chain parameter returns an error","Rate limiting or worker timeout on high-load requests"],"whenToPreferThis":"Use this endpoint when you need fast, paid on-chain NFT metadata lookups on Base mainnet (or Base Sepolia) for a specific contract and token ID, especially when you also want optional holder verification in a single call. Prefer it over free indexers when freshness and on-chain accuracy matter, and when your agent already supports x402 micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:10.702Z","isFirstParty":false,"canonicalSlug":"beggar-bot-nft-metadata-lookup-base-mainnet-9e46a8df"}