Leaderboards

What they are for

A leaderboard is how your empire sees who matters for rewards and recognition. It ranks people using a metric you choose—token balances, NFT holdings, social activity, a spreadsheet you upload, or scores from your own systems.

That ranking becomes the basis for fair splits when you send funds from the treasury, and it helps the community understand who is most engaged.

You can run several leaderboards at once. Each one appears as its own tab, up to the number your empire supports.

Ways you can rank people

Roughly, leaderboards fall into a few families:

• Token holders — Rank by how much of a chosen ERC-20 people hold.

• NFT holders — Rank by how many NFTs people hold from a collection (or related rules the product supports).

• Social and ecosystem — Rank using activity or reputation tied to Farcaster or partner signals (channels, casts, interactions, and similar).

• Your own data — Rank using scores from an API you control, or from a CSV file you upload.

The exact options available in the product may grow over time; when you set up a leaderboard, you pick the type that matches how you want to reward behavior.

What each row means

For each person on a leaderboard you typically see:

• Score — The raw number from the metric (for example, token balance or engagement count). This is the “honest” ranking signal before any bonuses.

• Points — The score after boosters (loyalty multipliers) are applied. Weighted and raffle-style treasury sends use points so active supporters can earn a larger share without hiding the underlying score.

• Total rewards — How much value this address has already received from treasury distributions for this empire—useful for transparency and storytelling.

• Rank — Position on this leaderboard (1 is the top).

• Identity — When available, a linked social handle (for example Farcaster) so members recognize each other.

Tabs and ordering

Leaderboards share a fixed set of numbered slots (tabs). New leaderboards take the next free slot so you do not have to micromanage numbering; the product assigns the lowest unused slot that fits your plan.

Keeping data fresh

Leaderboards can be refreshed so rankings reflect the latest balances or external scores. Refreshes are intentional (not necessarily live every second), and there is a short cooldown between refreshes so updates stay predictable and fair for everyone.

Connecting leaderboards to payouts

When you run a treasury distribution, you choose which leaderboard drives the payout. You can split funds evenly across everyone listed, in proportion to points (weighted), or run a raffle weighted by points—depending on what fits your community norms.

For how points relate to scores when boosters apply, see Boosters.