{"uid":"cap_tTedoUzzURpk4sSFTrX0H","slug":"beggar-bot-nft-owner-lookup-base-mainnet-3979273d","name":"Beggar Bot NFT Owner 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/nftowner?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","properties":{"ids":{"type":"string","description":"csv token ids"},"chain":{"type":"string","description":"base|ethereum|optimism|arbitrum|polygon"},"holder":{"type":"string","description":"0x wallet (optional)"},"contract":{"type":"string","description":"0x collection"}}}},"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_8wMcop4ZScllQnBvMAYRF","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":"Looks up NFT ownership data for a given collection contract and optional token IDs or holder wallet address across multiple EVM chains","exampleAgentPrompt":"Can you check who owns token IDs 1, 5, and 12 from NFT collection 0x1234567890abcdef1234567890abcdef12345678 on Base, and tell me if wallet 0xABCDEF1234567890abcdef1234567890abcdef12 holds any of them?","exampleUseCases":[{"title":"Token-gated access verification","prompt":"Check if wallet 0xABCDEF1234567890abcdef1234567890abcdef12 owns any NFTs from collection 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I need to verify their access before letting them into the members area."},{"title":"NFT airdrop eligibility check","prompt":"Look up who owns token IDs 100, 101, and 102 from the NFT collection at 0x1234567890abcdef1234567890abcdef12345678 on Ethereum — I need their wallet addresses to send the airdrop."},{"title":"Cross-chain NFT portfolio audit","prompt":"Find all NFT owners for contract 0xabcdef1234567890abcdef1234567890abcdef12 on Polygon and tell me if wallet 0x9876543210abcdef9876543210abcdef98765432 is among them."}],"resultDescription":"Returns JSON with NFT ownership details for the requested contract, including owner wallet addresses for specified token IDs, and optionally confirms whether a given holder wallet owns tokens in the collection.","failureModes":["Invalid or missing contract address returns error","Unsupported chain name returns error","Payment not received (x402 flow not completed) returns 402","Token IDs not found in collection returns empty or not-found response","Malformed CSV token IDs may cause parsing error"],"whenToPreferThis":"Use this endpoint when you need on-chain NFT ownership data across Base, Ethereum, Optimism, Arbitrum, or Polygon — especially for token-gated access control, holder verification, or airdrop targeting. Prefer this over manual RPC calls when you need a simple REST API without managing blockchain node connections. Cost is $0.02 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:39:25.550Z","isFirstParty":false,"canonicalSlug":"beggar-bot-nft-owner-lookup-base-mainnet-3979273d"}