hyperliquid

# Hyperliquid Trading Skill

Full trading and portfolio management for Hyperliquid perpetual futures exchange.

## Prerequisites

Install dependencies once:

```bash
cd skills/hyperliquid/scripts && npm install
```

## Authentication

**For read-only operations (balance, positions, prices):**
- Set `HYPERLIQUID_ADDRESS` environment variable
- No private key needed

**For trading operations:**
- Set `HYPERLIQUID_PRIVATE_KEY` environment variable
- Address derived automatically from private key

**Testnet:**
- Set `HYPERLIQUID_TESTNET=1` to use testnet

## Core Operations

### Portfolio Monitoring

**Check balance:**
```bash
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs balance
```

**View positions with P&L:**
```bash
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs positions
```

**Check open orders:**
```bash
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs orders
```

**View trade history:**
```bash
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs fills
```

**Get price for a coin:**
```bash
node scripts/hyperliquid.mjs price BTC
```

### Trading Operations

All trading commands require `HYPERLIQUID_PRIVATE_KEY`.

**Place limit orders:**
```bash
# Buy 0.1 BTC at $45,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs buy BTC 0.1 45000

# Sell 1 ETH at $3,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs sell ETH 1 3000
```

**Market orders (with 5% slippage protection):**
```bash
# Market buy 0.5 BTC
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-buy BTC 0.5

# Market sell 2 ETH
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-sell ETH 2
```

**Cancel orders:**
```bash
# Cancel specific order
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel BTC 12345

# Cancel all orders
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all

# Cancel all orders for specific coin
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all BTC
```

## Out...

# Hyperliquid Trading Skill for Clawdbot

Full-featured Clawdbot skill for trading Hyperliquid perpetual futures. Monitor your portfolio, analyze markets with charts/volume, and execute trades with AI assistance.

## Features

### Core Trading
- **Portfolio Monitoring**: Balance, positions, P&L tracking
- **Order Execution**: Market and limit orders (long & short)
- **Order Management**: Cancel specific orders or all at once
- **Trade History**: View recent fills
- **Security**: Read-only mode by default, trading requires explicit private key

### Market Analysis Tools 🆕
- **Chart Data with Volume**: Historical price action via CoinGecko
- **Momentum Detection**: Automated signal generation (strong bull/bear/neutral)
- **Volume Analysis**: Compare current volume vs average
- **Multi-timeframe**: 1-hour and 6-hour trend analysis
- **228+ Assets**: Trade any perpetual on Hyperliquid

### Strategy Support 🆕
- **Position Monitoring**: Check P&L with automated alerts
- **Risk Management**: 10% position size, stop losses, profit targets
- **Market Scanner**: Quick overview of all major assets
- **Decision Support**: Wait for high-probability setups

## Installation

```bash
# Install via ClawdHub (recommended)
clawdhub install hyperliquid

# Or install manually in your Clawdbot workspace
cd skills
# Clone or copy the hyperliquid skill folder here

# Install dependencies
cd hyperliquid/scripts
npm install
```

## Configuration

### Read-Only (Portfolio Monitoring)

Set your Hyperliquid address to check balances and positions without private key access:

```bash
export HYPERLIQUID_ADDRESS=0xYourAddress
```

### Trading (Requires Private Key)

For executing trades, set your private key:

```bash
export HYPERLIQUID_PRIVATE_KEY=0xYourPrivateKey
```

**Or use `.env` file** (recommended for security):
```bash
cd hyperliquid
cp .env.example .env
# Edit .env with your credentials
nano .env
```

⚠️ **Security**: Never commit your `.env` file. It's already in `.gitignore`.

### Te...