Appearance
VIP levels
Every user has a VIP level, from VIP 0 upward. The level sets their spot and futures maker/taker fees and their 24-hour withdrawal limit. Users move up automatically as they trade more or hold more, and you can give any user a fixed level by hand.
Open it from Admin → Users → VIP Levels (/exchange-control-panel/account-levels). Only superadmins see this page.
How a user gets a level
A user reaches a level when they meet any one of its requirements:
| Requirement | What counts |
|---|---|
| 30-day spot volume | The quote value (in USD) of all the user's spot trades in the last 30 days |
| 30-day futures volume | Size × price (in USD) of the futures positions the user opened in the last 30 days |
| Assets | Everything in the user's wallets (Funding + Trading + locked in orders) plus margin in open futures positions, in USD |
The user gets the highest level they qualify for. A requirement set to 0 is ignored. A level with all three requirements at 0 can't be earned: it is invite-only and can only be given by hand (see Fixed levels).
Levels go down too: if a user's 30-day volume drops, the next check moves them to the level they still qualify for.
When levels are recalculated
- Every hour (at :07) for users who traded, held futures or had a wallet change in the last 70 minutes.
- Every night at 00:20 for everyone. This catches users who stopped trading.
- When a user opens their VIP page and their level is older than 30 minutes.
- When you save the schedule (everyone is re-ranked at once) or press Recalculate on a user's page.
Both scheduled runs use the account-levels:evaluate command, so the scheduler must be running. You can also run it by hand: php artisan account-levels:evaluate --all, or --user=15 for one user.
When a user's level goes up, they get a push notification in the mobile app ("You reached VIP 2").
The schedule
The top of the page shows how many users are on each level. Below it, every level is a row you can edit:
| Column | Meaning |
|---|---|
| Name | Shown to users, for example VIP 3. The badge colour comes from the level number. |
| Spot maker / taker | Fee in % of each spot fill |
| Futures maker / taker | Fee in % of each futures fill, charged on opening and on closing |
| 24h withdrawal | Maximum total withdrawals in USD over a rolling 24 hours. 0 = unlimited. |
| Spot volume, Futures volume, Assets | The requirements (any one is enough) |
Use Add level to add a row above the top level, and the × on the top row to remove it. VIP 0 can't be removed: it is the level every new account starts on, so its fees are your standard fees. The public Fees page (/fees, see Spot trading) shows VIP 0's rates.
Requirements must not go down as levels go up (a higher level must not be easier to reach). The page refuses to save if they do.
Changes apply to the next order or withdrawal: no restart needed.
Default schedule
On install, the schedule is created from your existing fee settings: VIP 0 has your old fees, and each level up pays a little less (VIP 8 pays 20% of the maker fee and 60% of the taker fee). Requirements start at $50K spot volume, $500K futures volume or $10K assets for VIP 1 and go up to $500M / $5B / $10M for VIP 8. Adjust them to your market.
The defaults come from a seeder, which php artisan db:seed also runs. To add back missing levels (for example after deleting them), run php artisan db:seed --class="Database\Seeders\Levels\AccountLevelSeeder". It only adds levels that don't exist, so your edits are kept.
How fees are charged
- Spot: a limit order reserves the taker fee when it is placed. If it rests in the book and fills as a maker, the difference is refunded at once.
- Futures: the fee is taken from the margin when a position opens and again when it closes (including take-profit, stop-loss and scheduled closes), at the user's level at that moment.
- The fee rates in Settings → Trading & fees are no longer edited there: they always equal VIP 0.
Withdrawal limit
- The limit is in USD. Every crypto and fiat withdrawal in the last 24 hours counts, except rejected or failed ones.
- Users without KYC are also capped by 24h cap for unverified users in General settings, whichever is lower. Their VIP page tells them to verify to raise it.
- Two withdrawals sent at the same moment can't both slip past the limit: they are checked one after the other.
Fixed levels
Give a user a level by hand, for example for a market maker, a partner or a VIP client. A fixed level wins over the calculated one until it expires or you remove it. It works both ways: you can also fix a user to a lower level than they earn.
On the VIP Levels page:
- Press Assign level in the Fixed levels card.
- Search for the user by email, name, UID or user ID. Each result shows the user's current level.
- Pick the level, and optionally an Until date (empty = until you remove it) and a Note that only admins see.
- Press Set VIP n. The new fees and limit apply right away.
The Fixed levels list shows every user with a fixed level, the level their activity would give them (Calculated), the end date and the note. Use Edit to change it or Remove to send the user back to their calculated level. Expired fixed levels are cleared at the next recalculation.
You can do the same from the user's own page: Users → Edit → VIP level (see Users). That card also shows the user's volumes and assets and a Recalculate now button. Staff with the user editor role can use it.
What users see
- A VIP page (
/vip) with their badge, progress to the next level, every level's benefits and the full fee schedule. Guests see the schedule. See VIP levels for users. - Their level and fees under the order form on the spot and futures pages, and a VIP chip in the header's account menu.
- The same page in the mobile app (Account → VIP Level).
