Collection rank

How Ordinals Wallet ranks items in a collection by trait rarity.

Eligibility

A collection can be ranked when:

• It has at least one trait.

• Every inscription in it has the same number of traits.

Algorithm

1. Gather all traits and count the occurrence of each trait by looping over all inscriptions in the given collection. Divide the count of each trait by the total supply of the collection to get the share of items with that trait of items have that trait.

2. Give every inscription a score by looping over the inscriptions and taking the product of the inscription's trait counts.

3. Sort the inscriptions by score. If multiple inscriptions have the same score, the lower inscription number comes first.

Example

Below is a breakdown for ranking Planetary Ordinal rank #2 and rank #3.

Rank #2 detail

• Background = Grey stays (3 of 69)

• Holes = earthy vibes (1 of 69)

• Score = 3 = 3x1

• Inscription number = 1030

Rank #3 detail

• Background = Cherry blossoms (1 of 69)

• Holes = sunset ice (3 of 69)

• Score = 3 = 1x3

• Inscription number = 1031

Ranked items

[
    {
      "id": "ddbd767b66bc054bef3910f2fa01e543976f33baaa427a864b43095b939bbd56i0",
      "meta": {
        "attributes": [
          {
            "percent": "4.35%",
            "trait_type": "Background",
            "value": "Grey stays"
          },
          {
            "percent": "1.45%",
            "trait_type": "Holes",
            "value": "earthy vibes"
          }
        ],
        "name": "Planetary Ordinal #61",
        "rank": 2
      }
    },
    {
      "id": "cc987bebc1fc129b1d8fa1fcd5a66f6aeb626711f0c26c5249b726e905385a65i0",
      "meta": {
        "attributes": [
          {
            "percent": "1.45%",
            "trait_type": "Background",
            "value": "Cherry blossoms"
          },
          {
            "percent": "4.35%",
            "trait_type": "Holes",
            "value": "sunset ice"
          }
        ],
        "name": "Planetary Ordinal #39",
        "rank": 3
      }
    }
]

Get your collection ranked

Add traits to your items when you launch your collection. See Metadata and traits for the format.

Ranks are returned as meta.rank on inscription and collection item responses.