LIVE · SDK 0.1.4

Docs · Case study

CASE STUDY · FIRST CLIENT · SHADOW MODE LIVE

Smooth Brains

Smooth Brains is a BTC trading bot and PerpBrain's first client. Since 10 November 2026 it has sent every signal through PerpBrain in shadow mode: simulate the trade, check it against owner-set limits, and keep a receipt anyone can verify.

Figures on this page are SIMULATED process metrics from the live pilot, with no return claims. Read the risk disclosure before trading perps.

The pilot

Smooth Brains uses PerpBrain the way any outside team would: check a trade idea before acting, run it past owner-set limits, and keep a receipt anyone can re-verify. It installs the published @perpbrain/sdk package (0.1.2) and keeps its own codebase, keys and strategy.

Shadow mode went live on 10 November 2026 at 12:36 (Asia/Qatar), after PerpBrain's testnet trial. In shadow mode PerpBrain records what it would have said about each signal and never blocks or delays an order. Once a few weeks of shadow data have been reviewed, the next step is guards in the loop: a refused intent stops a new position from opening.

The method

Every candidate signal goes through the same three steps:

The two-page brief PerpBrain for Smooth Brains (PDF, 2 pages) sums up the integration and the data it produces.

More on the quickstart, owner limits and receipts.

Metrics being tracked

The pilot measures how well the process works: how many signals were simulated, how many receipts verified, what the limits refused, and how close simulated costs came to real fills. Every number comes from a weekly metrics file that Smooth Brains publishes each Friday (Asia/Qatar).

MetricDefinition
simsCount of guarded simulations run in the week. Each result is labelled SIMULATED.
verified_receiptsCount of those SIMULATED runs whose receipt directory re-verified successfully.
guard_refusalsCount of intents the owner-set limits refused, optionally broken out by code (including daily-stop, kill-switch and stale-data events).
sim_vs_actual_slippage_bpsBook-walk slippage from the SIMULATED run, minus slippage on a later actual fill, in basis points. Reported only when a comparable actual fill exists; otherwise left unreported.
fee_drag_bpsFee from the SIMULATED run, minus the fee actually paid, in basis points. Reported only when a comparable actual fill exists; otherwise left unreported.
max_drawdown_pctMaximum drawdown for the week, as a percent of portfolio. Reported only when it has been measured.
hit_rateShare of outcomes that meet a definition declared in that week's notes before the week is scored. Reported only with that definition; otherwise left unreported.

Queue position and liquidation cannot be compared: each receipt lists them as not modelled (NOT_MODELLED).

Results

Shadow mode · live

Live since
10 Nov 2026, 12:36Asia/Qatar
Client SDK
@perpbrain/sdk 0.1.2
Receipts so far
0SIMULATED
Latest week
none yetupdated Fridays
Waiting for the first signalFirst receipts appear here when Smooth Brains' first signal fires. Smooth Brains trades BTC only, so the first receipt lands with its next BTC signal. Each receipt is labelled SIMULATED and anyone can recheck it at Verify a receipt. This section refreshes every Friday (Asia/Qatar).

What happens next

Smooth Brains' strategy stays private; this page covers the method and the process numbers. PerpBrain is free and read-only today, with the builder fee off. Live quickstart · Verify a receipt.