Skip to main content

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.

1. Overview

Orderly adds a brand new affiliate programme that allows DEXs and their affiliates to configure referral commission sharing, including the base commission that guarantees earnings from direct referrals. The core model is a funneled and multilevel referral system:
  • Builders work with their direct affiliates to grow their trading platform, with attractive referral commissions for the direct affiliates to build their own multilevel referral networks.
  • Affiliates higher up the hierarchy can set higher commission sharing ratios and pass a portion of their commissions down to referees, subject to the base commission minimum pass-down rate.

2. Prerequisites

Any users can participate as affiliates, provided that the DEX activates the new affiliate program. In some cases, a trading volume requirement may be necessary. If a volume prerequisite is set, users must meet it to qualify as an affiliate and begin building their referral network. Since the required volume may vary between DEXs, users should confirm the specific prerequisites directly with the DEX they wish to join.

3. New vs. legacy affiliate programs

The key differences between the legacy and new affiliate programs are summarized below:
DetailsLegacyNew
Referral networkSingle-level, only direct referralsMultilevel (up to 15 levels), direct and indirect referrals
Referral commissionAffiliates earn commissions from direct referees onlyAffiliates earn commissions from both direct and indirect referees down the referral chain, with base commission guaranteed for direct referrals
Commission configurationSingle-level commission up to 100%, decided by builderBuilder configures base commission B, then optionally assigns additional multilevel referral commission M individually. The top-level total rate is X_1 = B + M.
Referral code creationCreated primarily by the builder or qualified affiliates upon meeting the applicable trading volume requirements.Qualified affiliates can create codes after meeting the required trading volume (where applicable). Affiliates may only create one unique referral code.

4. Coexistence of legacy affiliate program

This new affiliate program is a multilevel referral system which supersedes the legacy affiliate program. DEXs who have enabled the legacy affiliate program could choose to keep the legacy system or upgrade to the new one. If you are already an existing affiliate, please check with your respective DEX directly for details regarding the activation of the new program. Once activated by the DEX, you will be able to generate a new referral code under this system. Please note that all existing legacy referral codes will remain active, and you will continue to earn commission from them.

5. Referral commission structure

DEXs configure the base commission BB for direct referrals. They can optionally assign a custom additional multilevel referral commission MM to each L1L_1 affiliate, making that affiliate’s top-level total rate X1=B+MX_1 = B + M. These L1L_1 affiliates are the initial referrers who establish a multilevel network and do not report to any referrer above them.
Note: Affiliate frontend wording and configuration controls may still use existing labels until a later frontend update; this guide introduces the base commission concept first.

5.1 Affiliate commission

Affiliates receive their referral commissions from the builder fees shared by DEXs. This commission is paid out for every trade executed on the DEX. (Fee)Builder=(Trading fee)N(Base fee)Builder\text{(Fee)}_\text{Builder} = \text{(Trading fee)}_N - \text{(Base fee)}_\text{Builder} where (Base fee)Builder\text{(Base fee)}_\text{Builder} depends on the builder fee tier of the DEX. L1L_1 affiliates may distribute a portion of their commission to their direct referees (L2L_2). This process can be extended further, as L2L_2 affiliates can further sub-divide their allocation to their direct referees (L3L_3), establishing a multilevel structure. This multilevel referral network can extend up to a total of 15 levels. Let BB be the base commission. It is the guaranteed commission rate a referrer earns from trades executed by their direct referrals. It is also the required minimum pass-down rate, so pass-down rates must be at least BB. Let MM be the additional multilevel referral commission assigned to the L1L_1 affiliate’s referral chain, and let XiX_i be the total commission rate at level ii. The top-level total rate is X1=B+MX_1 = B + M. Each downstream total rate must be between BB and the upstream total rate, for example X2[B,X1]X_2 \in [B, X_1]. DEXs may assign different additional multilevel referral commission values MM to strategic affiliates based on their growth strategy. Your available commission range depends on the total rate passed down from the referrer above you. For every trade executed by a user (LN)(L_N) on the DEX, the affiliates within the multilevel referral network can earn the following commission:
RoleAffiliate commission rateAffiliate commission
L1L_1 affiliateX1X2X_1 - X_2 where X2[B,X1]X_2 \in [B, X_1](X1X2)×FeeBuilder(X_1 - X_2) \times \text{Fee}_\text{Builder}
L2L_2 affiliateX2X3X_2 - X_3 where X3[B,X2]X_3 \in [B, X_2](X2X3)×FeeBuilder(X_2 - X_3) \times \text{Fee}_\text{Builder}
L3L_3 affiliateX3X4X_3 - X_4 where X4[B,X3]X_4 \in [B, X_3](X3X4)×FeeBuilder(X_3 - X_4) \times \text{Fee}_\text{Builder}
LN1L_{N-1} user (direct referrer)XN1X_{N-1} where XN1[B,XN2]X_{N-1} \in [B, X_{N-2}]XN1×FeeBuilderX_{N-1} \times \text{Fee}_\text{Builder} — Direct referrer earns base commission plus any remaining additional multilevel referral commission passed down
Note: Direct referrers earn the base commission rate from trades executed by their direct referrals.

Example: 3-Level Referral Network

Consider a trade where Builder revenue for a given trade = $100, with the following commission rates:
  • B=10%B = 10\% (base commission configured by the DEX)
  • M=40%M = 40\% (additional multilevel referral commission assigned by builder)
  • X1=B+M=50%X_1 = B + M = 50\% (L1L_1 total rate)
  • X2=35%X_2 = 35\% (L2L_2 total rate set by L1L_1, where X2[B,X1]X_2 \in [B, X_1])
  • X3=25%X_3 = 25\% (L3L_3 total rate set by L2L_2, where X3[B,X2]X_3 \in [B, X_2])
Commission distribution for $100 Builder revenue:
RoleCalculationCommission
L1L_1 affiliate(50%35%)×100(50\% - 35\%) \times 100$15
L2L_2 affiliate(35%25%)×100(35\% - 25\%) \times 100$10
L3L_3 affiliate (direct referrer)25%×10025\% \times 100$25
Total distributed$50
In this example, when L4L_4 (the trader) executes a trade, L3L_3 earns X3=25%X_3 = 25\%, which includes the 10%10\% base commission plus 15%15\% of the additional multilevel referral commission passed down the chain. The total distributed rate is 50%=B+M50\% = B + M. The L4L_4 trader does not earn commission from their own trade.

5.2 Referee’s commission rate adjustments

5.2.1 Default referee’s commission rate

Each referral code has a default commission rate for referees who use it to create an account on the DEX. The affiliate owning the code can update this rate, subject to the following rules:
  • If the code has no referees, the affiliate can freely adjust the default commission rate up or down, but any custom rate must be higher than the base commission and cannot exceed the upstream total rate available to the affiliate.
  • If the code has direct referees, the affiliate may only increase the default commission rate, applying changes to all direct referees on that rate. This restriction protects existing referrals and prevents unfavourable downstream changes.

5.2.2 Custom referee’s commission rate

Affiliates may customize a higher commission rate to overwrite the default rate for any direct referees, but any custom rate must be higher than the base commission and cannot exceed the upstream total rate available to the affiliate.