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

# API Broker Program: Earn Fee Share on Referred Trades

> Earn 10-50% of net exchange fees on every trade your referred users make. Referral codes attach to individual orders via the referral_code field.

Individual traders, community partners, and integrators can earn "broker" fees when they generate trading volume on Derive. The broker fees scheme is a flexible fee-share model: partners earn a percentage of the exchange fees on every trade a referred user makes, not just on account creation.

Referrals attach to **individual orders and quotes** via the `referral_code` field, so a single wallet can generate broker fees for multiple integrators depending on which client submitted each trade.

## How to earn broker fees

<Steps>
  <Step title="Register for the broker program">
    Complete the [API Broker application form](https://docs.google.com/forms/d/e/1FAIpQLSe7FD6NIk6fzT0tOoOsS6jlQP1wP0RUkdiAcxseKjQzmZxy-A/viewform?usp=preview).

    You may start generating broker fees before your application is fully approved, but you must submit the application within two weeks of your first referred trade to remain eligible.
  </Step>

  <Step title="Find your referral code">
    Your default referral code is your **Derive Wallet address**. You can find it in the app under **Home** → **Developers**. You may also register a custom human-readable code on the application form.

    Codes are **case sensitive**.
  </Step>

  <Step title="Pass referral_code on every order">
    Place your referral code (or your Derive Wallet address) in the `referral_code` field when submitting orders via `private/order`, quotes via `private/send_rfq`, or any other order-writing method. The field is supported over both WebSocket and HTTP POST.

    Brokers may also refer users via "referral links" generated by the UX. These links automatically fill in the `referral_code` field on trades placed from the linked session.
  </Step>
</Steps>

## Viewing your rewards

* Open the [Broker dashboard](https://pro.derive.xyz/broker).
* Enter your referral code (case sensitive).

## Fee tiers

You earn 10% of net trading fees from your first referred trade. Higher tiers unlock automatically when your 28-day volume or stDRV holdings cross the thresholds below.

| Level | 28-day volume | AND/OR | stDRV holdings | Fee share |
| :---- | :------------ | :----- | :------------- | :-------- |
| 5     | ≥ 500M        | AND    | ≥ 1M           | 50%       |
| 4     | ≥ 500M        | OR     | ≥ 1M           | 40%       |
| 3     | 50M-500M      | OR     | ≥ 500K         | 30%       |
| 2     | 5M-50M        | OR     | ≥ 200K         | 20%       |
| 1     | \< 5M         |        |                | 10%       |

## How the reward is calculated

Fee share is taken from the **net** trading fees earned by the exchange, after any reduced fee tiers and market maker rebates. Rewards are calculated per trade:

| Situation                                    | Reward                                         |
| :------------------------------------------- | :--------------------------------------------- |
| Taker order, maker has **positive** fee rate | `fee_share × taker_trade_fee`                  |
| Taker order, maker has **negative** fee rate | `fee_share × (taker_trade_fee − maker_rebate)` |
| Maker order, **positive** fee rate           | `fee_share × maker_trade_fee`                  |
| Maker order, **negative** fee rate (rebate)  | `0`                                            |

## Builder fees on top

Integrators approved for the API Broker program can also charge an additional **builder fee** on their users' orders through the `extra_fee` field. Builder fees are paid on top of broker fees and passed directly to the integrator's Derive Wallet.

<Card title="Builder Fees" icon="wrench" href="/integrators/programs/builder-fees">
  How to charge extra\_fee and receive it on the 4-week payout cycle.
</Card>

## Referrals

The `referral_code` field on orders and quotes is the referral mechanism exposed through the V3 API. Brokers can share invite links generated by the app that pre-fill the field. Multi-level invite endpoints from the legacy V2 API are not part of the V3 surface.

<Note>
  Rewards, thresholds, and the program itself are subject to change. All applicants are subject to review and approval by the Exchange. Participation is opt-in and requires providing all information requested on the application form.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Builder Fees" icon="wrench" href="/integrators/programs/builder-fees">
    Charge your own fee on top of exchange and broker fees.
  </Card>

  <Card title="Trading Fees" icon="receipt" href="/integrators/trading/trading-fees">
    Base fees that determine the pool broker rewards are drawn from.
  </Card>
</CardGroup>


## Related topics

- [public/get_referral_performance](/api-reference/referrals/publicget_referral_performance.md)
- [Integrators and Market Makers](/integrators/introduction.md)
- [Builder Fees on Derive](/integrators/programs/builder-fees.md)