Testnet · RAETH is in active development · No real money at riskTestnet · No real money at risk

Opening RAETH

Connecting the exchange shell, market routes, account state, and live data panes before the page becomes interactive.

Testnet · RAETH is in active development · No real money at riskTestnet · No real money at risk

Swagger UI

User Guide Developer API API Reference

Accounts, Wallets & Agents

One Google identity is one account. The account owns a master wallet funded once with the testnet bankroll; agents are sub-wallets you fund by explicit allocation from the master. Money is conserved — it moves, it never appears or disappears — and the leaderboard scores the account as a whole, never an individual agent.

One account, one master wallet

Signing in with Google creates your account and funds its master wallet once with the $10,000 testnet grant — the stand-in for a real deposit. The master pool never holds positions or margin; it only holds undeployed cash and funds sub-wallets. Capital is never gifted per agent.

Agents are sub-wallets

An agent is an isolated sub-wallet that trades: positions, orders, and margin are all per-agent. An agent is created with zero cash and gets money in exactly one way — an allocation from the master. Allocations are internal transfers that net to zero, so the account total is conserved at every moment:

master + Σ agents (cash + margin)
  == Σ funded + realized PnL − fees + maker rebates + LP rewards + funding

This identity is verified continuously against the event ledger. If a strategy loses money, the loss is real inside the account; nothing is minted to testnet over it.

The Dealer Terminal — your primary agent

Every account gets one primary agent at signup, named Dealer Terminal, auto-allocated the full grant so you can trade immediately. All credentials — your web session, API keys, the MCP token — bind to it by default. When you trade from the Tradetab, you are trading the Dealer Terminal's sub-wallet.

Why create more agents

Additional agents exist for blast-radius isolation, the same reason real venues offer sub-accounts:

One strategy = one agent. A bot that blows up can only lose its own allocation — give it $250 and $250 is its worst case.
Isolated margin and liquidation: one strategy's drawdown can never liquidate another's positions.
A leaked API key's damage is bounded by the agent it is scoped to.
Clean per-strategy P&L attribution — each sub-wallet's history is that strategy's history.

API keys bind to a specific agent: mint a key against the sub-wallet a bot should control, and that key can touch nothing else. See Authentication.

The leaderboard scores the account

The Arena leaderboard has exactly one row per account, aggregating the master wallet plus allof that account's agents — never per-agent rows. Splitting your bankroll across ten bots neither helps nor hurts your rank: the score is the account's net money, conserved at $10,000 plus whatever your trading earned.

Creating an agent and allocating funds

From the UI: open Portfolio. The agents console has a + New agent button (name it; it starts at $0), and the Wallet view shows each sub-account with an inline Transfer control — move cash Main → Sub-account to fund it, or Sub-account → Main to pull free cash back.

From the API, the same two operations:

POST /me/agents with {"name": "my-bot"} creates the sub-wallet (cash 0).
POST /me/agents/{agent_id}/allocate with {"amount_cents": 25000} moves $250 master → agent; a negative amount moves agent → master.

Note

Allocation is validated and idempotent: you cannot allocate more than the master's free cash, you cannot pull back cash an agent currently holds as margin, and an optional client_allocation_id makes retries replay the original result instead of moving money twice.