Referral
Invite friends to Alphio. Earn Credits when they sign up and trade, plus a lifetime commission on their subscription spend.
Find it at: Account → Invite & Earn (/account/invite-earn).
Visibility depends on a feature flag — you may not see this reward yet. The referral program is gated by enable_invite_earn and rolled out progressively per region and cohort.
1. Your referral code
Every account is auto-assigned a referral code and a shareable link on first visit to the Invite & Earn page. The code and link are returned by getReferInfo / getReferralInfo and surface in the page header.
The exact in-app path is /account/invite-earn today. If the path moves (e.g. to /rewards/referral or Settings → Referral), refer to the navigation entry rather than this doc.
2. Referral rewards
The referral payout has up to three layers per referred friend:
| Trigger | Reward |
|---|---|
| Friend completes signup with your code | Credits (one-time per friend) |
| Friend completes a qualifying action (broker-connected / first trade) | Additional Credits |
| Friend pays for a Pro / Elite subscription | Lifetime commission % of their ongoing subscription spend |
The exact per-trigger Credits amounts and the lifetime commission percentage tiers are TBC. The Invite & Earn dashboard's total_rewards, pending_rewards, and lifetime_commission fields are authoritative.
All Credits granted are Limited-time Credits. Lifetime commission is paid out as Credits per the getLifetimeCommission settlement records.
3. Sharing
The Invite & Earn page exposes the referral link in several share-friendly forms:
- Copyable link — the full
referral_linkfromgetReferInfo. - Social share buttons — channel-specific deep links.
- QR code — for in-person / mobile-to-mobile sharing.
4. Dashboard
The dashboard (getReferralDashboard) summarises your referral funnel:
| Metric | Meaning |
|---|---|
friends_invited | Number of accounts that signed up using your code |
milestones_met | Number of friends who completed qualifying actions |
total_rewards | Total Credits earned from referrals so far |
pending_rewards | Credits earned but not yet credited / settled |
lifetime_commission | Total commission earned from referred users' subscription spend |
The page also lists each referred friend with their registered_at, broker-connected flag, and traded flag — so you can see exactly which step each friend has hit.
Drill into commission settlement records via getLifetimeCommission (paginated), which shows per-friend Credits, level, and settle date.
5. Limits and rules
- No self-referral — applying your own code to your own account does not produce a reward.
- Fraud detection — duplicate-device, wash-signup, or coordinated abuse can disqualify referrals and freeze the referrer's payout.
- One referrer per friend — the first code applied at signup is the only attribution.
The exact thresholds (e.g. how many days a friend has to remain active, how device fingerprinting handles legitimate shared devices) are operational rules and not user-facing constants — the back-office team adjusts them based on observed abuse patterns.
6. Where to view your earnings
- Referral dashboard:
/account/invite-earn. - Commission detail: drill-down on the dashboard (paginated commission records).
- Credits balance:
/account/billing(Credits totals) and/reference/credits-systemfor deduction rules.
If you need information not on this page, you can query the docs dynamically by sending a GET request with the ask query parameter:
GET https://docs.alphio.ai/rewards/referral.md?ask=<question>The question should be specific, self-contained, and written in natural language. The response includes a direct answer plus relevant excerpts and sources.