Referrals
Introduction
The Referrals page is where you generate referral links and track everything they earn you. You earn 5% of every purchase your referrals make on Hippius, for life. Earnings are paid directly to your wallet on every qualifying purchase, with no manual claim required.
Reach Referrals from the sidebar at
Your Referral Link
At the top of the page you'll find your latest referral link in a copy friendly box, along with share buttons for X, Telegram, and Discord.
Copying the Link
Click anywhere on the link box (or the copy icon next to it) to copy the full URL to your clipboard. A toast confirms it was copied.
Sharing on Social
| Button | What happens |
|---|---|
| X (Twitter) | Opens X's tweet composer in a new tab with a pre filled message: an intro, the Hippius pitch, your link, and relevant hashtags. |
| Telegram | Opens Telegram's share dialog with a pre filled caption and your link. |
| Discord | Copies a formatted Discord message to your clipboard. A toast tells you it's ready to paste into any channel or DM. |
On larger screens the share buttons sit to the right of the link box. On smaller screens they wrap below it.
Refreshing
The refresh button reloads your referral links and history. Useful right after someone signs up via your link and you want to see it appear immediately.
Your Stats
Three stat cards below the link box show your referral performance:
| Card | What it tracks |
|---|---|
| Total Referrals | How many people have signed up using your link. |
| Total Usage | Aggregate clicks and conversions. |
| Total hAlpha Earned | Total commission credited to your wallet. |
Each card has its own date range selector (THIS WEEK / LAST 30 DAYS / LAST 60 DAYS / 1 YEAR / MAX) and a mini bar chart showing daily activity. Hover any bar to see the per day value.
Referral Links Table
Below the stat cards is a table of every referral code you've generated:
| Column | Description |
|---|---|
| Code | The code suffix added to the base URL. |
| Reward | Cumulative reward earned through that specific code. |
| Actions | Copy the code or the full URL to your clipboard. |
You can have multiple codes active at the same time. One per marketing channel makes it easy to compare which sources convert best in the table.
The referral link shown at the top of the page always uses your most recently generated code.
If you haven't generated any links yet, the table shows an empty state: "No referral links yet. Your referral links will appear here once generated."
Referral History Table
The Referral History table lists every signup that came through your link:
| Column | Description |
|---|---|
| User ID | The referred user's wallet address (truncated, with a copy icon for the full address). |
| Date | When they signed up. |
| Status | Active means this referral is still earning you commission. |
| Reward | Your total commission from that specific user so far. |
Use the search box to find a specific address, click any column header to sort, and use pagination to navigate.
How Earnings Work
Your 5% commission is calculated on the gross purchase value and paid automatically to your wallet on every qualifying transaction:
| Purchase type | Earns commission? |
|---|---|
| Card top up (Stripe) | ✅ Yes |
| TAO top up | ✅ Yes |
| Subscription plan payment | ✅ Yes |
| Usage credits consumed | ❌ No (the original top up already paid out) |
There is no minimum threshold or manual claim. The chain pays out automatically.
Best Practices
- Generate one code per channel. Separate codes for Twitter, your blog, Discord, etc. let you see which sources bring in the most referrals in the Referral Links table.
- Use the share buttons instead of pasting the raw URL. The pre filled messages are written for engagement on each platform.
- Refresh the page after sharing if you're watching for a specific person to sign up and the table hasn't updated yet.