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

# Custom Fee Structure

> How builders configure custom maker/taker fee structures for their users on top of Orderly base fees.

The Custom Trading Fee System allows builders to tailor fee structures for their users beyond Orderly's standard fees, giving builders the flexibility to set fees that align with their strategies and customer profiles.

## Overview of Fee Structure

|                  | Orderly Base Fee                                 | Builder-Set User Fee            |
| ---------------- | ------------------------------------------------ | ------------------------------- |
| **Who receives** | Orderly (100%)                                   | Builder (100%)                  |
| **Taker**        | Based on the Builder's fee tier                  | Set by builder                  |
| **Maker**        | Based on the Builder's fee tier; can be negative | Set by builder; can be negative |

<Note>
  Orderly base fees are set by the Builder's [builder staking
  programme](/introduction/trade-on-orderly/trading-basics/trading-fees#builder-staking-programme).
  This tiering applies to the Builder's base fee paid to Orderly, with the same base rates applying
  to crypto and RWA markets. Builders can still configure different user-facing trading fees for
  crypto and RWA trades respectively, including negative maker fees so eligible maker trades receive
  a rebate. Use the [Trading
  fees](/introduction/trade-on-orderly/trading-basics/trading-fees) page for the current taker and
  maker base fee tiers.
</Note>

## User Flow for Builders

<Steps>
  <Step title="Determine fee tiers">
    Decide on the logic for fee tiers based on specific criteria (e.g. volume, staked tokens), or set all users under the same fee rate.
  </Step>

  <Step title="Calculate fee rates">
    Assign users to fee rates based on the chosen criteria.

    Orderly provides a [fee tier assignment tool](https://github.com/OrderlyNetwork/orderly-evm-broker-fee-admin) for volume-based tiers.

    <Note>
      The fee rate is the total charged to, or rebated to, the user (Orderly base fee + custom fee). For taker fees, the custom fee cannot be less than the Orderly base fee. For maker fees, builders can configure a negative user-facing maker fee so qualifying maker trades receive a rebate.
    </Note>

    <Note>
      Custom user and default fee rates must be set in decimal-rate increments of `0.00001`, which
      equals `0.001%` or `0.1 bps`. This precision rule applies to standard custom fee settings, not
      order tag fee settings.
    </Note>
  </Step>

  <Step title="Set the default fee rate">
    Set the `default` fee rate through [POST `/v1/broker/fee_rate/default`](/build-on-omnichain/restful-api/private/update-default-builder-fee).
  </Step>

  <Step title="Set per-user fees">
    Send updated fee assignments to Orderly:

    * **Users keeping their current rate (including default):** no update needed
    * **Users reset to default:** send through [POST `/v1/broker/fee_rate/set_default`](/build-on-omnichain/restful-api/private/reset-user-fee-rate)
    * **Users assigned a new rate:** send through [POST `/v1/broker/fee_rate/set`](/build-on-omnichain/restful-api/private/update-user-fee-rate) -- batch by `maker_fee`/`taker_fee` combination

    <Note>
      All users are assigned the default fee rate unless overridden by the builder.
    </Note>
  </Step>

  <Step title="Retrieve fee rates">
    * User fee rate: [GET `/v1/broker/user_info`](/build-on-omnichain/restful-api/private/get-user-fee-rates)
    * Default fee rate: [GET `/v1/broker/fee_rate/default`](/build-on-omnichain/restful-api/private/get-default-builder-fee)
  </Step>
</Steps>

### Builder Rebate Distribution

Builders receive daily rebates in their fee wallet, calculated after deducting any referral rebates.

## FAQs

<AccordionGroup>
  <Accordion title="Will there be limitations on how often fee rates can be changed?">
    There are no inherent limitations besides API rate limits, but we recommend prudent management
    to maintain consistency and trust with end users.
  </Accordion>

  <Accordion title="How to set fees for users?">
    Builders can develop a custom tiered structure based on different parameters like volume, staked
    tokens, etc.
  </Accordion>

  <Accordion title="Can I get help determining and setting fees?">
    Orderly provides a [fee tier assignment
    tool](https://github.com/OrderlyNetwork/orderly-evm-broker-fee-admin) to help builders assign
    users to volume-based tiers.
  </Accordion>

  <Accordion title="How does the rebate work for builders?">
    Builders keep all fees above the Orderly base fee. When the Builder's base maker fee is
    negative, the builder receives the maker rebate from Orderly and can choose to pass it on by
    configuring a negative user-facing maker fee.
  </Accordion>

  <Accordion title="How are fee rebates distributed?">
    Builder fee rebates are distributed daily to the builder's Orderly account registered with the
    wallet provided during the builder ID setup.
  </Accordion>

  <Accordion title="What are the fee wallet requirements?">
    Currently EOA only, with multisig support upcoming.
  </Accordion>
</AccordionGroup>