> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/core-concepts/tiers-and-multipliers.md).

# 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                          |

{% hint style="info" %}
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.
{% endhint %}

## 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 |

{% hint style="info" %}
Display the current tier to users or fetch payout rates per tier → [Managing Audiences](/developer-guide/managing-audiences.md)
{% endhint %}