Skip to main content

Get all NFTs of an owner

Overview​

This API allows you to retrieve a list of NFTs owned by a wallet address.

Get all NFTs of an owner​

To get NFTs of an owner, use this get owned NFTs of 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, 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 the 0x0000b7c6ccc9dd223facd7f9f896fb1b6f130000 wallet address:

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

Response:

{
    "result": {
        "items": [
            {
                "contractAddress": "0x32950db2a7164ae833121501c797d79e7b79d74c",
                "tokenId": "10012172",
                "balance": "1",
                "name": "Axie",
                "symbol": "AXIE",
                "standard": "ERC721",
                "tokenUri": "https://metadata.axieinfinity.com/axie/10012172",
                "metadata": {
                    "external_url": "https://app.axieinfinity.com/marketplace/axies/10012172",
                    "genes": "0x1000000000000100008120e0820800000001000808404202000100082880440a000100083040820600010008084042020001000820410502000100083041820c",
                    "id": 10012172,
                    "image": "https://axiecdn.axieinfinity.com/axies/10012172/axie/axie-full-transparent.png",
                    "name": "Axie #10012172",
                    "properties": {
                        "axie_id": 10012172,
                        "back_id": "back-pigeon-post",
                        "birthdate": 1638601718,
                        "bodyshape": "fuzzy",
                        "breed_count": 0,
                        "class": "bird",
                        "ears_id": "ears-risky-bird",
                        "eyes_id": "eyes-mavis",
                        "horn_id": "horn-eggshell",
                        "matron_id": 9796535,
                        "mouth_id": "mouth-little-owl",
                        "num_japan": 0,
                        "num_mystic": 0,
                        "num_shiny": 0,
                        "num_summer": 0,
                        "num_xmas": 0,
                        "primary_color": "bird-02",
                        "pureness": 6,
                        "purity": 95,
                        "sire_id": 9798459,
                        "stage": 4,
                        "tail_id": "tail-post-fight",
                        "title": ""
                    }
                }
            },
            {
                "contractAddress": "0x32950db2a7164ae833121501c797d79e7b79d74c",
                "tokenId": "10037309",
                "balance": "1",
                "name": "Axie",
                "symbol": "AXIE",
                "standard": "ERC721",
                "tokenUri": "https://metadata.axieinfinity.com/axie/10037309",
                "metadata": {
                    "external_url": "https://app.axieinfinity.com/marketplace/axies/10037309",
                    "genes": "0x20000000000001000241209083080000000100101080840800010000108040040001001008810408000100102081030600010010288144060001001010808404",
                    "id": 10037309,
                    "image": "https://axiecdn.axieinfinity.com/axies/10037309/axie/axie-full-transparent.png",
                    "name": "Axie #10037309",
                    "properties": {
                        "axie_id": 10037309,
                        "back_id": "back-anemone",
                        "birthdate": 1638648628,
                        "bodyshape": "normal",
                        "breed_count": 3,
                        "class": "aquatic",
                        "ears_id": "ears-nimo",
                        "eyes_id": "eyes-clear",
                        "horn_id": "horn-anemone",
                        "matron_id": 9832456,
                        "mouth_id": "mouth-goda",
                        "num_japan": 0,
                        "num_mystic": 0,
                        "num_shiny": 0,
                        "num_summer": 0,
                        "num_xmas": 0,
                        "primary_color": "aquatic-02",
                        "pureness": 5,
                        "purity": 85,
                        "sire_id": 9836372,
                        "stage": 4,
                        "tail_id": "tail-nimo",
                        "title": ""
                    }
                }
            }
        ],
        "paging": {
            "nextCursor": "MHgzMjk1MGRiMmE3MTY0YWU4MzMxMjE1MDFjNzk3ZDc5ZTdiNzlkNzRjOjEwMDM3MzA5"
        }
    }
}

Notes:

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