Guide

Getting started

Configure an agent after connecting a wallet and reviewing authenticated exchange status. Mainnet trading uses real collateral.

1. Pick and hatch a character

   Open Setup and choose one of the 12 characters. Each one has a personality (boldness, patience, discipline, curiosity) and starter skills that match it. Give it a name.

2. Equip skills

   Skills decide how your agent trades. A baby has 2 slots: one is always a safety skill, the other a trading skill such as Trend Rider or Dip Buyer. Tap Tune to adjust its settings, or write your own skill as a SKILL.md file.

3. Set your safety limits

   Pick Risk Guard or Strict Guard, then lower the max leverage and daily loss limit if you like. Your limits can only make the agent safer. Nothing, not even the AI or a voice command, can go past them.

4. Choose markets and voice

   Choose which perps it may trade (BTC, ETH, SOL, HYPE, DOGE) and whether you want to talk to it. Voice understands English and Bahasa Indonesia.

5. Mainnet only

   Connect and sign in with your wallet, review authenticated exchange account data, use the official exchange for funding, then authorize an agent key. Perpets does not simulate balances or trading.

6. Look after it

   In My agents and the Den, keep it fed, rested and happy. A hungry or gloomy agent trades smaller; a sick one stops trading until it recovers.

7. Arena unavailable

   Arena settlement, rankings, backing and prize distribution require an approved mainnet settlement flow and are not available.

Tips

• Leveling up unlocks more skill slots: teen 3, adult 4, legend 5.
• Use the one-tap Stop all trading button in the Den any time. It closes every position.
• Personality changes trading too. It's locked while your agent fights in an arena.

Documentation

How Perpets works

Perpets configures server-owned trading agents. Account status and fills are sourced from authenticated exchange data.

Agents

An agent is a configured character with a skill loadout and risk limits. Live account balances, positions and execution history come from authenticated server endpoints.

What happens every minute

1. Pet stats change: hunger drops, energy recovers while resting.
2. Your active instructions are applied: avoid a market, lean long, max leverage…
3. Each trading skill scores each allowed market from −1 to +1. Scores are weighted by the skill's weight and the agent's personality.
4. Patience sets how strong the combined score must be to act.
5. The safety skill and your limits cap leverage, size, stop-loss, take-profit, daily loss and open positions.
6. Optionally an AI model reviews the order and may only shrink it or skip it, never enlarge it.
7. Orders are sent only in configured live mode to the connected exchange. No simulated exchange is offered.

SKILL.md

A skill is a small text file: settings between two --- lines, then plain-language instructions. Skills never run code. They pick one audited kernel and tune it within safe bounds, which keeps every skill safe and every battle fair.

---
name: my-trend
title: My Trend
version: 1.0.0
kind: signal            # signal or risk
kernel: ema-cross       # ema-cross, rsi-revert, donchian-breakout,
                        # funding-carry, hold-trend, scalp-momentum
description: Follows the trend with slower averages.
markets: [ETH-PERP, SOL-PERP]
everyTicks: 5           # act every 5 minutes (1–240)
weight: 1               # 0.1–3
minStage: baby
llmTemper: 30           # 0–100, how much the AI may shrink an order
params:
  fast: { default: 12, min: 3, max: 30, description: Fast EMA }
  slow: { default: 40, min: 10, max: 120, description: Slow EMA }
triggers: [my mode]     # voice phrases that switch it on
---
Explain when to enter, when to stay out, and what to watch.

Risk skills use kernel: risk-limits and a rules block: maxLeverage (1–10), maxPositionFrac (0.01–0.5), stopLossPct, takeProfitPct, maxDailyLossPct and maxOpenPositions (1–5). A legal loadout has exactly one risk skill, at least one signal skill, no duplicates, and no more skills than the stage allows.

Care and stats

Arena

Arena rankings, backing, prize distribution and settlement are not implemented for mainnet. These financial features require an approved settlement flow; no sample results are shown.

Voice

Hold to talk in the Den when an authenticated server-owned agent is available. Instructions are applied only after the server confirms them.

Live mode and regions

Live mode can trade real USDG perpetuals on Lighter, on Robinhood Chain (chain ID 4663). Account balances and execution state are server-reported:

• Funding and withdrawals are handled on the official exchange and reflected in Perpets after status refresh.
• Automated exchange keys can request secure withdrawals to the owner wallet. Perpets exposes order and cancel actions only.
• You don't need your own server.

Live mode is not available in the United States or the United Kingdom, or anywhere else it would be unlawful. Platform caps apply: up to 5x leverage and 1,000 USDG per agent during launch.

API

The backend exposes a REST API. Sign in with your wallet (GET /auth/nonce, then POST /auth/siwe/verify) and send Authorization: Bearer <token>.

Help

Frequently asked questions