> For the complete documentation index, see [llms.txt](https://doc.lockerprotocol.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.lockerprotocol.com/hyper-agentic-trader/copy-trading.md).

# Copy trading and following traders

Mirror another trader's orders, in simulation or under a mandate that names them, and follow traders on hyperkeel.

A **copy** mirrors every order of a trader on Hyperliquid, in the background, for some days. In simulation it signs nothing, so it is a safe way to watch a trader. Live, it places real orders under your mandate.

```sh
lpa copy start --leader 0x5b5d51203a0f9079f8aeb098a6523a13f298c060 --budget 500 --days 3
lpa copy status
lpa copy stop --leader 0x5b5d51203a0f9079f8aeb098a6523a13f298c060
```

{% hint style="danger" %}
**Copying a trader does not make their result yours.** You pay your own fees and your own funding, your fills are not theirs, and a trader who did well for a year can lose it in a week. A live copy is leveraged trading with someone else's hand on the wheel.
{% endhint %}

## In simulation, which an agent may start

A copy in simulation gets a simulation account of its own, with the real fees, and nothing is signed. It runs inside the guardian, so it goes on with the terminal closed, until its end date, `lpa copy stop`, or `lpa uninstall`. With no guardian running, one starts without a key.

```
Copying 0x5b5d...c060 in simulation with $500.00 until 2026-10-03 09:30 UTC, in proportion to its equity, at most 1x the leader's size. The guardian copies with the terminal closed; `lpa copy status` shows how it goes, `lpa copy stop` ends it.
```

## How each order is sized

| `--sizing`               | An opening of the copy is                                                                                                                                       |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `proportional` (default) | the trader's size times your equity over theirs, never more than `--max-scale` times their size. A trader smaller than the copy is not amplified unless you ask |
| `mirror`                 | the trader's own size                                                                                                                                           |
| `percent`                | `--percent` of the copy's equity as margin, at the copy's leverage and the price now                                                                            |
| `fixed`                  | `--fixed-margin` USD of margin, at the copy's leverage and the price now                                                                                        |

Whatever the mode, the order is then held to the policy's largest order at the price now, and an order under Hyperliquid's $10 minimum is skipped and said. The leverage is the trader's own on that market, bounded by the policy and by the market.

What the trader **reduces** is reduced by the same share of the copy's position, whatever the sizing. The pieces of one order of theirs that crossed several levels of the book are copied as one order.

## When the feed drops

When the live feed drops, or when a guardian takes the copies up after a restart, the trader's executions since the last one taken are read back from Hyperliquid first:

* what they **reduced** meanwhile is mirrored however late,
* what they **opened** more than two minutes ago is not chased.

The journal says so, with a `copy-catchup` line. A skipped order is written as `copy-skip` with its reason.

## Live copies

`--live` copies on your real account. It takes three things, and says which one is missing:

1. **The guardian holding the key**: `lpa unlock`, typed by you. An agent cannot unlock, so an agent cannot start a live copy on a locked wallet.
2. **A mandate that names the trader**, with room in its copy budget for this copy's budget (all live copies together): `lpa mandate sign --copy-leaders 0x... --copy-budget 250`. The copy never outlives the mandate.
3. **Simulation mode off.**

```
Copying 0x5b5d...c060 LIVE on your account with $250.00 until 2026-10-03 09:30 UTC, in proportion to its equity, at most 1x the leader's size. Each order goes through the policy and the mandate signed on the phone; `lpa copy stop` ends the copy, and the positions it opened stay open.
```

Each live order goes the way one of yours does: the quote on the live book, the policy, the mandate (the day's notional, the fee, the trader named), the closed list of actions, then the agent key inside the guardian. It is written in the journal as `copy`, a reduction as `close`, and it counts in your orders and your notional of the day.

A copied order accepts 100 basis points past the mid, not the 300 of `perps open`: what does not fill at once within that is skipped, and said.

Things worth knowing before you start one:

* Stopping a live copy stops the mirroring. The positions it opened stay on your account, because they are yours: close them with `lpa perps close`.
* Until they are closed, the copy's budget stays counted in the mandate's copy budget. Starting it again does not take the budget twice.
* A live copy of your **own** account is refused: every order it placed would come back as an execution to copy.
* A live copy kept on disk is taken up by the next guardian only under a mandate in force that names it, within its budget and its end. Otherwise it is ended, and the journal says so.
* What the guardian could not place is never lost: a reduction made while the key was locked, or one the venue refused, is kept and tried again at each execution of the trader's and every minute. `lpa copy status` says how many are still to place.

## Reading how a copy goes

```sh
lpa copy status
lpa copy status --all      # the copies that ended too
```

```
LEADER         STATE    SINCE             UNTIL             BUDGET   SIZING     EQUITY   GAIN    COPIED  SKIPPED  POSITIONS
0x5b5d...c060  running  2026-09-30 09:30  2026-10-03 09:30  $500.00  prop. ≤1x  $512.40  +2.48%  14      2        3
```

The gain is read from what actually executed. It leaves out the funding, which your account pays.

After a restart of the computer, running copies are paused, because no guardian follows them. `lpa copy resume` starts a guardian and takes them up.

## Finding traders: hyperkeel

**hyperkeel.com** is the market data service of Locker Protocol for Hyperliquid. It is optional: nothing else in `lpa` needs it. hyperkeel never receives your wallet address.

```sh
lpa hyperkeel login              # with a Google account; 90 days
lpa hyperkeel brief              # movers, funding, liquidations, large trades
lpa hyperkeel leaders --window week
lpa hyperkeel follow --address 0x5b5d51203a0f9079f8aeb098a6523a13f298c060
lpa hyperkeel follows
lpa hyperkeel alerts --threshold 1m
lpa hyperkeel logout
```

Connected, `lpa` and its assistant read hyperkeel's brief and its leaderboards, the live views show more, and you can follow traders and get alerts on their moves, as notifications and email, from 250k, 1m or 5m dollars, or off.

Over SSH or without a display, `lpa hyperkeel login --code` prints a link and a code to type on any device, your phone included. That code is only ever shown by your own terminal: nobody should send it to you or ask you for it.

{% hint style="info" %}
**Following is not copying.** Following a trader on hyperkeel sends you their moves. Copying a trader places orders. You can do one without the other.
{% endhint %}

A third way to use the leaderboard, which copies nothing: a strategy of the daily pilot may ask for it (`followLeaders`). The code then opens a long only where the top accounts are net long on that market, a short only where they are net short, and opens nothing at all when their positions cannot be read. The verdict is named `leaders`, it needs the hyperkeel connection, and a measure cannot replay it and says so. See [The strategies](https://doc.lockerprotocol.com/hyper-agentic-trader/strategies.md).

## From the session

`lpa` alone opens the interactive session, where the two go together:

* `/leaders week` lists a leaderboard. Enter opens a trader, `c` prepares a copy in simulation, `f` follows or unfollows.
* `/trader 0x...` shows any account live: positions, PnL, executions, with the same `c` and `f`.
* `/radar` is hyperkeel's brief, refreshed every 30 seconds.
* `/copy 0x... 1000 [days] [--sizing fixed --fixed-margin 25] [--live]` starts a copy.

## Learn more

* [lpa copy](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/copy.md) and [lpa hyperkeel](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/hyperkeel.md)
* [The mandate](https://doc.lockerprotocol.com/hyper-agentic-trader/mandate.md)
* [Safety rules for the agent wallet](https://doc.lockerprotocol.com/hyper-agentic-trader/safety-rules.md)
