> For the complete documentation index, see [llms.txt](https://docs.timeless.market/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timeless.market/trading/referral-system.md).

# Referral System

The Referral System is designed to attract new users through existing players and help grow the Timeless Market community. By inviting others to join, users can earn rewards from the trading activity

The Referral Summary provides a full overview of referral activity, including:

* Total referral trading volume (USD1)
* Total rewards earned by referrer (USD1)
* Total number of referred users
* Total number of referees who have traded
* Date filters - view results by custom date range (From – To)

**Transaction History**

The **Referral History** page displays up to **20 records per page**, showing:

* Referee wallet address
* Trade timestamp
* Trade volume (USD1)
* Referrer reward (USD1)

All data is stored **on-chain** to ensure transparency and verifiability.

**VIP Program - Fee Rebate System**

Users who maintain high trading volumes can **unlock VIP levels** and receive **monthly fee rebates**. This encourages **active trading** and **long-term participation**.

**Mechanism**

The system automatically tracks users’ **30-day trading volume**.

* The system automatically tracks users’ **30-day trading volume**.
* Each cycle runs from **00:00 UTC on the 1st of each month**, lasting **30 days**.
* At the end of the cycle, users can **claim their fee rebate** on-chain.
* After claiming, the **VIP level resets** to 0 for the next cycle.

**VIP Tiers**

| VIP Level | 30-Day Volume (USD1) | Fee Rebate (%) | Perks                                  |
| --------- | -------------------- | -------------- | -------------------------------------- |
| VIP 0     | < 5,000              | 0%             |                                        |
| VIP 1     | ≥ 5,000              | 10%            |                                        |
| VIP 2     | ≥ 10,000             | 20%            | Can create 1 prediction event/month    |
| VIP 3     | ≥ 20,000             | 30%            | Can create 2 prediction events/month   |
| VIP 4     | ≥ 40,000             | 40%            | Can create 3 prediction events/month   |
| VIP 5     | ≥ 80,000             | 50%            | Can create 4 prediction events/month   |
| VIP 6     | ≥ 240,000            | 60%            | Can create 5 prediction events/month   |
| VIP 7     | ≥ 480,000            | 70%            | Can create unlimited prediction events |

> **Example:**
>
> If a user trades $100,000 USD1 in 30 days and pays $3,000 USD1 in trading fees:
>
> * Current level: VIP 5
> * Rebate: 50% of fees → 0.5 × $3,000 = $1,500 USD1&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.timeless.market/trading/referral-system.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.