Quick Start

Open. Talk. Trade.

No strategies to code. Your 7 agents start analyzing as soon as you sign in — the perps crew scales up when you connect an exchange, and Plop reads Polymarket and Kalshi out of the box. Chat with them directly, approve trades when you're ready, and let them coordinate 24/7.

What You'll See

The desk is built around real-time visibility and control:

Dashboard. Your home base — an overview of agent activity, market conditions, and portfolio status at a glance.

Agent Chat. Talk to your agents directly. Ask for market views, request analysis, or discuss trade ideas. This is where you interact with your team.

Trading. The order builder — entry, targets, stop loss, leverage, and sizing. Approve agent recommendations or build your own trades.

Portfolio. Your open positions, P&L tracking, and position management across connected exchanges.

Signals. Live signal feed from your agents — what they're seeing across markets in real time.

War Room. Watch the consensus process. See how Riven synthesizes input from Vanta, Luma, and Meridian into a unified recommendation.

Digest. Catch-up summaries when you've been away. What happened, what your agents recommended, and what moved.

Step-by-Step: Getting Started

Step 1: Create Your Account

Navigate to perpdesk.xyz and sign in. PerpDesk supports wallet login and social login via Discord, Twitter, or Telegram.

During setup, you'll choose your experience level and set a display name. This helps your agents tailor their communication style.

Step 2: Connect Your Exchange

Navigate to your profile settings and add your exchange API credentials:

Exchange → Settings → API Keys → Create New Key

Enable these permissions:

• Read: Market data and position monitoring
• Trade: Order execution
• Futures: Perpetual futures access

Currently supported exchanges:

• Hyperliquid
• Lighter

Step 3: Meet Your Agents

In the Agent Chat or Dashboard, you'll see your 7 active agents:

• Vanta — Market regime detection (trending, ranging, volatile, quiet, transitioning)
• Luma — Signal aggregation (funding rates, OI, volume, liquidation data)
• Meridian — Macro monitoring (economic events, regulatory news, cross-asset signals)
• Riven — Consensus and strategy (synthesizes all inputs into one recommendation)
• Brix — Risk enforcement (position sizing, exposure caps, leverage limits, daily loss)
• Koda — Execution guidance (entry style, timing, trade staging)
• Plop — Prediction-market analyst (Polymarket, Kalshi). Drop a market URL into chat for a calibrated p(YES) and edge read.

Step 4: Configure Your Risk Parameters

Before enabling live execution, set your boundaries. These are enforced by Brix as hard limits:

• Max position size — Largest position any agent can recommend
• Max leverage — Highest leverage agents can use
• Max exposure — Total portfolio exposure cap
• Daily loss limit — Stop trading if daily losses exceed this threshold

Step 5: Start in Monitoring Mode

Let your agents run in monitoring mode first. In this mode, agents analyze markets and generate recommendations without executing any trades. This lets you:

• See how agents interpret market conditions
• Understand the quality of recommendations
• Build confidence before risking capital
• Learn the agent pipeline by observation

Step 6: Enable Trading

Once you're comfortable with agent recommendations:

1. Keep Brix in active enforcement (always on)
2. Start approving individual trade recommendations from the Agent Chat or Trading view
3. Gradually increase autonomy levels as trust builds

Your First Trade

Here's what happens when your agents generate a recommendation:

The pipeline runs:

1. Candle closes — technical indicators update (EMA, RSI, MACD, Bollinger, ATR, StochRSI)
2. Vanta, Luma, and Meridian analyze in parallel
3. Riven waits, then runs a consensus debate across agent inputs
4. One broadcast recommendation per symbol
5. Brix filters against your personal risk parameters
6. Koda adds execution guidance (entry style: sniper, ladder, or market)

You see:

• Trade plan (entry, targets, stops, sizing)
• Risk assessment (position impact, exposure, leverage)
• Execution guidance (how to enter the trade)
• Agent rationale (why they recommend this)

You decide:

• Approve as-is
• Modify and execute
• Reject

Once approved, the trade executes on your connected exchange with stop-loss and take-profit monitoring.

Key Principles

Human-in-the-Loop. Agents propose. You decide. Full transparency always.

Progressive Trust. Start conservative. Monitor for a few sessions. Increase autonomy as you gain confidence.

No Code Required. Every agent is configurable through the UI. No scripting, no technical setup.

Need Help?

• Agent Chat — Ask your agents questions directly about their analysis or recommendations
• Documentation — Core Concepts and AI Agents cover everything in detail
• Paper Trading — Use the mock exchange to practice before going live