hyperliquid

# Hyperliquid CLI Skill

Trade crypto perpetuals and HIP3 traditional assets (stocks, commodities) on Hyperliquid DEX from the command line.

## What This Skill Does

This skill enables you to:

- **Trade Crypto Perpetuals** - BTC, ETH, SOL, and 100+ other assets with up to 50x leverage
- **Trade Traditional Assets via HIP3** - Stocks (AAPL, NVDA, TSLA, GOOGL) and commodities (GOLD, SILVER) with crypto-style 24/7 trading
- **Monitor Positions in Real-Time** - WebSocket-powered live updates with color-coded PnL
- **Manage Multiple Accounts** - Store and switch between trading accounts
- **Use High-Performance Server Mode** - Sub-5ms latency with persistent connections

## Setup Instructions

### 1. Check if CLI is Installed

```bash
which hl
```

If not found, install it:

```bash
npm install -g hyperliquid-cli
```

### 2. Verify Installation

```bash
hl --version
hl --help
```

### 3. Set Up API Key for Trading

To execute trades, you need a Hyperliquid API wallet:

1. Go to https://app.hyperliquid.xyz/API
2. Create a new API wallet (or use an existing one)
3. Export the private key (starts with `0x`)
4. Add an account to the local storage (Recommended):

```bash
hl account add
# Follow the interactive prompts
```

or set the environment variable:

```bash
export HYPERLIQUID_PRIVATE_KEY=0x...your_private_key...
```

## Starting the Server (Recommended)

For best performance, start the background server before trading:

```bash
hl server start
hl server status  # Verify it's running
```

The server provides:

- Persistent WebSocket connections to Hyperliquid
- In-memory caching of market data
- ~20-50x faster response times
- Sub-5ms latency for queries

Stop when done:

```bash
hl server stop
```

## Key Innovations

### HIP3 Traditional Assets

Hyperliquid's HIP3 enables trading traditional assets with crypto primitives:

- **Stocks**: AAPL, NVDA, TSLA, GOOGL, AMZN, META, MSFT
- **Commodities**: GOLD, SILVER
- **24/7 Trading**: Unlike traditional markets, trade any...