Owners by NFT

get

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

This endpoint is commonly used to pass a chain, contract address, and token_id and get the full list of wallets owning this NFT. The number of owners may be more than 1 in the case of ERC-1155 tokens, or 0 for burned tokens.

This endpoint is paginated to 1,000 items per response

On Solana, provide the chain and contract address, and a token ID of 0

Path Params

chain

string

enum

required

Defaults to ethereum

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

contract_address

string

required

Defaults to 0x8a90cab2b38dba80c64b7734e58ee1db38b8992e

Address of the NFT contract

token_id

string

required

Defaults to 9541

Token ID of the given NFT. For Solana and Bitcoin, this can be omitted or set to 0.

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