Skip to main content
GET
https://api.krownlabs.app
/
api
/
tokens
/
collection
/
{addressOrPath}
/
rare
curl "https://api.krownlabs.app/api/tokens/collection/sonic-punks/rare?limit=20&listed=true"
{
  "collectionAddress": "0x9e08f84ae540f68b573d821ef64208edecb97038",
  "rareNFTs": [
    {
      "listingApprovalStatus": "approved",
      "_id": "685440514787f0d648e61d84",
      "id": "0x9e08f84ae540f68b573d821ef64208edecb97038-1587",
      "tokenId": 1587,
      "collectionAddress": "0x9e08f84ae540f68b573d821ef64208edecb97038",
      "isBase64": false,
      "imageProcessed": true,
      "owner": "0x32a026b2d1c28cabb253a555856c4545844b88ca",
      "lastPrice": "0",
      "isListed": false,
      "isInAuction": false,
      "hasOffers": false,
      "nftType": "ERC721",
      "amount": 1,
      "listingSource": "native",
      "attributes": [
        {
          "trait_type": "Accessories",
          "value": "Leonardo",
          "rarity": 0.75,
          "_id": "685440524787f0d648e61db1"
        },
        {
          "trait_type": "Background",
          "value": "Arctic",
          "rarity": 15.9,
          "_id": "685440524787f0d648e61db2"
        },
        {
          "trait_type": "Eyes",
          "value": "Basic",
          "rarity": 49.9,
          "_id": "685440524787f0d648e61db3"
        },
        {
          "trait_type": "Glasses",
          "value": "None",
          "rarity": 23.65,
          "_id": "685440524787f0d648e61db4"
        },
        {
          "trait_type": "Phantom",
          "value": "Azure",
          "rarity": 9.35,
          "_id": "685440524787f0d648e61db5"
        }
      ],
      "name": "Bunchy 1587",
      "description": "Sonic's very own Phantom Bunch. They're here again.",
      "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1587.webp",
      "tokenURI": "ipfs://bafybeifa6obtt3i7fq5zrpvwkaqkmn6xmitibixp4sjuo4jpzqj2tbvod4/1587.json",
      "metadata": {
        "tokenId": 1587,
        "name": "Bunchy 1587",
        "description": "Sonic's very own Phantom Bunch. They're here again.",
        "attributes": [
          {
            "trait_type": "Accessories",
            "value": "Leonardo"
          },
          {
            "trait_type": "Background",
            "value": "Arctic"
          },
          {
            "trait_type": "Eyes",
            "value": "Basic"
          },
          {
            "trait_type": "Glasses",
            "value": "None"
          },
          {
            "trait_type": "Phantom",
            "value": "Azure"
          }
        ],
        "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1587.webp"
      },
      "createdAt": "2025-06-19T16:52:34.978Z",
      "updatedAt": "2025-08-20T23:22:43.083Z",
      "__v": 0,
      "rarityRank": 1,
      "rarityScore": 156.55016650096658,
      "imageProcessedAt": "2025-06-19T17:16:29.195Z",
      "mediaType": "image",
      "previewUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1587/preview.webp",
      "thumbnailUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1587/thumbnail.webp"
    }
  ],
  "count": 1
}

Path Parameters

addressOrPath
string
required
Collection contract address or URL path

Query Parameters

limit
integer
default:"20"
Number of rare NFTs to return (max 100)
listed
boolean
Filter by listing status

Response

collectionAddress
string
Collection contract address
rareNFTs
array
Array of NFT objects sorted by rarity rank (1 = rarest). Contains the same structure as individual token objects with all token details.
count
number
Number of rare NFTs returned
curl "https://api.krownlabs.app/api/tokens/collection/sonic-punks/rare?limit=20&listed=true"
{
  "collectionAddress": "0x9e08f84ae540f68b573d821ef64208edecb97038",
  "rareNFTs": [
    {
      "listingApprovalStatus": "approved",
      "_id": "685440514787f0d648e61d84",
      "id": "0x9e08f84ae540f68b573d821ef64208edecb97038-1587",
      "tokenId": 1587,
      "collectionAddress": "0x9e08f84ae540f68b573d821ef64208edecb97038",
      "isBase64": false,
      "imageProcessed": true,
      "owner": "0x32a026b2d1c28cabb253a555856c4545844b88ca",
      "lastPrice": "0",
      "isListed": false,
      "isInAuction": false,
      "hasOffers": false,
      "nftType": "ERC721",
      "amount": 1,
      "listingSource": "native",
      "attributes": [
        {
          "trait_type": "Accessories",
          "value": "Leonardo",
          "rarity": 0.75,
          "_id": "685440524787f0d648e61db1"
        },
        {
          "trait_type": "Background",
          "value": "Arctic",
          "rarity": 15.9,
          "_id": "685440524787f0d648e61db2"
        },
        {
          "trait_type": "Eyes",
          "value": "Basic",
          "rarity": 49.9,
          "_id": "685440524787f0d648e61db3"
        },
        {
          "trait_type": "Glasses",
          "value": "None",
          "rarity": 23.65,
          "_id": "685440524787f0d648e61db4"
        },
        {
          "trait_type": "Phantom",
          "value": "Azure",
          "rarity": 9.35,
          "_id": "685440524787f0d648e61db5"
        }
      ],
      "name": "Bunchy 1587",
      "description": "Sonic's very own Phantom Bunch. They're here again.",
      "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1587.webp",
      "tokenURI": "ipfs://bafybeifa6obtt3i7fq5zrpvwkaqkmn6xmitibixp4sjuo4jpzqj2tbvod4/1587.json",
      "metadata": {
        "tokenId": 1587,
        "name": "Bunchy 1587",
        "description": "Sonic's very own Phantom Bunch. They're here again.",
        "attributes": [
          {
            "trait_type": "Accessories",
            "value": "Leonardo"
          },
          {
            "trait_type": "Background",
            "value": "Arctic"
          },
          {
            "trait_type": "Eyes",
            "value": "Basic"
          },
          {
            "trait_type": "Glasses",
            "value": "None"
          },
          {
            "trait_type": "Phantom",
            "value": "Azure"
          }
        ],
        "image": "https://w3s.link/ipfs/bafybeifi7vjjfd3tnem4okdkadiylymugxb3w2f4chajr7qlzcniczajfu/1587.webp"
      },
      "createdAt": "2025-06-19T16:52:34.978Z",
      "updatedAt": "2025-08-20T23:22:43.083Z",
      "__v": 0,
      "rarityRank": 1,
      "rarityScore": 156.55016650096658,
      "imageProcessedAt": "2025-06-19T17:16:29.195Z",
      "mediaType": "image",
      "previewUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1587/preview.webp",
      "thumbnailUrl": "https://media.krownlabs.app/nfts/0x9e08f84ae540f68b573d821ef64208edecb97038/1587/thumbnail.webp"
    }
  ],
  "count": 1
}