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.Documentation Index
Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt
Use this file to discover all available pages before exploring further.
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 |
Orderly base fees are set by the Builder’s builder staking
programme.
This tiering applies to the Builder’s base fee paid to Orderly. Builders still configure the
user-facing maker fee for their trading platform, and can set it negative so eligible maker trades
receive a rebate. Use the Trading
fees page for the current taker and
maker base fee tiers.
User Flow for Builders
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.
Calculate fee rates
Assign users to fee rates based on the chosen criteria.Orderly provides a fee tier assignment tool for volume-based tiers.
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.
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 enum fee settings.Set the default fee rate
Set the
default fee rate through POST /v1/broker/fee_rate/default.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 - Users assigned a new rate: send through POST
/v1/broker/fee_rate/set— batch bymaker_fee/taker_feecombination
All users are assigned the default fee rate unless overridden by the builder.
Retrieve fee rates
- User fee rate: GET
/v1/broker/user_info - Default fee rate: GET
/v1/broker/fee_rate/default
Builder Rebate Distribution
Builders receive daily rebates in their fee wallet, calculated after deducting any referral rebates.FAQs
Will there be limitations on how often fee rates can be changed?
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.
How to set fees for users?
How to set fees for users?
Builders can develop a custom tiered structure based on different parameters like volume, staked
tokens, etc.
Can I get help determining and setting fees?
Can I get help determining and setting fees?
Orderly provides a fee tier assignment
tool to help builders assign
users to volume-based tiers.
How does the rebate work for builders?
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.
How are fee rebates distributed?
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.
What are the fee wallet requirements?
What are the fee wallet requirements?
Currently EOA only, with multisig support upcoming.