> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Referrals

> Share a referral code to give eligible traders fee discounts and receive commissions on the fees they pay.

Eligible referred traders receive a **4% fee discount**, and you receive **10% of their eligible fees after discount**. Both amounts are calculated on-chain for each fill, subject to separate volume caps.

## How it works

| Step | Who | Rule |
| - | - | - |
| **Create a code** | Referrer | Your main account's cumulative trading volume must reach **\$1,000**. You can register one code: 6–20 ASCII letters or digits, stored in upper case. |
| **Bind to a code** | Referee | Your cumulative trading volume must remain **below \$1,000**. You can bind once, and the link is permanent. |
| **Trade** | Referee | Eligible positive maker or taker fees receive a **4% discount**. |
| **Receive commission** | Referrer | **10% of eligible fees paid after discount** accrues to your referral balance. |
| **Claim** | Referrer | Claim your full unclaimed referral balance once it reaches **1 USDC**. |

The code must be available to register. Registration and new bindings reject codes containing an active reserved substring, regardless of case. Spaces and punctuation are invalid. Later reserved-code changes leave existing bindings and accrued rewards intact.

Your main account holds the link. Its sub-accounts share the link, registration threshold, and volume caps.

## What each side gets

| | Referee | Referrer |
| - | - | - |
| **Benefit** | **4% off** eligible positive trading fees | **10%** of eligible fees paid after discount |
| **Paid** | Credited to the trading account during settlement | Accrued for you to claim |
| **Limit** | First **\$25,000** of eligible traded notional since binding | First **\$1 billion** of each referee's eligible traded notional since binding |

Commission goes to the direct referrer only. There are no multi-level payouts.

## Volume and amount calculations

The registration and binding threshold uses cumulative trading volume across your main account and sub-accounts. It has no rolling time window.

Referral caps measure eligible traded notional since binding, not fees paid or rewards received. Ordinary fills with zero fees or negative maker fees still use the caps. Referral exclusions do not remove trades from your cumulative platform volume.

The discount and commission caps apply independently. If a fill crosses either cap, only its eligible portion receives that benefit.

Amounts use increments of 0.000001 USDC. The post-discount fee is rounded first; commission is then calculated from the eligible share of that rounded fee. Exact half increments round up. A positive post-discount fee has a minimum of one increment; an exact zero remains zero. Small discounts or commissions can be zero after rounding.

## What does not count

* **Self-referral and loops.** You cannot bind to your own code or create a referral cycle.
* **Trades between your own accounts.** Neither side receives commission or uses referral volume caps. Eligible positive fees can still receive a discount.
* **Liquidations and auto-deleveraging.** Liquidation- or ADL-generated order sides receive no commission and do not use referral volume caps. An ordinary counterparty's order side follows the normal referral rules. Liquidation fees can still receive an eligible discount.
* **Vaults and protocol accounts.** These accounts receive no discount or commission.
* **Zero fees and maker rebates.** These fees remain unchanged and generate no referral commission.

## Claiming

Once your unclaimed referral balance reaches **1 USDC**, a successful claim pays the full amount to your main account. An authorized agent can submit it for you. The destination remains your main account.

The fee collector funds claims. If its balance cannot cover the claim, the operation is rejected without transferring rewards or advancing your claimed amount. You can try again later.

Discounts reduce the [trading fee](https://docs.intention.xyz/trading/fees.md) collected on each fill. Referral commissions accrue separately until claimed.

## For developers

The C++ SDK's referral client provides `register_code`, `bind_referrer`, and `claim`. Query balances with `get_overview`, invitees with `get_invitees`, claims with `get_claims`, and fills with `get_fills`.

Each fill side with a nonzero discount or commission emits a `DexReferralFeeEvent`. To reconstruct a referrer's unclaimed balance, combine commission events with referral bindings and claim history.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.