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:
- Simulate every signal. Each candidate signal is run through PerpBrain's book simulator, which prices published exchange fees, book-walk slippage and (where a holding period exists) hourly funding. Every result is labelled
SIMULATEDand places no order. - Pre-trade guard checks. Each intent is checked against a long-lived
GuardSessionpreset (conservative, standard or pro): leverage, order size, slippage, daily stop, open-position caps, stale-data rules, and a kill switch that a tool can engage but cannot clear. The owner sets these limits; losses are still possible. Each refusal is logged with its reason code. - Verifiable receipts. Every accepted simulation writes
receipt.json,manifest.jsonandinputs.json. Anyone can rerun those files with Verify a receipt. A mismatch fails the check.
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).
| Metric | Definition |
|---|---|
sims | Count of guarded simulations run in the week. Each result is labelled SIMULATED. |
verified_receipts | Count of those SIMULATED runs whose receipt directory re-verified successfully. |
guard_refusals | Count 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_bps | Book-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_bps | Fee 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_pct | Maximum drawdown for the week, as a percent of portfolio. Reported only when it has been measured. |
hit_rate | Share 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/sdk0.1.2- Receipts so far
- 0SIMULATED
- Latest week
- none yetupdated Fridays
SIMULATED and anyone can recheck it at Verify a receipt. This section refreshes every Friday (Asia/Qatar).What happens next
- Every Friday: Smooth Brains publishes its weekly metrics file and this page refreshes from it.
- First receipt: lands with Smooth Brains' next BTC signal, and the count above goes up.
- After review: guards move into the loop, so a refused intent stops a new position from opening.
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.