Skip to main content

Get all collections of an owner

Overview​

This API allows you to retrieve a list of collections in which the owner has NFTs.

Get all collections of an owner​

To get the collection list, use this get list of collections having NFTs belonging to an address API

It requires one parameter (in path):

  • address: owner address

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 the wallet address 0x0000b7c6ccc9dd223facd7f9f896fb1b6f130000:

curl --location 'https://api-gateway.skymavis.com/skynet/ronin/web3/v2/accounts/0x0000b7c6ccc9dd223facd7f9f896fb1b6f130000/collections?limit=3' \
--header 'Accept: application/json' \
--header 'X-API-KEY: <YOUR_API_KEY>'

Response:

{
    "result": {
        "items": [
            {
                "contractAddress": "0x32950db2a7164ae833121501c797d79e7b79d74c",
                "name": "Axie",
                "symbol": "AXIE",
                "standard": "ERC721",
                "balance": "467",
                "tokenCount": 467
            },
            {
                "contractAddress": "0x3672f99418ac1dfd71147dbd7c05d4a7aab7aae4",
                "name": "ApeironPlanet",
                "symbol": "APEP",
                "standard": "ERC721",
                "balance": "2",
                "tokenCount": 2
            },
            {
                "contractAddress": "0x737b80335a9396a8658405d7adcbc57343ff0558",
                "name": "Axie Consumable Item",
                "symbol": "ACI",
                "standard": "ERC1155",
                "balance": "1",
                "tokenCount": 1
            }
        ],
        "paging": {
            "nextCursor": "MHg3MzdiODAzMzVhOTM5NmE4NjU4NDA1ZDdhZGNiYzU3MzQzZmYwNTU4"
        }
    }
}

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