Documentation Index
Fetch the complete documentation index at: https://docs.ekiden.fi/llms.txt
Use this file to discover all available pages before exploring further.
Ekiden points are XP ledger balances. They should be earned through measurable trading, referral, competition, or campaign activity and recorded with auditable ledger reasons.
Implemented XP Model
The backend rewards formula is rewards_xp_mvp_v1.
Each allocation run distributes a fixed weekly XP pool pro rata by power score:
base_power_score = volume * (1 + roi) * drawdown_factor
final_power_score = base_power_score + referral_bonus_power_score
weekly_xp = weekly_pool_xp * final_power_score / sum(final_power_score)
| Referral Level | Bonus |
|---|
| Level 1 | 15% |
| Level 2 | 10% |
| Level 3 | 5% |
Earning Sources
Core XP sources:
- Eligible trading volume and performance.
- Referral bonuses from active referred traders.
- Competition rewards and projected XP.
- Operator-approved manual grants or adjustments.
KOL campaign sources should use the same ledger model:
- Referred active traders that pass eligibility checks.
- Referred trading volume or fee contribution.
- Competition participation driven by a campaign.
- Campaign-specific quests with verifiable completion.
- Verified content deliverables that are reviewed and capped.
- Manual operator grants or clawbacks for edge cases.
Avoid uncapped raw impressions, follower counts, or screenshots as automatic point sources. They are easy to manipulate and should only influence manually reviewed campaign adjustments.
KOL Campaign Rules
KOL campaigns should be configured before launch and should not depend on ad hoc UI-only balances. Every campaign grant or correction should map to a ledger reason, an operator decision, or a deterministic backend allocation.
Minimum campaign configuration:
- Campaign identifier and active window.
- Eligible referral code or attribution rule.
- Minimum referred-user activity threshold.
- Per-user, per-KOL, and campaign-wide caps.
- Reward reasons used in the ledger.
- Review and clawback policy.
Recommended default thresholds:
| Rule | Default |
|---|
| Active referred trader | Referred account completes at least one eligible trade and meets the campaign minimum volume. |
| Eligible referred volume | Count filled notional from non-abusive perpetual trades during the campaign window. |
| Eligible referred fees | Count net trading fees from eligible fills, excluding rebates, reversals, and clawed-back activity. |
| Attribution | First valid referral binding wins unless operations approve a correction. |
| Content deliverables | Manual review required before points are granted. |
| Campaign caps | Apply per referred user, per KOL, and globally before granting manual campaign points. |
| Reason | Use |
|---|
weekly_allocation | Core weekly trading and referral XP allocation generated by the rewards service. |
kol_referral_active_trader | Referred user reaches the active-trader threshold. |
kol_referral_volume | Referred eligible volume or fee contribution. |
kol_competition_participation | Referred user joins or completes a campaign competition. |
kol_content_deliverable | Manually reviewed content milestone. |
operator_adjustment | Manual grant or correction. |
operator_clawback | Negative ledger entry for disqualified or reversed rewards. |
{
"campaign_id": "kol_s1",
"source": "operator",
"referral_code": "PARTNER42",
"referred_user_id": "user_abc",
"basis": "active_trader",
"window_start": "2026-06-01T00:00:00Z",
"window_end": "2026-06-30T23:59:59Z",
"operator": "ops@example.com"
}
delta_xp entries for clawbacks instead of rewriting history.
Abuse Policy
The following activity should be excluded or clawed back:
- Self-referral or circular referral chains.
- Wash trading, spoofing, or economically meaningless volume.
- Multi-account farming.
- Referral attribution manipulation.
- Campaign activity outside the eligibility window.
- Any activity tied to sanctioned, banned, or otherwise ineligible accounts.
User Visibility
Users should be able to inspect:
- Current referral code and referral tree summary.
- Trading XP, referral XP, and total XP.
- Recent ledger entries or allocation history.
- Leaderboard placement with XP fields.
- Campaign-specific caps and eligibility status when participating in a KOL campaign.
