> 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/agent.md).

# What Hyper Agentic Trader is

Hyper Agentic Trader is a desktop application, its command line lpa, and an MCP server, all three letting an AI agent trade Hyperliquid perps under limits you sign, while your account's key stays in y

**Hyper Agentic Trader** is the third product of the Locker Protocol family: an AI agent that trades perpetual futures on Hyperliquid for you, under limits you sign, while the key that owns the money stays in your own wallet. The safest wallet for it is your offline Locker Vault, and it is the one we recommend; your browser extension or your mobile wallet can sign too.

It comes in three faces, which share one engine, one folder on your computer and the same refusals:

| Face                             | What it is                                                                                                                                                                                                                                                                      | Who it is for                                   |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| **The application**              | A desktop window for macOS, Windows and Linux, from [hyperagentictrader.com](https://hyperagentictrader.com). It installs everything, signs you in, and gives you the workshop, the assistant, the pilot, your positions and your portfolio, with a model included in your plan | everyone, and the place to start                |
| **The command line, `lpa`**      | The same engine in a terminal: every command the application runs, with its flags, its JSON and its exit codes. The application installs it; a server or a script uses it alone                                                                                                 | people who live in a terminal, servers, scripts |
| **The MCP server, `locker-mcp`** | The same commands as tools for an AI agent in another program: Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI and any MCP client                                                                                                                                        | an agent you already use elsewhere              |

The Vault is the safe. The browser extension is the window. Hyper Agentic Trader is the trader who works for you, and who is never given the key to the safe.

{% hint style="danger" %}
**Perpetual futures are leveraged. You can lose everything you put in.** Nothing here is financial advice, and no part of this product promises that a trade, a method or a model makes money. Use an account that holds only what you are ready to lose.
{% endhint %}

## The problem

An AI agent that trades needs to sign orders. The easy way is to hand it a private key.

That is a disaster waiting to happen. A private key on a trading machine can be read by any program on it, sent anywhere, and used to empty the account. It never expires. Nobody holds the agent to a rule, because the key answers every request the same way.

## The answer

Four pieces, each doing one job.

1. **An agent key, not your key.** The program makes a second key on your computer. Hyperliquid lets that key trade for your account, and refuses it every withdrawal and every transfer to another account. It is sealed on disk under a password you choose, and it expires on its own: 180 days at most, which is the longest Hyperliquid allows.
2. **A mandate you sign in your wallet.** The limits the agent trades within are shown one row per limit (on the Vault, as a card of its own), and you sign them there. The agent never widens them, because widening would need your wallet again.
3. **The guardian.** A small background process holds the agent key in memory, checks every order against your limits a second time, and signs a closed list of trading actions only. It never gives the key, or your password, to whatever asked.
4. **The code applies the limits.** The size of a position, the distance between its steps, the exit price: the code computes them from your settings. The model decides the side, the market and the entry. It never decides how much.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-edd973006d760d7c280723ee93faf67875f98b32%2Fsafe-and-window.svg?alt=media" alt="The Vault (safe, offline) and the online side exchange QR codes"><figcaption><p>With Locker Vault, the same rule as the extension: only QR codes cross, never a key.</p></figcaption></figure>

## The application

The application is the product. Download it from [hyperagentictrader.com](https://hyperagentictrader.com), open it, sign in with Google, and choose between two ways in:

* **The quick install** puts the engine on this computer, opens a simulation account and, once you are signed in, sets the model included with your plan. Nothing to paste, no wallet, no money: you are in the workshop within a minute, trading in simulation on Hyperliquid's real order book.
* **The advanced install** walks the whole way, step by step, to a real account: this computer, your model, your account and how it signs, some funds, your password and the trading key, your limits, the mandate you sign, the service that runs day and night, and the daily pilot in simulation first. It can also install the engine on a machine you reach over SSH.

Both are described on [The application](https://doc.lockerprotocol.com/hyper-agentic-trader/application.md). What a plan includes, what credits are and how a plan is paid for are on [Plans and credits](https://doc.lockerprotocol.com/hyper-agentic-trader/plans-and-credits.md).

## The model included with your plan

The pilot, and the questions you ask in plain words, think with a model. Since version 2.6.0 you no longer have to bring one: every plan of Hyper Agentic Trader, the free one included, comes with a model, and your sign-in is its key. Nothing to paste. Each answer says what it cost in credits, and `lpa hyperkeel status` says how many are left and until when.

You can still bring your own: a provider you pay yourself (Anthropic, OpenAI, Google, OpenRouter), or a model on your own computer (LM Studio, Ollama), which keeps everything on the machine. See [Models and costs](https://doc.lockerprotocol.com/hyper-agentic-trader/models-and-costs.md).

## Who signs what

| What                                          | Signed by                                                                  | Where                                                                                                                               |
| --------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Markets, quotes, positions, balances          | nobody                                                                     | public reads of Hyperliquid and Arbitrum                                                                                            |
| Simulated orders                              | nobody                                                                     | simulated on your computer, on the live order book                                                                                  |
| Open, close, cancel, change leverage          | the agent key, inside the guardian                                         | after the quote, the limits and your go                                                                                             |
| Approving the agent key, revoking it          | **your wallet**: Locker Vault, or the extension or mobile wallet you chose | QR loop on the phone, or a request you approve in your wallet                                                                       |
| Deposit, withdraw, move margin between venues | **your wallet**                                                            | the same                                                                                                                            |
| The mandate (the agent's limits)              | **your wallet**                                                            | the same                                                                                                                            |
| A copy's orders, a pilot's orders             | the agent key, inside the guardian                                         | under the policy and the mandate                                                                                                    |
| Paying for a plan                             | **a wallet of yours on Arbitrum One**, on the site                         | the site's payment page, in USDC; see [Plans and credits](https://doc.lockerprotocol.com/hyper-agentic-trader/plans-and-credits.md) |

## Three ways to sign for your account

Everything that is not a trade (the trading key, the mandate, a deposit, a withdrawal, a revoke) is signed by the account itself, in a wallet you choose once. The application asks at its account step, Locker Vault first; in the terminal, `lpa setup` asks the same, `lpa init --with vault|browser|mobile` says it on one line, and `lpa signer show` says it afterwards.

| Way                                                          | What you need                                                                                   | What leaves this computer                                                                                                              |
| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Locker Vault**, the safest, recommended                    | Locker Vault on a phone or tablet kept offline, and a webcam                                    | nothing: requests and answers travel as QR codes                                                                                       |
| **Your browser extension** (MetaMask, Rabby)                 | the extension, in the browser that opens the local page of the engine (`http://127.0.0.1:7718`) | nothing more: the extension signs on that page                                                                                         |
| **Your mobile wallet** (MetaMask, Rabby, Coinbase Wallet...) | the wallet on your phone: you scan a WalletConnect QR once, then approve each request there     | the requests, end-to-end encrypted, through WalletConnect's relay, which sees this computer's IP address and the time, not the content |

**Why the Vault is the safest.** The account's key never touches a device that is online. The Vault reads each request itself and shows it in words: a deposit, the trading key, the fee, the mandate, a withdrawal. It warns you of a destination that is not your account, and of a deposit Hyperliquid would lose.

**With an extension or a mobile wallet**, the account is proven first, before any money, by one signature that moves nothing: it is checked on this computer and sent nowhere. An address that is a contract (a smart wallet) is refused. Those two are online wallets, and they show a typed signature as raw fields, so the local page shows you first, field by field, what your wallet will show, each value explained in one line. A hardware wallet behind them may show only a fingerprint of a typed signature.

Whatever signs, every signature is checked to come from your account before anything is sent, and the guardian bounds the agent the same way. The trading key and the mandate belong to the address, not to the way it signs: `lpa signer use` changes the way and keeps them. An account that already trades on Hyperliquid from MetaMask can be linked as it is.

Most pages of this guide follow Locker Vault. With an extension or a mobile wallet, the same step is a request you approve in your wallet. The commands are in [Setup and the guardian](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/setup-and-guardian.md#how-the-account-signs).

## What it can do

* Read markets, order books, funding, your positions, your balances and your whole portfolio as Hyperliquid values it.
* Place, change and cancel orders on Hyperliquid perps, within your limits. `lpa perps check` says whether an order would pass, without signing or writing anything.
* Trade a **simulation account** that fills on the real order book with the real fees, with no key, no Vault and no money.
* Answer you in plain words, with a read of a coin or a scan of the market, and propose an order you confirm.
* Copy a trader's orders, in simulation or, under a mandate that names that trader, for real.
* Run a **pilot** that decides on its own, in simulation by default, playing a **strategy** your charter names: eighteen are shipped, in four kinds (by steps, with a stop, a grid, a range), you can write your own, let the pilot choose one each day, or have the model draft one from a sentence.
* Measure a strategy over the venue's own past, without a model, before any of it touches money.
* Answer an AI agent in another program, through its MCP server, with the same limits and the same refusals.

## What it cannot do

* Withdraw your funds. Hyperliquid refuses the agent key every withdrawal and every transfer to another account, and the guardian signs nothing but trading actions.
* Move money at all without your wallet. Deposits, withdrawals and transfers between venues are signed by your account, in the wallet you chose.
* Widen its own limits. The guardian reads the mandate again before every opening, and a wider local limit waits for your password.
* Trade when the guardian is locked. `lpa lock` takes the key out of memory, and then nothing can be signed.

{% hint style="warning" %}
**The honest limit.** A program that steals the sealed key file *and* your password can talk to Hyperliquid without the engine, and no file on your computer stops it. What still holds then: it cannot withdraw, the key expires, and a dedicated account holds only what you are ready to risk. Use an account for this and nothing else.
{% endhint %}

## What it costs

| Cost                         | How much                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Hyperliquid's trading fees   | the venue's own rate for your account's tier                                                                                                                                                                                                                                                                                                |
| The Locker service fee       | 0.05 % of each order's notional, named in every quote and totalled in the journal. It applies only once your wallet approved it; without that approval orders simply go out without it                                                                                                                                                      |
| Withdrawing from Hyperliquid | a flat 1 USDC, charged by Hyperliquid                                                                                                                                                                                                                                                                                                       |
| The model                    | the credits of your plan, when you use the included model: a day of the daily pilot costs about 0.3 credit, and the free plan gives 50 credits a month. With a provider of your own, what that provider charges; a model on your own machine costs nothing but electricity; a strategy the code decides on its own asks for no model at all |
| A plan                       | the free plan costs nothing. The paid plans, their credits and their prices are on [hyperagentictrader.com](https://hyperagentictrader.com), and [Plans and credits](https://doc.lockerprotocol.com/hyper-agentic-trader/plans-and-credits.md) says how one is paid for                                                                     |
| The program itself           | nothing                                                                                                                                                                                                                                                                                                                                     |

Fees are always shown as one total, before anything is signed.

## Where to start

{% content-ref url="/pages/WNWPWc7GvPCBPwvWm8be" %}
[The application](https://doc.lockerprotocol.com/hyper-agentic-trader/application.md)
{% endcontent-ref %}

{% content-ref url="/pages/HXBI3R531B7YnkiBITr9" %}
[Install lpa](https://doc.lockerprotocol.com/hyper-agentic-trader/install.md)
{% endcontent-ref %}

{% content-ref url="/pages/nRfL9FELnOtsSvqYFtmu" %}
[Set up in a few steps](https://doc.lockerprotocol.com/hyper-agentic-trader/set-up-in-steps.md)
{% endcontent-ref %}

{% content-ref url="/pages/eYPGBWyBR2RmHsNLud1E" %}
[Safety rules for the agent wallet](https://doc.lockerprotocol.com/hyper-agentic-trader/safety-rules.md)
{% endcontent-ref %}

## Learn more

* [Plans and credits](https://doc.lockerprotocol.com/hyper-agentic-trader/plans-and-credits.md), what a plan includes and how it is paid for.
* [How it trades](https://doc.lockerprotocol.com/hyper-agentic-trader/how-it-trades.md), the four methods in plain words.
* [The strategies](https://doc.lockerprotocol.com/hyper-agentic-trader/strategies.md), the eighteen shipped and how to write your own.
* [The mandate](https://doc.lockerprotocol.com/hyper-agentic-trader/mandate.md), the limits your wallet signs.
* [The guardian and the keys](https://doc.lockerprotocol.com/hyper-agentic-trader/guardian-and-keys.md).
* [MCP server and plugins](https://doc.lockerprotocol.com/hyper-agentic-trader/mcp-and-plugins.md), the third face.
* [Command reference](https://doc.lockerprotocol.com/hyper-agentic-trader/commands.md), every command and every flag.
