Owners By Contract
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
apiKey
Query parameters
contractAddress
String - Contract address for the NFT contract (ERC721 and ERC1155 supported).
withTokenBalances
Boolean - If set to true
the query will include the token balances per token id for each owner. false
by default.
pageKey
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.
owners
List of all addresses that own one of the NFTs from the queried contract address. The format is applicable when withTokenBalances=true
.