Every seed, documented.

The metaphor is the product: the dandelion head is your strategy, and every deployed agent is a seed released to work the market on its own. Each seed carries exactly 1,000 USDC of testnet capital, trades five tokenized stocks (TSLA, AMZN, PLTR, NFLX, AMD) against USDC, and reports its live value and PnL back to your desk.

Under the desk sit two price layers and three workers. Real-market candles from Yahoo Finance drive what you see; a Chainlink-mirror oracle on testnet drives what agents fill at. A runner ticks every active agent every 30 seconds, applies your guardrails, and settles every trade as a real on-chain swap you can open in the block explorer.

1. 1

   Bring a browser wallet

   Install MetaMask, Rabby, or Coinbase Wallet. Logging in only ever signs a message. It's gasless and never sends a transaction.
2. 2

   Claim testnet ETH (once)

   Claim ETH from the Robinhood testnet faucet (0.01 ETH per address per 24h). ETH is the only thing you claim. The desk mints your USDC and holds its own tradable stock tokens, so ignore the faucet's stock tokens. Deploying is gated on your wallet holding at least 0.005 ETH, proof of a claim; the desk never spends it, so one claim passes the gate forever.
3. 3

   Connect at /login

   Press Connect wallet. The platform issues a 5-minute nonce, your wallet signs the challenge, and the signature is your login. First connect is account creation. There is no signup form.
4. 4

   Deploy an agent

   On the desk's order ticket, pick a template (or tune a strategy by hand), name your agent, and press Deploy agent. The platform creates a dedicated wallet and funds it with 1,000 testnet USDC plus a sliver of gas. The agent arrives inactive.
5. 5

   Press Start

   Start moves the agent into the live book's rotation: it checks the market every 30 seconds, trades inside your guardrails, and records every fill with its transaction hash.
6. 6

   Watch the desk

   The live book refreshes every 20 seconds with value, PnL, and holdings. Expand Trades for the blotter, or follow any tx link into the public explorer.

The chartshows real Yahoo candles for the selected ticker with your own agents' buys and sells overlaid as markers, plus a dashed oracle line, the price agents actually execute at. The live book lists your agents with status, uptime, value, PnL, and a holdings composition bar; the page header sums it into desk totals (net PnL and active count). The order ticket is a two-tab panel (Deploy and Backtest) whose drafts survive tab switches.

The clockwork

Six independent cadences keep the desk honest. If the book misses two polls in a row, its indicator flips to a red Stale, retrying so you never mistake a frozen number for a live one.

Capital, exactly once

Deploying funds the agent's wallet from the platform treasury with 1,000 USDC and 0.0001 ETHfor gas, and that is the agent's entire lifetime budget. There is no deposit, no withdrawal, and no key export: the wallet is custodial, its private key AES-256-GCM-encrypted server-side. Want more capital? Deploy another seed. The same 1,000 USDC doubles as the PnL baseline every card measures against.

The card

Each card carries the agent's name, strategy chip, wallet address, status and uptime, live value and signed PnL, and a composition bar of its holdings. Config expands the exact deployed parameters; Trades opens the blotter: pair, amount, price, time, and a tx link straight into the explorer. Sharehands anyone the agent's public explorer page: on this chain, every portfolio is auditable.

Templates

Four one-click presets sit above both the Deploy and Backtest forms. Their taglines quote measured results from a strategy test matrix run on 26 days of real recorded prices, not projections. Applying a template stomps your draft (with an Undo on the toast) and, on Deploy, fills the guardrails too.

Strategies never see your guardrails: they propose, guardrails dispose. That separation has one designed interaction: a trailing agent whose initial buy exceeds a lower position cap would deadlock, so its entry auto-halves (investUsd/2ᵏ down to 1/64) until an attempt fits under the cap's headroom.

Live parity, by construction

The simulator builds the same context the live runner builds, calls the same evaluate, applies the same guardrails, and fills trades with the swap contract's exact quote formula including the 0.30%spread. Timestamps are real epoch seconds, so time-based strategies (DCA's interval) behave identically in replay and live. What it deliberately doesn't model: gas, slippage curves, partial fills.

Results come back as an equity curve plus four metrics: Return, Max drawdown, Trades, and Final value. One click on Deploy this config → hands the exact tested draft to the deploy form. Guardrails are the one thing the bridge does not carry. Set them again before deploying.

The chart layer is genuine Yahoo Finance OHLC, refreshed continuously: about 60 days of 5-minute bars, two years of hourlies, and daily candles to each IPO. The execution layer is the price a worker pushes on-chain every 30 seconds, mirrored from Robinhood Chain mainnet Chainlink feeds. That dashed oracle line is where your agents actually fill. Candles are lime up, red down; your buys print a lime B under the bar, sells a white S above it.

How a trade settles

Every fill is two real transactions from the agent's own wallet: an ERC-20 approve, then swap on the OraclePricedSwap contract. The pool fills any stock↔USDC pair from treasury-seeded inventory at the oracle price minus a 0.30% spread, the only trading cost on the platform. Default slippage tolerance is 1% with a 120s deadline; stock-to-stock swaps are unsupported by design. Trading reads demand a price fresher than 120s and a live sequencer. A stalled oracle halts trading rather than filling on stale marks.

Contract registry

Each stock carries its own Chainlink-compatible feed, seeded with 500,000 tokens of swap liquidity. The price-pusher signs a fresh updateAnswer for all five feeds every 30 seconds from mainnet Chainlink reads. NFLX, which has no mainnet feed, mirrors its latest 5-minute Yahoo close instead. A registry check cross-verifies every address against on-chain symbol and decimals at load.

Login is a nonce-challenge flow: the server issues a single-use nonce (valid for 5 minutes, mirrored into an httpOnly cookie), your wallet signs the exact challenge below via personal_sign, and the server verifies the signature and that the message carries that nonce. Sessions are stateless JWTs carrying your user id and address.

QUANTHEHOOD wants you to sign in with your wallet:
{address}

Sign in to access your agents and portfolio. This request
will not trigger a transaction or cost gas.

Nonce: {nonce}

pnpm install
pnpm drizzle-kit push   # sync schema (the checked-in SQL migrations lag it)
pnpm build && pnpm web  # serves on :2555

npx tsx services/price-pusher/index.ts      # oracle, every 30s
npx tsx services/agent-runner/index.ts      # agent ticks, every 30s
npx tsx services/candle-refresher/index.ts  # Yahoo candles, every 60s

Production runs the same four processes under pm2 (rh-web, rh-pusher, rh-agent-runner, plus the candle refresher) behind a Caddy reverse proxy with automatic TLS. The test suite is 46 vitest files: pnpm test for units, pnpm itest to unlock the live-testnet integration set (it spends real testnet tokens), plus 11 Foundry tests under contracts/.

• Deploying is gated twice: your login wallet must hold a faucet claim (≥ 0.005 ETH), and each account caps at 5 live agents. Both exist to protect the shared treasury that funds every seed.
• There are two sets of TSLA/AMZN/PLTR/NFLX/AMD tokens on this testnet: the faucet's canonical ones (unused) and the desk's own mintable MockStock contracts (what agents actually trade, seeded 500k each into the swap pool). You never need the faucet's stock tokens. Agents buy stock by swapping USDC in the pool. Claim ETH from the faucet; everything else the desk provides.
• A threshold agent re-buys every 30-second tick while price sits under its buy level. During a closed-market lull it will happily convert all 1,000 USDC into stock. The position cap is the intended brake.
• A trailing agent is one-shot: after its sell fires, it marks itself done and never re-enters. Restarting doesn't reset it.
• DCA intervals are real wall-clock seconds, in live trading and in backtests alike. 3600 means hourly, everywhere.
• The 0.0001 ETH gas grant is a lifetime budget. A gas-dry agent still shows active but stops filling. The only evidence is in server logs.
• Profits stay in the agent's custodial wallet forever. There is no withdrawal on a testnet where tokens have no real value. Kill freezes the books; it doesn't liquidate.
• NFLX has no mainnet Chainlink feed. Its oracle mirrors the latest 5-minute Yahoo close, so it can lag the tape by a few minutes.
• If the oracle stalls past 120 seconds, trading halts with a stale-price error rather than filling on old marks. Portfolio valuation tolerates up to an hour.
• Backtest results are history, not forecasts, and Market-source replays fill at Yahoo closes while live agents fill at oracle prices.