> For the complete documentation index, see [llms.txt](https://hyperalpha.gitbook.io/hyperalpha-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyperalpha.gitbook.io/hyperalpha-docs/guide/hyperalpha-copy-matrix-guide.md).

# HyperAlpha Copy Matrix Guide

🚨 Prerequisite: Before configuring copy trading, please ensure your Hyperliquid account has been funded, and that you have successfully imported and activated your API Key within HyperAlpha.

{% embed url="<https://www.youtube.com/watch?v=FciXTtelDfU>" %}

Step 1: Enter the Copy Trading Hub & Select Assets

* Log in to the HyperAlpha App and select \[Copy Matrix] from the navigation bar.

<img src="/files/IgjWGIWR0tcdlY2RNBZG" alt="" height="460" width="213">

* At the top of the page, select the specific token you wish to copy trade (e.g., BTC, ETH, SOL, HYPE, etc.).

#### Step 2: Filter & Analyze Signal Sources (Addresses)

Scroll down to browse the available wallets. The system categorizes these signals into two main directories:

* \[Pro Long/Short]: Top-tier trader addresses, typically utilized for direct copy trading ("buy what they buy").
* \[Retail Long/Short]: General retail addresses, frequently utilized as counter-indicators for reverse copy trading ("do the opposite of what they do").

Multi-Dimensional Data Analysis:

* Click the \[ > ] icon to the left of any address to instantly expand and view their live open positions.
* Click the \[Address Text] itself to load their historical PnL performance charts.
* Swipe right on the list to evaluate granular track records, such as 30-day Cumulative Total Returns and 7-day ROI.
* Check the boxes next to the addresses that match your strategy (combining 1–3 addresses is recommended), and click \[Bulk Copy].

<div><img src="/files/g20dqzr0UaMQTS1sY9G3" alt="" height="422" width="195"> <img src="/files/8ESNJ267VD9rFIPsTEHs" alt="" height="421" width="194"> <img src="/files/ib5BpdagqWOwTiAtOesz" alt="" height="422" width="196"></div>

#### Step 3: Fine-Tune Your Copy-Trading Parameters

The AI engine will automatically generate a baseline copy-trading template. You can fully customize your strategy across the following key modules:

**1. Account Selection**

* Account: Select the specific wallet/API account from the dropdown menu that will execute these trades.

<img src="/files/MXQia0FCi4f8NdfkG5RN" alt="" height="434" width="201">

**2. Timing & Risk Management**

* Timeout Cancel: When toggled on, if a copy trade order fails to match and execute within your set timeframe, the system automatically cancels it.
* Inactive Timeout: If a monitored address shows zero trading activity (becomes a "zombie account") for a set period, the system will automatically untrack and remove it.

<img src="/files/Txop9PRXsmE20kUHuODu" alt="" height="416" width="192">

**3. Order Type & Direction**

* Copy Direction: The system defaults Pro addresses to direct/normal copying, and Retail addresses to reverse/contrarian copying.
* Execution Type: Select either \[Maker] or \[Taker]. The system defaults to Maker mode to minimize transaction fees.

<img src="/files/GmzXHptf1MNniBp9SFXe" alt="" height="288" width="134">

**4. Core: Select Your Copy Mode (Choose 1 of 4)**

* Instant Mirror: Instantly replicate the signal source’s entire portfolio and all future actions. The system will immediately open proportional positions even for their pre-existing older trades. (Best for users who completely trust the signal source and want 100% synchronization).
* Delta Only: Ignore pre-existing older positions. The system will strictly mirror new actions (adding, reducing, closing) executed from the exact second you turn on the copy mode. (Best for users who want to avoid chasing old entries but want future synchronization).
* Increase Only: Only copy the signal source’s "entry/add position" actions. When they scale down or close out, your system will not follow. (Best for users who want a pro to guide their entries but wish to manage their own exits).
* Reverse Reduce: A contrarian strategy. When the signal source sells to reduce their position, your system does the opposite and buys to add size. (High-risk counter-strategy; recommended for experienced traders only).

<div><img src="/files/LJUSblOxT1LW3BIg2ovI" alt="" height="506" width="233"> <img src="/files/x777dxYQMzmrbKh1sDqc" alt="" height="509" width="235"></div>

**5. Capital & Leverage Allocation**

* Order Amount: Choose \[Proportional] (calculated automatically by percentage) or \[Fixed Amount] (manual value). ⚠️ Reminder: The system's strict minimum execution size is 10 USDC per order.
* Leverage: Freely adjust your leverage. Maximum leverage variance depends on the selected asset, in complete synchronization with Hyperliquid's native parameters.

<img src="/files/NvMTD1gzPscotQ1CCU5b" alt="" height="399" width="184">

#### Step 4: Save & Monitor Real-Time

* Once all parameters are verified, click \[Save Settings] to officially deploy your intelligent copy-trading strategy.
* Live Monitoring: Track live open positions and real-time PnL anytime via the \[Live Monitor] dashboard. You can modify or delete your copy-trading parameters at any moment.

<img src="/files/OQOqEBqoNo9pgSp8PJj6" alt="" height="393" width="181">

<br>


---

# 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:

```
GET https://hyperalpha.gitbook.io/hyperalpha-docs/guide/hyperalpha-copy-matrix-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
