Points & Referral Program
YeldX rewards users for actively using the platform and bringing others in.
How points are earned
| Action | Points |
|---|---|
| Swap via YeldX | 1 point per $1 swapped |
| Refer a friend | 10% of all points your invitee earns, forever |
Points are awarded automatically within 15 minutes of your transaction being confirmed on-chain. There is no manual claim step.
Referral codes
Every wallet gets a unique 6-character referral code (e.g. AB1C23) automatically assigned when you connect for the first time.
Your referral link looks like:
https://lifi-59513674.slonix.dev?ref=AB1C23
The code contains only letters and numbers — no wallet address, no personal data. It is safe to share publicly anywhere.
Referral flow
sequenceDiagram
participant Alice
participant YeldX
participant Bob
Alice->>YeldX: Connects wallet → gets code "AB1C23"
Alice->>Bob: Shares referral link
Bob->>YeldX: Connects wallet via Alice's link
Bob->>YeldX: Swaps $1,000 → earns 1,000 pts
YeldX->>Alice: Automatically awards 100 pts (10%)
How it works
- You connect your wallet and receive a unique 6-character code
- Share your referral link anywhere (X, Telegram, Discord, etc.)
- When someone visits your link and connects their wallet, they are linked to you
- Every time they swap via YeldX, 10% of their earned points goes to you — automatically, forever
Share on X
The referral page includes a Share on X button that creates a pre-composed tweet with your points stats and a link that renders a branded OG image showing your rank and total points.
Privacy
| What is public | What stays private |
|---|---|
Your referral code (AB1C23) | Your wallet address |
| Number of invitees | Who referred you |
| Points earned | Invitees' full wallet addresses |
In your invitees list, addresses are shown masked: 0xA1B2C...D3E4F (first 5 + last 5 characters only).
Points dashboard
The referral page (/referral) shows:
| Metric | Description |
|---|---|
| Swap Points | Points from your own swaps |
| Referral Points | Points earned from invitees' activity |
| Total Points | Sum of both |
| Rank | Your global rank by total points |
| Invitees | List of wallets you referred with their points |
Points tracking
Points are tracked in a Postgres database, updated by a cron job every 15 minutes that polls the LI.FI analytics API:
- Fetches all completed transfers with the YeldX integrator ID
- For each new swap, awards
floor(volume_usd)points to the depositor - Awards
floor(volume_usd × 0.10)points to the depositor's referrer (if any) - Each swap is recorded once (by tx hash) to prevent double-counting
Points are off-chain and for tracking purposes only. Future token distributions based on points will be announced separately.
FAQ
Can I change my referral code?
No. Codes are permanently assigned to your wallet address.
Can I change my referrer?
No. The first referral code you used on wallet connection is permanent.
Do referral points expire?
No. Referral points accumulate indefinitely.
My code isn't working — what do I do?
Make sure you're sharing the full link including ?ref= and that the code is exactly 6 characters. Codes use only letters A–Z (excluding O and I) and numbers 2–9 (excluding 0 and 1) to avoid visual confusion.