> For the complete documentation index, see [llms.txt](https://botlyz.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://botlyz.gitbook.io/docs/english/installation-pas-a-pas/installation-hyperliquid.md).

# A-to-Z setup: Hyperliquid

This page walks you **from the very beginning to your first automated strategy on Hyperliquid**. Each step tells you **where to go** and **what to click**, then points to a detailed page if you want to dig deeper. No technical knowledge required.

> Would you rather trade on Lighter? Follow [A-to-Z setup: Lighter](/docs/english/installation-pas-a-pas/installation-lighter.md) instead. The two journeys are equivalent: only the exchange changes.

## A few words before you start

Two services are involved, and it helps to tell them apart clearly:

* **Hyperliquid**: the trading platform. It is one of the largest decentralized marketplaces for **perpetuals** (contracts that track the price of an asset, with no expiry date), known for its liquidity and speed. This is where your money lives and where orders are placed.
* **Botlyz**: the software that automatically runs a **strategy** (a set of buy and sell rules) on your Hyperliquid account, following exactly the configuration you have approved.

> 👉 In short: your money stays with **you** and on **Hyperliquid**. Botlyz places and cancels orders according to your rules, but **can never withdraw your funds**.

The full journey has **eight steps**. Expect around 15 to 20 minutes the first time.

## Step 1: Connect your wallet to Botlyz

A **wallet** is a small app (often a browser extension) that holds your identity on the blockchain. If you don't have one, we recommend **Rabby**.

1. Open **botlyz.com** and click **"Connect wallet"** (or "Sign in").
2. Select your wallet and **sign** the message that appears.
3. This signature is **free**, **off-chain** (no transaction, no fees), and simply proves that this wallet is yours.

> **Important**: signing this message gives Botlyz **no access** to your money. It is just a way to identify you, with no email or password.

✅ For the details (choosing a wallet, signature security), see [Connect your wallet](/docs/english/installation-pas-a-pas/connecter-votre-wallet.md).

## Step 2: Create your Hyperliquid account

You now need an account on the Hyperliquid trading platform.

1. Open [app.hyperliquid.xyz](https://app.hyperliquid.xyz).
2. **Connect your wallet** (preferably the same one used for Botlyz) and sign to confirm.

Your Hyperliquid account is simply your wallet: there is no separate account to create, it activates at the first deposit.

## Step 3: Deposit funds

Your trading capital is in **USDC** (a stablecoin pegged to the dollar), and must be available for **perpetuals**.

1. On Hyperliquid, click **"Deposit"** and choose your method: USDC deposit from **Arbitrum** (the most common network), or from an exchange.
2. Check that the amount shows up in your **Perps** balance:
   * If your account is in **standard** mode and the USDC arrived in **Spot**, use the **"Transfer"** button to move it to **Perps**.
   * If your account is in **"unified"** mode, your USDC automatically counts as trading margin; nothing to do.

> **Important**: as long as your Perps (or unified) balance is zero, strategies will not be able to trade.

## Step 4: Create your API key (agent) and connect it to Botlyz

On Hyperliquid, the API key is called an **API wallet** (or agent): a secondary wallet authorized to trade **for** your account, without ever being able to withdraw.

1. Open [app.hyperliquid.xyz/API](https://app.hyperliquid.xyz/API) (menu **More → API**).
2. Give your agent a name (for example "botlyz") then click **"Generate"**.
3. The agent's **private key** is displayed on screen **only once**: copy it immediately and keep it safe. (If you close the page without copying it, simply generate a new agent.)
4. Click **"Authorize API Wallet"** and sign with your wallet.
5. In Botlyz, go to **Accounts**, click **"+ Connect an account"** (**Hyperliquid** tab), and fill in:
   * Your **wallet address** (the master account, pre-filled with your connected wallet).
   * The **API private key (agent)** you just copied.
6. Botlyz verifies live that the agent is authorized for your wallet, then **encrypts** the key (it is never stored in plain text).

> **Important**: a Hyperliquid API wallet **can only trade**, by design. **No withdrawal, no transfer to an external address is possible.** Botlyz never has access to your owner wallet.

✅ For the details (account modes, agent expiry, FAQ), see [Connect a Hyperliquid account](/docs/english/installation-pas-a-pas/connecter-un-compte-hyperliquid.md).

## Step 5: Approve the integration fee

Before deploying your first strategy on this account, Botlyz asks you to **approve the integration fee**: **0.10%** (that is 10 basis points) automatically charged on each order (the cap set by the Hyperliquid protocol, the "builder codes").

1. Botlyz generates a **message to sign** (off-chain, free) for your master wallet.
2. You **sign** it with your wallet.
3. Hyperliquid records your approval. This is done **only once per account**, and it is **revocable at any time** on the Hyperliquid side.

> **Important**: approving this fee **moves no funds**. It is a protocol fee, collected and paid out by the platform as orders are placed; it is **not** an invoice and **not** a commission on your gains.

✅ For the details of the fee model, see [Fees](/docs/english/frais.md).

## Step 6: Choose or build a strategy, configure it, backtest it

You are ready to create your first strategy. Two paths are possible:

* **Choose from the catalog**: start from a ready-to-use strategy. See [Strategies overview](/docs/english/vue-d-ensemble.md).
* **Build in the Builder**: assemble your own rules, without writing code, using indicators. See [The Builder](/docs/english/le-builder.md).

Then **configure** your strategy:

1. Select **Hyperliquid** as the exchange, then choose the **pair** to trade (for example BTC).
2. Set the allocated **capital**, the **leverage** (the multiplier effect, to handle with care) and the **allocation** (the share of your capital committed). See [Risk parameters](/docs/english/parametres-de-risque.md).
3. Run a **backtest**: Botlyz replays your rules on **Hyperliquid's** past data to show you how the strategy would have behaved. See [Backtest](/docs/english/backtest.md).

> **Important**: a backtest describes the **past**, never the future. It helps you understand a strategy's behavior; it promises no result. A **minimum tradable capital** is required depending on the pair and your settings (Hyperliquid enforces a minimum of about $10 per order); Botlyz displays it before deployment (see the [Deploy a strategy](/docs/english/installation-pas-a-pas/deployer-une-strategie.md) page).

## Step 7: Sign and deploy

When your configuration suits you, you **approve** it securely.

1. Botlyz shows you a summary of your configuration (the chosen exchange is part of it).
2. You **sign** it (**EIP-712** signature: a readable and detailed signature, **off-chain** and free, that locks in exactly your parameters).
3. You **tick** the risk acknowledgment boxes.
4. You click **"Deploy"**. The strategy becomes active and starts placing orders according to your rules.

> **Important**: signing moves no funds. It is your formal, verifiable approval of the exact configuration the software will run.

✅ For the details of deployment (checks, SIGMA and Builder paths), see [Deploy a strategy](/docs/english/installation-pas-a-pas/deployer-une-strategie.md). To understand the signature, see [Signature and transparency](/docs/english/signature-et-transparence.md).

## Step 8: Monitor on the dashboard

Once deployed, your strategy is managed from the Botlyz **dashboard**.

* **Monitor**: open positions, balance and trade history are shown live.
* **Pause / resume**: you stay in control at any time.
* **Edit**: change parameters if needed (a new signature will be requested).

> 👉 From time to time, the Botlyz **engine** is updated (improvements, fixes). When that happens, all you need to do is **re-sign** your strategy with the **same parameters**: nothing changes in your configuration, it is a simple security confirmation.

## Recap checklist

✅ Wallet connected to Botlyz (connection signature done). ✅ Hyperliquid account active (wallet connected on app.hyperliquid.xyz). ✅ USDC deposited and available in Perps (or account in unified mode). ✅ API wallet (agent) generated, authorized and connected to Botlyz. ✅ Integration fee (0.10%) approved once for this account. ✅ Strategy chosen or built, configured and backtested on Hyperliquid. ✅ Configuration signed (EIP-712) and strategy deployed. ✅ Monitoring in place on the dashboard (pause / resume / edit mastered).

## Frequently asked questions

**Q. Do I have to do all these steps in order?**

Yes, order matters. In particular, the **deposit** (step 3) is needed for strategies to be able to trade, and the fee approval (step 5) is requested before your first deployment.

**Q. Can Botlyz withdraw my money?**

No, never. The API wallet (agent) you give Botlyz **can only trade**: no withdrawal or transfer to an external address is possible; that is a rule of the Hyperliquid protocol itself.

**Q. My balance shows $0 even though I deposited, why?**

Your USDC is probably in **Spot** while your account is in standard mode: use the **"Transfer"** button on Hyperliquid to move it to **Perps**. (In "unified" mode, this happens automatically.)

**Q. Does the agent key expire?**

Yes, Hyperliquid limits an agent's validity in time (around 6 to 12 months). When it expires, generate a new agent and update the key in Botlyz.

**Q. What happens when the Botlyz engine is updated?**

Your strategy asks you to **re-sign** with the same parameters. It is a security confirmation: your configuration stays identical, no funds are moved.

**Q. Can I stop a strategy at any time?**

Yes. From the dashboard, you can pause it, resume it, edit it or delete it whenever you want. You stay in control at all times.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://botlyz.gitbook.io/docs/english/installation-pas-a-pas/installation-hyperliquid.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.