Owners by Contract

get

https://api.simplehash.xyz/api/v0/nfts/owners/{chain}/{contract_address}

This endpoint is commonly used to pass a chain and contract address, and get the full list of wallets owning NFTs on that contract, split out by token id

This endpoint is paginated to 1,000 items per response

To understand more about the difference between Collections and Contracts, please refer to our FAQ

On Solana, this endpoint will function identically to Owners by NFT

Path Params

chain

string

enum

required

Defaults to ethereum

Name of the chain (e.g., ethereum)

contract_address

string

required

Defaults to 0x12f28e2106ce8fd8464885b80ea865e98b465149

Address of the NFT contract

Query Params

count

string

enum

Include the total distinct count of Owners in the response (pass count=1)

Allowed:

cursor

string

Used to retrieve the next page of results

limit

int32

Defaults to 50

Change the default page limit.

Responses

200200

400400

401401

403403