Skip to main content

Check NFT owners

Overview

The most efficient way to access NFT ownership data. Whether you're building a marketplace, verifying digital assets, or analyzing trends in the NFT space, our API provides a streamlined solution to gather ownership information faster and more reliably than traditional.

You can travel through the whole list of owners in case an NFT has more than one owner.

Check the owner of an NFT

To get the owner of a given NFT, use this get owners of an NFT API

It requires two parameters (in path):

  • contractAddress: collection address
  • tokenId: id of the nft

Optional parameters (in query):

  • limit: how many items can be return in a single response, maximum 200
  • cursor: the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results
  • order: specify the order of result set. For most APIs, order might not be supported but the default value desc, otherwise you can choose between desc and asc. Desc ordering usually refers to show latest elements over older elements

Example with an ERC721 NFT, an ERC721 NFT can have maximum one owner, so the items should have only one element:

curl --location 'https://api-gateway.skymavis.com/skynet/ronin/web3/v2/collections/0x1f7c16fce4fc894143afb5545bf04f676bf7dcf3/tokens/4836/owners' \
--header 'Accept: application/json' \
--header 'X-API-KEY: <YOUR_API_KEY>'

Response:

{
"result": {
"items": [
{
"address": "0xc4dd73e60740fb979a038bf6ab2eb8a6cad35ec7",
"balance": "1"
}
],
"paging": {}
}
}

Example with an ERC1155 NFT, an ERC1155 NFT can have many owners, so the items may have more than one element:

curl --location 'https://api-gateway.skymavis.com/skynet/ronin/web3/v2/collections/0x814a9c959a3ef6ca44b5e2349e3bba9845393947/tokens/2010068/owners' \
--header 'Accept: application/json' \
--header 'X-API-KEY: <YOUR_API_KEY>'

Response:

{
"result": {
"items": [
{
"address": "0x0b0cab270531bd4df64d7d72d608bdfa53834d8e",
"balance": "1"
},
{
"address": "0x0c3b0f558d5ad7e9b3b1939f46d30dbf0c8ec959",
"balance": "1"
},
{
"address": "0x1233498fe66e2e7f787e34c852564b2d4b0057bd",
"balance": "1"
},
{
"address": "0x24df6e34ee4b0dfd319cdd67cee67e281788384b",
"balance": "1"
},
{
"address": "0x25a237dcaaaf6228a011b9db0bd712d9f5e17b69",
"balance": "1"
},
{
"address": "0x2fb7fc954f88b97a9977c35dedabb5e7458ac779",
"balance": "1"
},
{
"address": "0x36b628e771b0ca12a135e0a7b8e0394f99dce95b",
"balance": "23"
},
{
"address": "0x3725f8df6113e2d2c05ff39a0803a3f2b66a6b53",
"balance": "1"
},
{
"address": "0x390d5c2e7a011ff1f779944a99201be52c2cf96c",
"balance": "1"
},
{
"address": "0x87047356e9e58c3861b3cd5c6c85cd1227a78328",
"balance": "1"
},
{
"address": "0xac16c6b37d7191a8ef4ac1fc559edaf18b27375d",
"balance": "1"
},
{
"address": "0xb4c218052e3853d3b8645e369e02a28f9b2e9caf",
"balance": "1"
},
{
"address": "0xf026a3076f3407fa1290f0c43ec246bb4f24ff75",
"balance": "1"
}
],
"paging": {}
}
}

The response returned from the API may vary in the future as the state of NFTs/Ownership/Collections can change.