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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fuul.xyz/core-concepts/tiers-and-multipliers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.