COPY Docs — Robinhood Chain Copytrade Terminal

01 / QUICKSTART

Sixty seconds

COPY is a Node 20+ CLI. Clone it, install it, probe the configured sources, then open the full-screen terminal.

git clone <repo>
cd copy
npm install
cp .env.example .env
npm run doctor
npm start

Fast paths

Command	Result
npm start	full-screen interactive COPY terminal
npm run hunt	raw scrolling decision/event feed
npm run paper	local paper-copy loop with marks and exits
npm run web	website + interactive browser terminal + native queue UI

02 / COMMANDS

CLI surface

Command	What it does
copy terminal	interactive terminal with feed, inspector, COPY wallets and positions
copy hunt --fire-only	endless scrolling feed filtered to passing decisions
copy paper --for 300	open, mark and close local paper positions for five minutes
copy trader <handle>	inspect one profit hunter
copy scan <symbol\|address>	inspect one known Robinhood market
copy positions	current and recently closed paper positions
copy rules	current flow walls and exposure box
copy doctor --probe	provider, chain and bootstrap health
copy web	serve the product website and native queue backend

03 / TERMINAL

One screen, three jobs

The terminal keeps the newest events visible, explains the selected decision, and keeps the wallet/position desk moving underneath. Tokens are added to a growing in-memory market universe instead of replacing the session with a short batch.

↑ / ↓    inspect events
f        ALL → FIRE → SKIP
space    open selected FIRE as PAPER
c        track / untrack source
p        pause / resume scanner
r        refresh providers
q        quit

Web terminal commands

The website terminal uses the same direct command idea: type a command and press Enter. start begins the scanner immediately; the feed, decision pane and COPY wallet desk continue updating after that.

start            start scanner + moving feed
hunt             follow candidate decisions
paper            run the local paper desk
wallets          follow COPY wallets
scan $CASHCAT    inspect one known token
positions        print open paper positions
rules            print the current walls
stop             pause the engine
help             show commands

Events

NEW adds a market. BUY / SELL represent observed wallet flow when the provider returns it. MOVE is a market re-mark. SCAN is a local COPY decision pulse. COPY / PNL / EXIT belong to the position lifecycle.

04 / STRATEGY

The five flow walls

COPY score is context. The flow box decides whether the setup gets through.

Wall	Default	Question
EDGE	COPY DNA ≥ 58	is the source strong enough?
DEPTH	liq / MC ≥ 1.00%	is there enough depth relative to market size?
TURN	24h vol / liq ≥ 0.45×	is capital actually turning over?
MOMO	−15% … +38%	is the move inside the configured copy band?
PRICE	required	can the engine mark an entry?

profit source
    ↓
market discovery / wallet flow
    ↓
EDGE → DEPTH → TURN → MOMO → PRICE
    ↓
FIRE / SKIP + exact reason
    ↓
SHADOW / PAPER / NATIVE QUEUE

05 / COPY WALLETS

Profit source desk

The lower terminal desk rotates through a larger trader pool, changes pairs as the session grows, and keeps current PnL, mark delta and a session sparkline visible. Verified historical hunter/token pairs can seed the desk; live wallet events enrich it when configured.

SHADOW @ether_monk      → $CASHCAT   +4.18%  Δ+0.22  ▁▂▃▄▆█
SHADOW @threem          → $AI        -0.41%  Δ-0.13  ▆▅▄▃▂▁
PAPER  @DumbCrayonEater → $CASHCAT   +0.73%  Δ+0.09  ▁▁▂▄▅█

06 / PAPER

Position box

Limit	Default
size per copy	0.012 ETH
maximum open	5
session budget	0.080 ETH
take profit	+65%
stop loss	−22%
trailing	18% from peak
max hold	32 min

The paper engine uses the same candidate rules, receives market marks, and records exits without involving a browser wallet.

07 / ARCHITECTURE

One runtime, growing state

Fomo hunters ─┐
              ├─ normalize ─ market universe ─ candidate ─ flow walls
RH / DEX ─────┘                                      │
                                                     ├─ SKIP + reason
                                                     └─ FIRE
                                                         ├─ SHADOW
                                                         ├─ PAPER → marks → exit
                                                         └─ native queue

data/seed.json gives the runtime a fast bootstrap. Live provider results merge into the current universe instead of replacing it with a smaller response. Local runtime state stores tracked sources, rules and paper positions.

08 / NATIVE QUEUE

Execution without browser wallet UX

The web backend exposes a queue boundary. Passing manual/copy signals can be armed server-side. Configure your own relayer with NATIVE_EXECUTOR_WEBHOOK and keep signing infrastructure outside the browser.

NATIVE_EXECUTOR_WEBHOOK=
NATIVE_EXECUTOR_TOKEN=
NATIVE_EXECUTOR_POLL_MS=1500

The queue journal distinguishes queued/armed work from executor responses and can carry the returned transaction hash when your executor reports it.

09 / PROVIDERS

Inputs

Source	Role
Fomo	profit leaderboard and optional wallet activity
DEX market data	price, market cap, liquidity, volume and momentum
Robinhood Chain	chain health and on-chain market context
GMGN	Robinhood token deep links and configured $COPY buy route

10 / FAQ

Short answers

Does COPY already run?

Yes. The repository ships the CLI terminal, hunt feed, paper engine, doctor, rules, positions, website, browser terminal and native queue boundary.

Do I need to connect MetaMask to use the website?

No. The website and terminal are readable without browser wallet connection. Project-token purchase routes externally through the configured market URL.

Where do I set the project token?

Set COPY_TOKEN_ADDRESS and optionally COPY_BUY_URL. The website updates its CA, GMGN/Fomo links and BUY button from the server config.

READ THE ENGINE.