Appearance
Referrals
Referrers earn a share of every spot and futures fee paid by the people they invite, and by the people those friends invite, up to three levels deep. Each referrer has a tier; higher tiers earn bigger shares.
Open it from Admin → Users → Referrals (/exchange-control-panel/referrals). Only superadmins see this page. What users see is described in Referrals for users.
At the top
- Paid, all time and in the last 30 days, in USD at the time each commission was recorded.
- Being credited: commissions recorded but not paid yet (normally cleared within a minute).
- Referred users and how many referrers invited them.
- Paid by network level: the split between levels 1, 2 and 3.
- Referrers per tier.
Program & tiers
| Setting | Meaning |
|---|---|
| Program on | Off: no new commissions are recorded. Commissions already recorded are still paid. |
| Network depth | 1, 2 or 3 levels earn commission. With 1 level only direct referrers earn, like a classic referral program. |
Each tier row:
| Column | Meaning |
|---|---|
| Name | Shown to users. The badge comes from the tier number (Starter, Bronze, Silver, Gold, Platinum, Diamond). |
| Level 1 / 2 / 3 | Share of the friend's fee, in %, for each network level. Under level 1 you see the total of all levels. |
| Active friends | Goal: direct friends who traded in the last 30 days. |
| Friends' volume | Goal: the 30-day spot + futures volume of direct friends, in USD. |
- A referrer reaches a tier when they meet any one goal. A goal set to
0is ignored; a tier with both goals at0is invite-only (only by hand). - Goals must not go down as tiers go up, and the three levels of a tier can't add up to more than 100% (more than the fee itself). The page refuses to save otherwise.
- The first tier can't be removed: every account starts there. Use Add tier to add one on top, and the × on the top row to remove it.
- Saving re-ranks every referrer at once. New rates apply from the next trade.
Defaults
Starter 10 / 5 / 2 %, up to Diamond 40 / 10 / 5 % (100 active friends or $20M friends' volume). Starter's level 1 rate is copied from your old Referral fee setting on install, so nobody earns less than before. See the full table in Referrals for users.
The defaults come from a seeder, which php artisan db:seed also runs. To add back missing tiers, run php artisan db:seed --class="Database\Seeders\Levels\ReferralTierSeeder". It only adds tiers that don't exist, so your edits are kept.
How commissions are paid
transaction:referral-creditsruns every minute. It reads new spot trades and futures open/close fees, records one commission per referrer in the chain (fee × that referrer's rate for that level), and credits pending commissions to each referrer's Funding wallet in the fee's coin.- Each fee is recorded once, even if the job runs twice or overlaps, and each commission is paid once.
- Blocked (deactivated) or deleted referrers earn nothing; their unpaid commissions are marked Void.
- Trades from before the multi-level program was installed are not paid again. The footnote shows when it started.
- The Trades report in Reports → Finances shows spot income after referral commissions (the referral earnings column).
When tiers are recalculated
- Every hour (at :12) for referrers whose friends traded or signed up in the last 70 minutes.
- Every night at 00:35 for everyone who has invited someone.
- When a user opens their referral page and their tier is older than 30 minutes.
- When you save the tiers, or press Recalculate now on a user's page.
By hand: php artisan referrals:evaluate --all, or --user=15 for one user. When a tier goes up, the user gets a push notification in the mobile app.
Top referrers
The 10 referrers who earned most in the last 30 days, with their tier and how many friends paid them. All commissions opens Reports → Earn, referrals & bonuses, which shows every commission with its source (spot trade, futures open or close), level, rate, status, referrer and the friend who paid the fee.
Fixed tiers
Give a partner, influencer or market maker a tier by hand. A fixed tier wins over the calculated one until it expires or you remove it, and it works both ways (you can also fix someone lower).
- Press Assign tier.
- Search by email, name, UID or user ID. Each result shows the user's tier and how many friends they invited.
- Pick the tier, optionally an Until date (empty = until removed) and a Note only admins see.
- Press Set Gold (or the tier you picked). It applies from the next trade.
Use Edit or Remove on the list. The same is on each user's page: Users → Edit → Referral (see Users), which also shows who invited the user, their network, earnings, and a Commissions button. Staff with the user editor role can use that card.
