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 addresstokenId
: id of the nft
Optional parameters (in query):
limit
: how many items can be return in a single response, maximum 200cursor
: 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, presentnextCursor
means there will be more results to scroll, emptynextCursor
means it reaches to the end of resultsorder
: specify the order of result set. For most APIs,order
might not be supported but the default valuedesc
, otherwise you can choose betweendesc
andasc
. 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.