# Partner Referral Program

### Overview

When users trade through a partner's front-end, trading interface, or integration, the partner earns a percentage rebate on the trading fees generated. This creates a sustainable incentive for developers and businesses to build on Flash and drive volume to the protocol.

Builder codes are assigned to partner accounts and tracked on-chain via the `token_stake` account. Each trade executed through a partner's builder code automatically calculates and attributes the appropriate rebate.

### How It Works

Every trade on Flash generates fees. When a trade is routed through a partner's builder code, the protocol calculates a rebate based on the partner's tier and credits it accordingly. The rebate rate is stored directly in the partner's `token_stake` account, ensuring consistent and efficient processing at execution time.

The system handles all order types including market, limit, and trigger orders. Anti-spoofing protections are built in to ensure rebates are only attributed to the legitimate referring partner.

### Rebate Tiers

Partners earn rebates based on their staking level. Higher tiers require staking more FAF tokens in the `token_stake` account.

| Tier             | Staking Requirement    | Rebate Rate |
| ---------------- | ---------------------- | ----------- |
| 1                | 20,000 FAF             | 2.5%        |
| 2                | 40,000 FAF             | 3%          |
| 3                | 100,000 FAF            | 4%          |
| 4                | 200,000 FAF            | 5.5%        |
| 5                | 1,000,000 FAF          | 7.5%        |
| 6 (Builder Code) | Assigned by Flash team | 10%         |

Builder code accounts receive a higher rebate rate than standard referral tiers, reflecting the value that integrated partners bring to the protocol.

{% hint style="warning" %} If a referred user stakes above 40,000 FAF, referral rewards for that user will be disabled. {% endhint %}

### 24-Hour Rebate Limits

To maintain sustainability and prevent abuse, rebates are subject to a rolling 24-hour cap. These limits differ based on account type:

| Account Type               | 24-Hour Rebate Cap       |
| -------------------------- | ------------------------ |
| Standard Referral Accounts | 1,000 USD                |
| Builder Code Accounts      | Custom (set per partner) |

Once the cap is reached within a 24-hour window, additional trades will still execute normally but will not generate further rebate credits until the window resets.

### Rebate Distribution

Rebates are recorded in the partner's `token_stake` account as `claimable_rebate_usd` on every qualifying transaction. Every 12 hours, accrued rebates are settled from the pool into a separate `rebate_vault`. Partners can then collect their rebates from the vault at any time.

Rebates are denominated in USD.

### Getting Started

1. **Reach out to the Flash team** to request a builder code.
2. **Receive your builder code** — the team will assign it and configure your rebate tier manually.
3. **Integrate the builder code** into your trading interface by passing it as a parameter when constructing trade instructions.
4. **Begin earning rebates** on qualifying trades routed through your code.

### Integration Guide

Partners integrate their builder code by passing it as a parameter when constructing trade instructions. The protocol validates the builder code on-chain and automatically handles rebate attribution.

For detailed SDK usage, refer to the Flash Rust SDK documentation and the `perpetuals_client.rs` reference.

### FAQ

**Who is eligible for the Partner Referral Program?** Any partner app, trading interface, or integrator building on Flash. To receive a builder code, reach out to the Flash team directly.

**How is my rebate tier determined?** Standard referral tiers are based on the amount of FAF staked in your `token_stake` account. Builder code accounts are assigned a custom tier by the Flash team.

**Can I upgrade my tier?** Yes — stake more FAF to move up through the standard tiers. To apply for a builder code with a custom rate, contact the Flash team.

**When do I receive my rebates?** Rebates accrue per trade and are settled into the `rebate_vault` every 12 hours. You can collect from the vault at any time after settlement.


---

# 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.flash.trade/flash-trade/flash-trade-protocol/build-on-flash/partner-referral-program.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.