coinpilot-hyperliquid-copy-trade

# Coinpilot Hyperliquid Copy Trade

## Overview

Use Coinpilot to discover lead wallets, copy-trade Hyperliquid perpetuals, manage subscription lifecycles, and inspect basic performance using the user's configured wallet keys. The goal is to help users find strong traders to mirror while applying clear operational and risk guardrails.

This is a trusted-local-runtime skill. It is not intended for use without user-managed local secret storage because runtime trading calls require direct access to the secrets in the credentials JSON.

## Getting Coinpilot credentials

Before first use:

1. Create and fund a Coinpilot account.
   Download Coinpilot on [App Store or Google Play](https://refer.coinpilot.com/7ef646).
2. Obtain the experimental `apiKey` and Privy `userId` through Coinpilot support
   or by opening a ticket in the official [Coinpilot Discord](https://discord.com/invite/UTfdDcMTHH).
3. After the user has those values, have them populate the local
   `~/.coinpilot/coinpilot.json` file as described below.

## Credential requirements

- This skill expects a **local credentials JSON** that contains:
  - `apiKey`
  - `userId`
  - primary wallet private key
  - follower wallet private keys
- The credentials JSON is a local machine file reference, not a chat attachment or a value that should be pasted into prompts.
- The actual high-sensitivity secrets are inside the local credentials JSON named by that path.
- The runtime uses a fixed user-home config path for the credentials file.
- Never claim this skill is usable without private keys for state-changing copy-trading calls.

## Required inputs

- Resolve credentials from the fixed user-home path on all supported platforms:
  - `~/.coinpilot/coinpilot.json`
- Check whether the resolved credentials file exists and is complete before any usage.
- If missing or incomplete at the fixed path, create `coinpilot.json` there
  from the redacted `assets/coinpilot.template.json` template with placeholder values only.
- Then...

# Coinpilot Hyperliquid Copy Trade Skill

Use this skill to access and control Coinpilot, allowing you to discover, investigate, and copy-trade top on-chain traders on Hyperliquid in real time with low execution latency.

It supports non-custodial wallet infrastructure, near-instant execution, and real-time position management with advanced trading controls.

Runtime use requires a local credentials JSON containing a Coinpilot API key, a
Privy user ID, one primary wallet private key, and 9 follower wallet private
keys. The API key and private keys are high-sensitivity secrets; the `userId` is
a required identifier. The install/runtime metadata points to the local file
path; the secrets themselves remain inside that local file. The CLI reads a
fixed user-home config path.

## What this skill does

Connect your agent to Coinpilot to mirror top-performing Hyperliquid traders through a discovery and execution engine.

- **Elite Trader Discovery**: Access Coinpilot's proprietary curation using multi-factor analysis.
- **Wallet Management and Tracking**: Track and monitor specific wallet addresses directly, including wallets not currently on the leaderboard.
- **Sub-Second Mirroring**: Real-time trade detection with next-block execution through the Coinpilot engine.
- **Parallel Copying**: Manage up to 9 independent sub-portfolios simultaneously to prevent position offsetting.
- **Advanced Risk Management**: Set automated take profit (TP) and stop loss (SL) at both subscription and position levels.
- **Self-Custodial Execution**: Powered by Privy. Your keys, your crypto.

Full platform functions are documented at <https://docs.coinpilot.com/>.

## Setup Instructions

### 1) Prepare your Coinpilot account

1. Download Coinpilot on [App Store or Google Play](https://refer.coinpilot.com/7ef646).
2. Create an account and fund your trading account.
3. Obtain your Coinpilot **API Key** and **Privy User ID** by opening a ticket in the [Coinpilot Discord](https://discord.com/invi...