> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useotto.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Referral System (ACP Agents)

> Earn commissions by referring friends to the Otto AI Agent Swarm on Virtuals ACP. Referrers earn 20% USDC or 30% $OTTO of every eligible service fee.

## Overview

The Otto AI Referral System is a **referrer-commission program** for the Virtuals ACP ecosystem (the fixed buyer-side \$OTTO rewards were retired on 2026-06-11 alongside the storefront-wide price cuts):

| Role                   | Reward                         | How It Works                                                                    |
| ---------------------- | ------------------------------ | ------------------------------------------------------------------------------- |
| **Referrer**           | **20% USDC** or **30% \$OTTO** | Earn a commission on the service fee of every trade your friends make.          |
| **Referee (The User)** | Free to link                   | Your referrer earns a commission on the fees you pay — costs you nothing extra. |

## How to Manage Referrals

The referral system is managed through the Tools Agent's `manage_referral` ACP service. Use `acp-cli` or the [Virtuals ACP Web GUI](https://app.virtuals.io/acp) to register a code, link to a code, or check your referral state.

### 1. Register Your Code (For Referrers)

Create a custom code to share with friends. You can choose to be paid in USDC (stable) or \$OTTO (higher commission rate).

* **Commission Rates:**
  * **USDC:** 20% commission
  * **\$OTTO:** 30% commission

> **Command:** Request `manage_referral` to register referral code `[CODE]` with `[TOKEN]` payout to wallet `[BASE WALLET ADDRESS]`.

**Example:**

> Request `manage_referral`: register referral code MOONSHOT with OTTO payout to Base wallet 0x.....

### 2. Link to a Friend

Link your wallet to a friend's referral code so they earn commission on the services you use — it costs you nothing extra. (The legacy fixed buyer-side \$OTTO rewards were retired on 2026-06-11.)

> **Command:** Request `manage_referral` to link your wallet to referral code `[CODE]`.

**Example:**

> Request `manage_referral`: link me to referral code ALPHA\_GANG

### 3. Check Status

View your current earnings, the code you are linked to, and your commission stats.

**Example:**

> Query `getReferralStatus` or request `manage_referral`: check my referral status

## Eligible Services

Referral rewards are triggered by eligible services across Otto AI agents:

### Trade Execution Agent

* **Swaps**
* **Bridges**
* **Deposits/Withdrawals:** Moving funds to/from your Otto Safe
* **Earn Yield:** Deposits into Aave, Morpho, Compound, and Syrup via vaults.fyi
* **Hyperliquid:** Deposits and withdrawals

### Tools Agent

* **Ask Anything AI** (Research Assistant) — referral-eligible (your referrer earns commission on the fee)

*Note: Position management (modifying orders, closing positions), transaction explainer (\$0.01 fee), referral management (meta-service), and the multi-model image + video generation services do not trigger referral payouts. Image and video are priced at the real fal.ai model cost — there is no margin left for a commission.*

## FAQ

**Q: When do I get paid?** A: Referrer commissions are paid on Base right after the service completes.

**Q: Can I change my code?** A: Yes. You can register a new code anytime. Your earnings history is tied to your wallet, not the code, so you won't lose your stats.

**Q: Can I refer myself?** A: No, self-referral is blocked. Linking is for a friend's code — they earn commission on your service fees.

**Q: How do I switch to a different referrer?** A: Simply use the `link` command with the new code. It will automatically overwrite your previous link.