Owners By Contract | Alchemy Docs

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

Query Parameters

contractAddressstringRequiredDefaults to 0x495f947276749ce646f68ac8c248420045cb7b5e

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

withTokenBalancesbooleanOptionalDefaults to false

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

pageKeystringOptional

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

Response

Returns a list of all owners for the specified contract.

ownerslist of objects or null

List of all addresses that own one of the NFTs from the queried contract address. The format is applicable when withTokenBalances=true.

1	import requests
2
3	url = "https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/getOwnersForContract"
4
5	querystring = {"contractAddress":"0x495f947276749ce646f68ac8c248420045cb7b5e"}
6
7	response = requests.get(url, params=querystring)
8
9	print(response.json())

1	{
2	"owners": [
3	{
4	"ownerAddress": "0xe785E82358879F061BC3dcAC6f0444462D4b5330",
5	"tokenBalances": [
6	{
7	"tokenId": "string",
8	"balance": 1
9	}
10	]
11	}
12	]
13	}