{"uid":"cap_CT0HZcjn3Vl6wiOg_18--","slug":"x402-alchemy-com-aa28db16","name":"Alchemy NFT API — Get Owners For Contract","description":"Returns the owners of a given NFT contract across supported chains.","url":"https://x402.alchemy.com/%7BchainNetwork%7D/nft/v3/getOwnersForContract","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VB_3ZNY-a0HLhtdVOE-nD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all wallet addresses that own tokens from a specified NFT contract on a given blockchain network.","exampleAgentPrompt":"Can you get me the full list of wallet addresses that currently own tokens from the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum mainnet, including how many tokens each wallet holds?","exampleUseCases":[{"title":"Prepare NFT airdrop recipient list","prompt":"I need to airdrop tokens to everyone holding our NFT collection. Can you fetch all the wallet addresses that own tokens from our contract address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum, and tell me how many tokens each holder has?"},{"title":"Analyze NFT collection ownership distribution","prompt":"Help me understand how distributed our NFT collection is. Can you get me a complete list of all wallets that hold tokens from the contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Polygon and show me the token counts so I can see if whales dominate or if ownership is spread out?"},{"title":"Verify NFT holders for DAO governance","prompt":"We're running a snapshot vote for our NFT holders on Ethereum. I need you to pull all the wallet addresses that currently own tokens from our NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D so we can validate voting eligibility."}],"resultDescription":"A paginated list of owner wallet addresses for the specified NFT contract, optionally including the number of tokens held per wallet, plus a page key for fetching subsequent pages.","failureModes":["Invalid or non-existent contract address returns empty or error response","Unsupported chain network returns 400 or 404","Rate limiting or payment failure returns 402 or 429","Contract is not an NFT contract returns empty owners list","Pagination key mismatch or expiry causes incomplete results"],"whenToPreferThis":"Use this endpoint when you need a comprehensive list of all current holders of a specific NFT contract — ideal for airdrop targeting, snapshot voting, ownership analytics, or verifying collection distribution. Prefer this over wallet-centric NFT endpoints when the starting point is a contract address rather than a wallet address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:30:01.904Z","isFirstParty":false}