Skip to main content
GET
https://api.krownlabs.app
/
api
/
tokens
/
collection
/
{addressOrPath}
curl "https://api.krownlabs.app/api/tokens/collection/0x123...?listed=true&sortBy=price&sortOrder=asc"
{
  "tokens": [
    {
      "listingApprovalStatus": "approved",
      "_id": "68543e85065c4715cd6d1e62",
      "id": "0x9e08f84ae540f68b573d821ef64208edecb97038-1",
      "tokenId": 1,
      "collectionAddress": "0x9e08f84ae540f68b573d821ef64208edecb97038",
      "isBase64": false,
      "imageProcessed": true,
      "owner": "0xafad305acea4f867fba60b563ea55127222e805e",
      "lastPrice": "0",
      "isListed": false,
      "isInAuction": false,
      "hasOffers": false,
      "nftType": "ERC721",
      "amount": 1,
      "listingSource": "native",
      "attributes": [
        {
          "trait_type": "Accessories",
          "value": "Red Headband with Sonic Logo",
          "rarity": 4.5,
          "_id": "68543eec4787f0d648e5e025"
        },
        {
          "trait_type": "Background",
          "value": "Arctic",
          "rarity": 15.9,
          "_id": "68543eec4787f0d648e5e026"
        },
        {
          "trait_type": "Eyes",
          "value": "Googly",
          "rarity": 30.5,
          "_id": "68543eec4787f0d648e5e027"
        },
        {
          "trait_type": "Glasses",
          "value": "Round",
          "rarity": 76.35,
          "_id": "68543eec4787f0d648e5e028"
        },
        {
          "trait_type": "Phantom",
          "value": "Crimson",
          "rarity": 8.9,
          "_id": "68543eec4787f0d648e5e029"
        }
      ],
      "name": "Bunchy 1",
      "description": "Sonic's very own Phantom Bunch. They're here again.",
      "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1.webp",
      "tokenURI": "ipfs://bafybeifa6obtt3i7fq5zrpvwkaqkmn6xmitibixp4sjuo4jpzqj2tbvod4/1.json",
      "metadata": {
        "tokenId": 1,
        "name": "Bunchy 1",
        "description": "Sonic's very own Phantom Bunch. They're here again.",
        "attributes": [
          {
            "trait_type": "Accessories",
            "value": "Red Headband with Sonic Logo"
          },
          {
            "trait_type": "Background",
            "value": "Arctic"
          },
          {
            "trait_type": "Eyes",
            "value": "Googly"
          },
          {
            "trait_type": "Glasses",
            "value": "Round"
          },
          {
            "trait_type": "Phantom",
            "value": "Crimson"
          }
        ],
        "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1.webp"
      },
      "createdAt": "2025-06-19T16:44:53.328Z",
      "updatedAt": "2025-06-20T05:35:01.736Z",
      "__v": 1,
      "imageProcessedAt": "2025-06-19T16:44:54.372Z",
      "mediaType": "image",
      "previewUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1/preview.webp",
      "thumbnailUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1/thumbnail.webp",
      "rarityRank": 1276,
      "rarityScore": 44.33593167391925,
      "collectionName": "Bunchy",
      "rarity": {
        "rank": 1276,
        "total": 2000,
        "formatted": "1276/2000",
        "percentile": 63.8,
        "score": 44.33593167391925
      },
      "marketplaceDetails": {
        "source": "native",
        "externalUrl": null,
        "externalId": null,
        "sourceDisplayName": "Krown",
        "sourceLogo": null
      }
    }
  ],
  "pagination": {
    "total": 2000,
    "page": 1,
    "limit": 1,
    "pages": 2000
  }
}

Path Parameters

addressOrPath
string
required
Collection contract address or URL path

Query Parameters

page
integer
default:"1"
Page number
limit
integer
default:"50"
Results per page (max 100)
sortBy
string
default:"tokenId"
Sort fieldOptions: tokenId, price, rarityRank, lastSale
sortOrder
string
default:"asc"
Sort order (asc or desc)
listed
boolean
Filter by listing status
minPrice
string
Minimum listing price (in S)
maxPrice
string
Maximum listing price (in S)
traits
string
Filter by traits (format: type:value,type:value)Example: Background:Blue,Hat:Crown

Response

tokens
array
Array of NFT objects
pagination
object
Pagination metadata
curl "https://api.krownlabs.app/api/tokens/collection/0x123...?listed=true&sortBy=price&sortOrder=asc"
{
  "tokens": [
    {
      "listingApprovalStatus": "approved",
      "_id": "68543e85065c4715cd6d1e62",
      "id": "0x9e08f84ae540f68b573d821ef64208edecb97038-1",
      "tokenId": 1,
      "collectionAddress": "0x9e08f84ae540f68b573d821ef64208edecb97038",
      "isBase64": false,
      "imageProcessed": true,
      "owner": "0xafad305acea4f867fba60b563ea55127222e805e",
      "lastPrice": "0",
      "isListed": false,
      "isInAuction": false,
      "hasOffers": false,
      "nftType": "ERC721",
      "amount": 1,
      "listingSource": "native",
      "attributes": [
        {
          "trait_type": "Accessories",
          "value": "Red Headband with Sonic Logo",
          "rarity": 4.5,
          "_id": "68543eec4787f0d648e5e025"
        },
        {
          "trait_type": "Background",
          "value": "Arctic",
          "rarity": 15.9,
          "_id": "68543eec4787f0d648e5e026"
        },
        {
          "trait_type": "Eyes",
          "value": "Googly",
          "rarity": 30.5,
          "_id": "68543eec4787f0d648e5e027"
        },
        {
          "trait_type": "Glasses",
          "value": "Round",
          "rarity": 76.35,
          "_id": "68543eec4787f0d648e5e028"
        },
        {
          "trait_type": "Phantom",
          "value": "Crimson",
          "rarity": 8.9,
          "_id": "68543eec4787f0d648e5e029"
        }
      ],
      "name": "Bunchy 1",
      "description": "Sonic's very own Phantom Bunch. They're here again.",
      "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1.webp",
      "tokenURI": "ipfs://bafybeifa6obtt3i7fq5zrpvwkaqkmn6xmitibixp4sjuo4jpzqj2tbvod4/1.json",
      "metadata": {
        "tokenId": 1,
        "name": "Bunchy 1",
        "description": "Sonic's very own Phantom Bunch. They're here again.",
        "attributes": [
          {
            "trait_type": "Accessories",
            "value": "Red Headband with Sonic Logo"
          },
          {
            "trait_type": "Background",
            "value": "Arctic"
          },
          {
            "trait_type": "Eyes",
            "value": "Googly"
          },
          {
            "trait_type": "Glasses",
            "value": "Round"
          },
          {
            "trait_type": "Phantom",
            "value": "Crimson"
          }
        ],
        "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1.webp"
      },
      "createdAt": "2025-06-19T16:44:53.328Z",
      "updatedAt": "2025-06-20T05:35:01.736Z",
      "__v": 1,
      "imageProcessedAt": "2025-06-19T16:44:54.372Z",
      "mediaType": "image",
      "previewUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1/preview.webp",
      "thumbnailUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1/thumbnail.webp",
      "rarityRank": 1276,
      "rarityScore": 44.33593167391925,
      "collectionName": "Bunchy",
      "rarity": {
        "rank": 1276,
        "total": 2000,
        "formatted": "1276/2000",
        "percentile": 63.8,
        "score": 44.33593167391925
      },
      "marketplaceDetails": {
        "source": "native",
        "externalUrl": null,
        "externalId": null,
        "sourceDisplayName": "Krown",
        "sourceLogo": null
      }
    }
  ],
  "pagination": {
    "total": 2000,
    "page": 1,
    "limit": 1,
    "pages": 2000
  }
}