Skip to main content

Get all NFTs of a collection

Overview

  • This API is a must-have for game studios looking to efficiently manage their on-chain assets. With one simple request, game developers can access all NFTs in as collection.
  • Game studios often deal with large volumes of NFTs, from in-game items to collectibles. This API provides an easy way to retrieve and organize all assets in a collection, helping teams focus on game development, not blockchain complexity.
  • Ensure your NFT-based assets are accurately tracked and managed on-chain, providing transparency and security for both the studio and its players.
  • No need for deep blockchain knowledge—this API handles the heavy lifting.

Get all NFTs of a collection

To get the collection list, use this get NFTs from a collection API

It requires one parameter (in path):

  • contractAddress: collection 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 of Axie 0x32950db2a7164ae833121501c797d79e7b79d74c NFTs:

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

Response:

{
"result": {
"items": [
{
"tokenId": "12075531",
"contractAddress": "0x32950db2a7164ae833121501c797d79e7b79d74c",
"name": "Axie",
"symbol": "AXIE",
"standard": "ERC721",
"tokenUri": "https://metadata.axieinfinity.com/axie/12075531",
"metadata": {
"name": "Axie #12075531",
"external_url": "https://app.axieinfinity.com/marketplace/axies/12075531",
"id": 12075531,
"image": "https://cdn.axieinfinity.com/marketplace-website/axie-eggs/dawn-dusk.png",
"genes": "0x0",
"properties": {
"axie_id": 12075531,
"class": "",
"bodyshape": "",
"title": "",
"primary_color": "",
"num_mystic": 0,
"num_japan": 0,
"num_xmas": 0,
"num_summer": 0,
"num_shiny": 0,
"pureness": 0,
"purity": 0,
"eyes_id": "",
"mouth_id": "",
"ears_id": "",
"horn_id": "",
"back_id": "",
"tail_id": "",
"birthdate": 1727840838,
"stage": 1,
"sire_id": 12056185,
"matron_id": 11000440,
"breed_count": 0
}
}
},
{
"tokenId": "12075532",
"contractAddress": "0x32950db2a7164ae833121501c797d79e7b79d74c",
"name": "Axie",
"symbol": "AXIE",
"standard": "ERC721",
"tokenUri": "https://metadata.axieinfinity.com/axie/12075532",
"metadata": {
"name": "Axie #12075532",
"external_url": "https://app.axieinfinity.com/marketplace/axies/12075532",
"id": 12075532,
"image": "https://cdn.axieinfinity.com/marketplace-website/axie-eggs/mech-mech.png",
"genes": "0x0",
"properties": {
"axie_id": 12075532,
"class": "",
"bodyshape": "",
"title": "",
"primary_color": "",
"num_mystic": 0,
"num_japan": 0,
"num_xmas": 0,
"num_summer": 0,
"num_shiny": 0,
"pureness": 0,
"purity": 0,
"eyes_id": "",
"mouth_id": "",
"ears_id": "",
"horn_id": "",
"back_id": "",
"tail_id": "",
"birthdate": 1727840838,
"stage": 1,
"sire_id": 9683970,
"matron_id": 5209616,
"breed_count": 0
}
}
}
],
"paging": {
"nextCursor": "Mzg2NjcwMjI6MTIwNzU1MzI="
}
}
}

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