Rebate Records
There is no dedicated records endpoint. 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, commission accrual, claim)
- On-Chain Rebate Info — Placeholder on-chain rebate endpoints (no contract integration yet)
Commission Calculation
When a referred trader (referee) executes a trade, the commission is calculated as:
commission = trade_fee × tier_commission_rate
tier_commission_rate is the referrer's tier rate at the time of the fill (see Tier System); if the referrer has not reached the Starter threshold, no commission accrues. Each accrual is credited to the referrer's pending balance and written to Referral Logs as a commission_accrued entry.
Both maker and taker fees generate separate commission records if the respective trader has a referrer (each side of a fill is a separate trade row with its own fee).
Earnings Balances
Earnings are tracked as per-referrer balances rather than per-record statuses; they surface on the Referral Dashboard:
| Dashboard field | Description |
|---|---|
pending_earnings | Accrued but not yet claimed |
claimed_earnings | Claimed via off-chain settlement (POST /v1/referral/claim) |
total_earnings | Lifetime accrued (pending + claimed) |
There is no on-chain synced state.
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
Status: Not yet implemented (空缺).
Pending referral earnings are not synced to any on-chain contract, and POST /v1/referral/on-chain/claim-signature is not implemented. Off-chain claims via POST /v1/referral/claim are the only settlement path.