# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.