Marketplace data
Traits and rarity
Read a collection's trait types and values with counts, percentages and trait floors, and learn how rarity ranks, scores and tiers are computed.
Traits are the attributes an NFT carries, such as Background: Aqua. The API counts every trait value in a collection, finds the cheapest listing for each value, and ranks every item by rarity. Use these figures for filter sidebars, trait floor tables and rarity badges.
Trait types
GET /collections/{slug} returns traitTypes: each trait type and how many distinct values it has. See Collections and stats.
[
{ "type": "Background", "valueCount": 11 },
{ "type": "Fur", "valueCount": 18 },
{ "type": "Rarity Tier", "valueCount": 4 }
]Trait values, counts and floors
Returns every trait value in the collection as { data: TraitValue[] }, grouped by trait type, most common value first within each type. The list is not paged. The endpoint takes no query parameters besides ?type= (a Move type in place of the slug).
curl "https://rare.market/api/v1/collections/mystic-yetis/traits"{
"data": [
{
"type": "Rarity Tier",
"value": "Tier 1",
"count": 2127,
"pct": 39.77,
"floorMist": "29938600000",
"floorPriceMist": "15009900000",
"sales90d": 75,
"median90dMist": "20000000000",
"lastSaleMist": "14669900000",
"lastSaleAt": "2026-10-24T15:22:22.306Z",
"premium": 1
},
{
"type": "Rarity Tier",
"value": "Tier 4",
"count": 346,
"pct": 6.47,
"floorMist": "47722000000",
"floorPriceMist": "42990000000",
"sales90d": 24,
"median90dMist": "43200000000",
"lastSaleMist": "43200000000",
"lastSaleAt": "2026-10-25T15:48:15.691Z",
"premium": 2.564
}
]
}The example shows two of the collection's values.
Trait facts
When value analytics are available, each row (and each attribute on GET /items/{id}) also carries:
Treat these fields as optional. See Analytics for how the value model works.
Filter items by trait
Pass trait values to the items grid as type:value pairs. Values of one type are ORed, different types are ANDed:
curl -G "https://rare.market/api/v1/collections/mystic-yetis/items" \
--data-urlencode "traits=Background:Aqua,Background:White,Fur:Ice"See Items for the full syntax.
Rarity
Every item card has rarity: { rank, tier }, or null when the item has no rank.
{ "rank": 2221, "tier": "uncommon" }How the rank is chosen
- The rank is our own, computed from trait frequency over every item the index knows for the collection, as below. Burned items are left out. The method is also described for collectors at rare.market/about/rarity.
- When a collection cannot be ranked from traits and another marketplace publishes a full ranking for it, those ranks are used as they are.
- A collection with fewer than two items with traits gets no ranks, and
rarityisnullon its items.
GET /collections/{slug} returns rarity: { source, ranked }: source is rare (our ranks), drip or tradeport (that venue's ranks), or null when nothing is ranked, and ranked is the number of items with a rank. Ranks are recomputed a few minutes after a collection changes (mints, burns or trait changes).
How the score is computed
The computed score is a sum of inverse trait frequencies:
score(item) = sum over every trait type T in the collection of N / count(T = item's value for T)Nis the number of items that have any traits.N / countis 1 divided by the value's frequency.- Trait names match without case or extra spaces, and numeric values match by value (
1and1.0are the same). - An item with several values for one trait type scores each of them.
- An item that lacks a trait type counts as having the value
Nonefor it, so missing a common trait is itself a trait. - Rarer values give a bigger term, so a higher score means a rarer item.
Items are then sorted by score, highest first. The rarest item is rank 1. Items with equal scores share a rank, and the next rank skips ahead (1, 1, 3).
The score itself is not returned by the API; only rank and tier are.
Tiers
tier comes from the rank's percentile among the ranked items of the collection (rank / ranked items):
Sort by rarity
On GET /collections/{slug}/items, sort=rarity_asc puts rank 1 first and sort=rarity_desc puts the most common first. Unranked items come last in both. With status=all, listed items still come before unlisted ones; see Items.
curl "https://rare.market/api/v1/collections/mystic-yetis/items?sort=rarity_asc&limit=10"Gotchas
pctis not of supply. Its denominator is the items with attributes the index has read, which can be lower thansupply.- Values are exact strings. Numbers and booleans in on-chain attributes become strings. Matching is case-sensitive and keeps spacing as the creator wrote it (one collection has a trait type
Mystic Yetiwith two spaces). - Two floors.
floorMistis the live all-in trait floor.floorPriceMistis a bare list price from the last analytics run and can lag the live market. - Creator traits named like rarity are ordinary traits. A trait such as
Rarity Tier: Tier 1is the creator's own label and has no link to the computedrarity.tier. - Trait offers are not indexed yet. Trait-level offers return empty lists today. See Offers.
