agorix
AirdropMarketsCollectionsLeaderboardActivity
Agorix · Decentralized Marketplace
Independent · Resilient · Community-Run

A cross-chain marketplace, run by the community.

Discover, list, and trade across Bitcoin, Ethereum, and Solana on an open, community-run network.

Marketplace
CollectionsMarketsLeaderboardActivity
Network
GovernanceExplorerAirdropDocs
Account
ProfileSettings
Legal
Terms of ServicePrivacy PolicyYour Privacy Choices
agorix.io — Lasting Access
CID: 0xA60R1X · v0.1
AirdropMarketsCollections
D
Protocol Docs
Marketplace OverviewAtomic Buy LocksDatabase ArchitectureProfiles & AuthenticationCollections & RoyaltiesCreator Royalty SystemMedia Cache & OptimizationModeration & ReputationSearch & DiscoveryCollection Rarity AlgorithmsLive Activity & LeaderboardsCollection Preseed Queue
Docs/Marketplace/Collection Rarity Algorithms
Marketplace

Collection Rarity Algorithms

Three rarity modes (DEFAULT, HYBRID, CUSTOM) with creator-owned weights, per-token overrides, and trait-type weighting. How rarity scoring stays transparent while letting collection owners express their own intent.

#Collection Rarity Algorithms

Rarity is one of the most subjective signals in any NFT marketplace. A purely platform-computed score ignores what the creator considers rare; a fully creator-controlled score is unverifiable and easy to game. The marketplace splits the difference: every collection has a transparent platform score, and creators can layer their own scoring on top through one of three modes.

#Three Modes

ModeBehaviorBest For
DEFAULTPlatform-computed score from on-chain trait distributionsMost collections — no creator action needed
HYBRIDBlend of platform score and creator-supplied per-token scores using configurable weightsCollections where some tokens have story value beyond raw trait math
CUSTOMRanking driven entirely by creator-supplied scores, but the platform score remains stored on every token for transparencyGenerative + manually curated drops, "1/1 within edition" mechanics

The platform score is never deleted — even in CUSTOM mode it stays on each token row so anyone can compare the creator's ranking to the trait-distribution baseline.

#Algorithm Configuration

Per-collection settings live in collectionRarityAlgorithms:

FieldPurpose
modeDEFAULT / HYBRID / CUSTOM
defaultWeightWeight applied to the platform-computed score in HYBRID mode
customWeightWeight applied to the creator-supplied score in HYBRID mode
configJSONB blob with optional fine-grained controls: traitValueWeight, traitCountWeight, traitTypeWeights (per-trait-type multipliers)
createdByAddress / updatedByAddressAudit trail tying every change back to a wallet

In HYBRID mode, the effective score for a token is:

text
score = (defaultWeight * platformScore) + (customWeight * customScore)

If only one weight is non-zero, HYBRID degenerates cleanly into DEFAULT or CUSTOM behavior.

#Per-Token Overrides

Creators can override individual tokens in collectionTokenRarityOverrides regardless of mode:

FieldPurpose
tokenIdentifierWhich token within the collection
customScoreNumeric score used by HYBRID/CUSTOM modes
customRankExplicit rank that wins over computed score (useful for "this is the artist's pick")
labelOptional display label (e.g. "Founder's Edition", "Legendary")
metadataFree-form JSONB for whatever else the creator wants to surface

Override rows are keyed by (collectionId, tokenIdentifier) so a creator can selectively annotate a handful of tokens without touching the rest. Indexes on customScore and customRank keep sort/list queries fast even on collections with tens of thousands of tokens.

#Token Stats

Per-token rarity is materialized into collectionTokenStats for cheap lookups:

ColumnPurpose
traitCountNumber of traits the token carries (a common rarity heuristic)
defaultRarityScorePlatform-computed score, always present
defaultRarityRankPlatform-computed rank within the collection

The marketplace surfaces both the platform values and the override values side-by-side, so buyers can see both views and decide which one matters to them.

#Why Creator Control Matters

A pure trait-distribution score punishes intent. A 1/1 hand-drawn piece that happens to share a common background trait would rank below noisier algorithmic art. By making the override path first-class — and recording every change as an authenticated, audited update — the marketplace lets creators express their actual ranking without forcing buyers to take the creator's word for it. Both numbers are always visible.

PreviousSearch & DiscoveryNext Live Activity & Leaderboards

On this page

  • Collection Rarity Algorithms
  • Three Modes
  • Algorithm Configuration
  • Per-Token Overrides
  • Token Stats
  • Why Creator Control Matters