🤖 Hypii Hyperliquid Trading Agent

AI-powered trading strategies for Hyperliquid perpetual futures with integrated SkillPay billing.

Features

• 📊 Portfolio Management - View balances, positions, and P&L
• 💰 Price Queries - Real-time price data for any coin
• 📈 DCA Strategy - Automated dollar-cost averaging
• 🔲 Grid Trading - Range-bound automated trading
• 🤖 AI Signals - Trend analysis and trading signals
• 🚀 Auto Trading - Execute trades directly through the agent

Pricing

Setup

Prerequisites

1. Hyperliquid account with funds
2. SkillPay API key (for billing)
3. Private key (for trading operations)

Environment Variables

# Required for billing
export SKILLPAY_API_KEY="your_skillpay_api_key"

# For read-only operations
export HYPERLIQUID_ADDRESS="0x..."

# For trading operations
export HYPERLIQUID_PRIVATE_KEY="0x..."

# Optional: Use testnet
export HYPERLIQUID_TESTNET="1"

Installation

# Install dependencies
cd skills/hypii-hyperliquid-trader && npm install

# The skill will be automatically loaded by OpenClaw

Usage

Free Commands (5 per day)

# View portfolio
node index.js portfolio

# Get price
node index.js price BTC

Strategy Commands (0.05 USDT)

# Create DCA strategy
node index.js dca --coin BTC --amount 100 --frequency daily --orders 10

# Create Grid strategy
node index.js grid --coin ETH --lower 2000 --upper 3000 --grids 10 --investment 1000

# Get AI signal
node index.js signal BTC

Trading Commands (0.1 USDT + requires private key)

# Market buy
node index.js buy BTC 0.1

# Market sell
node index.js sell ETH 1.0

# Limit order
node index.js trade --coin BTC --side buy --size 0.1 --price 45000 --type limit

API Reference

Handler Input Format

{
  action: 'portfolio' | 'price' | 'dca' | 'grid' | 'signal' | 'trade' | 'buy' | 'sell',
  // Action-specific parameters
  coin: 'BTC',           // For price, signal, trade
  amount: 100,           // For DCA
  frequency: 'daily',    // For DCA: 'hourly', 'daily', 'weekly'
  totalOrders: 10,       // For DCA
  lowerPrice: 2000,      // For Grid
  upperPrice: 3000,      // For Grid
  grids: 10,             // For Grid
  totalInvestment: 1000, // For Grid
  side: 'buy',           // For trade: 'buy' | 'sell'
  size: 0.1,             // For trade
  orderType: 'market',   // For trade: 'market' | 'limit'
  price: 45000           // For limit orders
}

Response Format

{
  success: true,
  free: false,           // Whether this was a free call
  remaining: 3,          // Free calls remaining (if applicable)
  charged: 0.05,         // Amount charged in USDT
  data: { ... },         // Response data
  message: "..."         // Human-readable message
}

Safety Features

• ✅ Slippage Protection - Market orders use 5% slippage protection
• ✅ Position Sizing Warnings - Alerts for large positions (>20% of equity)
• ✅ Price Validation - Warns if limit orders are >5% from market price
• ✅ Free Tier - Try before you pay
• ✅ Transparent Billing - Clear pricing before each operation

Architecture

┌─────────────────────────────────────────────────────────────┐
│  User Request                                                │
│     ↓                                                        │
│  ┌─────────────────┐                                         │
│  │ Billing Check   │ ← Free tier or SkillPay charge          │
│  └─────────────────┘                                         │
│     ↓                                                        │
│  ┌─────────────────────────────────────────────────────────┐│
│  │ Hypii Strategy Engine                                    ││
│  │  ├─ DCA Strategy                                         ││
│  │  ├─ Grid Strategy                                        ││
│  │  ├─ Trend Analysis                                       ││
│  │  └─ Risk Management                                      ││
│  └─────────────────────────────────────────────────────────┘│
│     ↓                                                        │
│  ┌─────────────────┐                                         │
│  │ Hyperliquid SDK │ ← Execute trades                       │
│  └─────────────────┘                                         │
│     ↓                                                        │
│  Response with billing info                                  │
└─────────────────────────────────────────────────────────────┘

Roadmap

• Advanced AI models for signal generation
• Backtesting engine
• Multi-strategy portfolio management
• Social trading features
• Mobile app integration

Support

• GitHub Issues: [Report bugs or request features]
• Discord: [Join our community]
• Email: [email protected]

License

MIT License - See LICENSE file for details

Disclaimer

Trading cryptocurrencies involves significant risk. This tool is for educational and automation purposes. Always do your own research and never trade more than you can afford to lose.