Owners By Contract

GET

/v3/{apiKey}/getOwnersForContract

getOwnersForContract - 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.

Path Parameters

apiKeystringrequireddefaults to docs-demo

For higher throughput, create your own API key

Query Parameters

contractAddressstringrequireddefaults to 0x495f947276749ce646f68ac8c248420045cb7b5e

String - Contract address for the NFT contract (ERC721 and ERC1155 supported).

withTokenBalancesbooleandefaults to false

Boolean - If set to true the query will include the token balances per token id for each owner. false by default.

pageKeystring

String - used for contracts with >50,000 owners. pageKey field can be passed back as request parameter to get the next page of results.

Responses

200

Returns a list of all owners for the specified contract.

GET/nft/v3/{apiKey}/getOwnersForContract

curl --request GET \  --url 'https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/getOwnersForContract?contractAddress=0x495f947276749ce646f68ac8c248420045cb7b5e'

200Returns a list of all owners for the specified contract.

{  "owners": [    {      "ownerAddress": "0xe785E82358879F061BC3dcAC6f0444462D4b5330",      "tokenBalances": [        {          "tokenId": "string",          "balance": 1        }      ]    }  ]}

Was this page helpful?