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://yeldx.xyz/?ref=AB1C23
The code contains only letters and numbers — no wallet address, no personal data. It is safe to share publicly anywhere.
Referral system
sequenceDiagram
participant Alice
participant YeldX
participant Bob
Alice->>YeldX: Connects wallet → gets code "AB1C23"
Alice->>Bob: Shares link (yeldx.xyz?ref=AB1C23)
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 the code works
- You connect your wallet and receive a unique 6-character code
- Share
https://yeldx.xyz/?ref=YOUR_CODEanywhere - 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
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 leaderboard
The referral page shows your position:
| Column | Description |
|---|---|
| Rank | Your global rank by total points |
| Swap Points | Points from your own swaps |
| Referral Points | Points earned from invitees' activity |
| Total Points | Sum of both |
| Invitees | Number of wallets you referred |
Points tracking
Points are tracked in a database, updated by a cron job every 15 minutes that polls the LI.FI analytics API:
- Fetches all completed transfers with
integrator = LiFi-Hackathon - 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 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.