🏆Tiers & Multipliers

By default, all users earn the same payout rate. Tiers let you change that for specific groups — giving ambassadors, NFT holders, or top traders a higher rate or a multiplier on top of the default.

A user can qualify for multiple tiers at once, but only the highest-ranked tier applies — tiers never stack.

1. Create an audience

Audiences define who belongs to a tier. They can be dynamic or static:

Type	How it works	Examples
Dynamic	Users are added automatically when they meet a condition	Token holdings, NFT holdings, Dune query
Static	A manually curated list of addresses	Ambassadors, partners, hand-picked users

2. Create a tier

Once you have an audience, go to Audiences → Tiers and create a tier linked to it.

Field	Description
Name	Display name for the tier (e.g., "Ambassadors", "Diamond")
Description	Optional context for what the tier represents
Rank	Priority order — if a user qualifies for multiple tiers, the highest-ranked one applies
Audience	The audience whose members automatically qualify for this tier

When manual approval is enabled on a tier, users who qualify do not advance automatically — an admin must approve the transition first. When disabled, tier resolution is automatic.

3. Add the tier to your incentive

With the tier created, open any incentive's payout settings and click Add tiers. For each tier you add, choose how users in it are rewarded:

Option	Example
Amount	Users in this tier earn $0.05 per USD of volume
Multiplier	2× gives users in this tier twice the default payout

API endpoints

Endpoint	Method	Description
/v1/projects/:projectId/tiers	POST	Create a new tier
/v1/projects/:projectId/tiers	GET	List all tiers
/v1/projects/:projectId/tiers/:tierId	PATCH	Update a tier
/v1/projects/:projectId/tiers/:tierId	DELETE	Delete a tier
/v1/projects/:projectId/tiers/reorder	POST	Bulk reorder tiers
/v1/payout-terms/by-tier	GET	Retrieve payout terms grouped by tier

Display the current tier to users or fetch payout rates per tier → Managing Audiences