Mirror a leader. Keep every guardrail.

A command-line copier for Papertrade perps. It watches a leader's live wallet stream, opens and closes the same positions in your account with a trading-only session key, and stops at limits you set first. Dry run is the default.

npx papertrade-copytrade leaders

Leader explorer

Loading live leaderboard

Stats come from each wallet's most recent closed trades (up to 150) read from the public API. Trades inside the window only. Small samples mislead, so check the trade count.

Config builder

Read this before you copy anything.

Papertrade leverage goes to 1000x. A 0.1% adverse move can liquidate a 1000x position and lose its entire margin.
Copies open after the leader, at a different price, with slippage and fees. You will not match a leader's results.
Only fund the follower account with money you can lose. The guardrails below limit exposure, they do not remove risk.
The generated command is a dry run. It signs nothing for submission. Going live is a separate, deliberate step in your terminal.

Who Follower account

Your wallet address. Its key stays in your terminal as PAPERTRADE_WALLET_KEY and is never entered here.

Leaders to follow (one address per line, up to 10)

Sizing

Mode USD margin

Leverage Leverage value

Guardrails (all required)

Max margin per trade (USD) Max total open margin (USD)

Max leverage Max open positions

Daily realized loss stop (USD) Cooldown per market (seconds)

Slippage guard (% from leader entry) Skip leader opens older than (seconds)

Kill switch file

Create this file at any time to stop new copies.

Behavior Also copy positions the leader already holds when I start When the kill switch appears, close every mirrored position

Command (dry run)

copytrade.config.json

Then, when you have watched a dry run and accept the risk

Live mode asks you to type a confirmation phrase in an interactive terminal. Use npx papertrade-copytrade check --config copytrade.config.json to validate a saved file.

How it works

Stream. The leader's wallet feed is read live from Papertrade. Each open and close arrives as an event.
Plan. A pure planner turns the event into an action: size it, apply the leverage rule, enforce the protocol minimums ($10 margin, $10,000 notional) and every guardrail, or skip it with a logged reason.
Sign. A session key signs the EIP-712 intent. It can open and close positions and can never withdraw. Your wallet key is used once to register it.
Remember. Leader-to-follower position mapping is saved to a private file, so a restart picks up exactly where it stopped.