The copy-trading API for wallets and trading apps.

The whole integration is five calls

No venue-specific branches. The server describes what needs signing and the SDK signs it, so spot, perps and predictions all activate the same way.

1. 01
   listVenues()

   the venues you are entitled to, and what each needs signed

2. 02
   listLeaders({ venue })

   graded, copyable-by-default leaders for a venue

3. 03
   createAgent({ venue, leader, riskConfig })

   a per-user copy agent with its risk caps

4. 04
   activate(agentId, signer)

   one handshake; the server says what to sign, the wallet signs it

5. 05
   listExecutions(agentId)

   every mirrored fill, and every skip with a machine-readable reason

Install with npm install copytrading. The full path, CI-checked, is in the quickstart.

Venues and fees

Fee rates are the configured venue values. Polymarket is in sandbox pending live-CLOB acceptance; its copy fee is planned, not set. See the Hyperliquid page for the perps detail.

Non-custodial by construction

The backend executes inside a grant the user signs and can revoke. It is not a claim in a policy document; it is what the chain and the venue enforce.

Graded leaders, not a raw leaderboard

listLeaders returns traders screened for whether a follower can actually mirror them. The grading engine tells a real trader from a market maker before your users copy the wrong one: on one live Polymarket screen, only 2 of the top 12 traders by monthly profit survived the copyability gates. Every verdict ships with plain-language reasons and its evidence.

You earn on every copied fill

A builder fee rides inside the execution path and you keep 70% of the venue fees your flow generates. No pricing to design, no billing to build. A copy agent trades around the clock, so the same user routes a multiple of the volume a hand-run account would. See build vs buy for the economics against building it yourself, and the revenue calculator for your own numbers.

Common questions

What is a copy-trading API?

A copy-trading API lets your product offer copy trading without building the venue integrations, custody model, leader grading and execution monitoring yourself. Unhosted exposes it as five REST calls and a typed TypeScript SDK: list venues, list graded leaders, create a per-user agent with risk caps, activate it with one wallet signature, and stream the mirrored fills.

Is the copy-trading API non-custodial?

Yes. Funds stay in the user’s own wallet. On EVM spot the agent trades through a Rhinestone smart session scoped on-chain to the swap router with a spend cap and expiry, with no transfer action. On Hyperliquid the agent wallet can place and cancel orders but the venue never lets it withdraw or transfer. The user revokes either in their own wallet at any time.

How do I make money from the copy-trading API?

Every copied fill carries a builder fee inside the execution path, and you keep 70% of the venue fees your flow generates. There is no pricing model to design and no billing to build — the fee is charged by the venue and shared with you from the first fill.

Which venues does it support?

EVM spot swaps and Hyperliquid perpetuals are live. Polymarket predictions are implemented behind the same activation handshake and are validating in sandbox. One activation flow covers every venue.

How long does integration take?

The integration is five API calls with no venue-specific branches, and a self-serve sandbox key issues in minutes with paper-mode execution. Most teams are running against sandbox the same day.