Rebate Records
Query the list of invitees and rebate commission data through the following endpoints:
- Referral Status — View all referred users and binding status
- Referral Dashboard — View earnings summary, tier info, and recent commission activity
- Referral Logs — Paginated history of all referral operations (create, bind, unbind, claim)
- On-Chain Rebate Info — Query on-chain rebate data directly from smart contracts
Commission Calculation
When a referred trader (referee) executes a trade, the commission is calculated as:
commission = trade_fee × tier_commission_rate
Both maker and taker fees generate separate commission records if the respective trader has a referrer.
Earnings Status
| Status | Description |
|---|---|
pending | Earned but not yet claimed |
claimed | Claimed via off-chain settlement (POST /referral/claim) |
on_chain_synced | Synced to the on-chain ReferralRebate contract |
Minimum Claim Amount
The minimum off-chain claim amount is 10 USDT. Claims below this threshold will return a BELOW_MINIMUM error.
Batch On-Chain Sync
Pending referral earnings are batch-synced to the on-chain ReferralRebate contract every hour via batchSyncRebates. After syncing, users can also claim on-chain using the POST /referral/on-chain/claim-signature endpoint.