Alchemy — Owners By Contract
alchemy_get_nft_v3_getownersforcontractgetOwnersForContract - Retrieves all owners associated with a specific NFT contract. This endpoint is supported on Ethereum and many L2s, including Polygon, Arbitrum, Optimism, Base, World Chain and more. See the full list of supported networks here. Uses the shared Alchemy Free quota; not unlimited. Documentation prepared only, not runtime-verified. Uses the caller's OpenAny gateway credentials. Charges and authorization are determined by the gateway.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pageKey | No | String - used for contracts with >50,000 owners. `pageKey` field can be passed back as request parameter to get the next page of results. | |
| contractAddress | Yes | String - Contract address for the NFT contract (ERC721 and ERC1155 supported). | |
| withTokenBalances | No | Boolean - If set to `true` the query will include the token balances per token id for each owner. `false` by default. |