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 a 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, you get it and pass to the next call, present cursor means there will be more results to scroll, empty cursor means it reaches to the end of results

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": {}
    }
}

Notes:

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