🎨 NFT APINft Ownership Endpoints

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

apiKeystringRequired

Query parameters

contractAddressstringRequired

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 objectsOptional

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