Appearance
VIP, referrals & airdrops
Three programs reward users for trading, inviting friends and joining campaigns. They are independent of each other, run automatically and are all managed from Admin → Users.
VIP levelsLower trading fees and higher withdrawal limits as users trade more or hold more.OpenReferralsUsers earn a share of their friends' trading fees, up to three levels deep.OpenAirdropsGive away any coin to users who join a campaign, paid at a set time.Open
At a glance
| VIP levels | Referrals | Airdrops | |
|---|---|---|---|
| What users get | Lower spot and futures fees, higher 24h withdrawal limit | A share of every fee their network pays | Free coins |
| How they qualify | Any one goal over 30 days: spot volume, futures volume or assets | Invite friends; higher tiers by active friends or friends' volume | Join a live campaign and meet its rules |
| Levels | VIP 0 – VIP 8 | Starter – Diamond, network levels 1–3 | One campaign at a time per user |
| Paid to | (cheaper fees) | Funding wallet, every minute | Funding wallet, at the payout time |
| User page | /vip | /referral | /airdrop |
| Mobile app | Account → VIP Level | Account → Referral | Home banner, Account → Airdrops |
| Admin | Users → VIP Levels | Users → Referrals | Users → Airdrops |
| Fixed by hand | Yes: fixed level per user | Yes: fixed tier per user | Not needed: choose the rules |
How they work together
- Fees and commissions: a user's trading fee comes from their VIP level. Their referrers' commissions are a share of that fee, so commissions shrink when the trader's VIP level lowers their fee. The trader never pays more because of referrals.
- Volume counts twice: the same 30-day trading volume moves a user up the VIP levels and moves their referrer up the referral tiers (friends' volume).
- Airdrop rules can require a minimum balance, KYC or a minimum account age. They don't depend on VIP level or referral tier.
- Blocked or deleted accounts get none of the three: no reduced fees once blocked, no commissions (unpaid ones are voided) and no airdrops.
Defaults on a new install
php artisan db:seed (and the migrations) create:
- VIP 0 – VIP 8, VIP 0 using your fee settings (details).
- Six referral tiers, Starter using your old referral fee (details).
- No airdrops: create campaigns in Admin → Airdrops.
Re-running the seeders only adds missing levels and tiers; your edits are kept.
Background jobs
The scheduler must be running:
| Command | When | Program |
|---|---|---|
account-levels:evaluate | Hourly at :07, --all daily at 00:20 | VIP levels |
transaction:referral-credits | Every minute | Referral commissions |
referrals:evaluate | Hourly at :12, --all daily at 00:35 | Referral tiers |
airdrops:distribute | Every minute | Airdrop payouts |
Push notifications (mobile app)
- "You reached VIP n" when a user's VIP level goes up.
- "Referral tier: …" when a user's referral tier goes up.
- "Airdrop received" when an airdrop reward is paid.
See Push notifications for setting up Firebase.
