Hyperliquid Trading Agent

Hyperliquid AI Trading Agent

An AI-powered trading agent that uses Claude to analyze markets and execute perpetual futures trades on Hyperliquid. Supports crypto, stocks, commodities, indices, and forex via HIP-3 markets.

What It Does

1. Fetches real-time candle data and computes technical indicators (EMA, RSI, MACD, ATR, BBands, ADX, OBV, VWAP) locally from Hyperliquid
2. Sends full market context to Claude, which decides buy/sell/hold for each asset
3. Executes trades with take-profit and stop-loss orders
4. Hard-coded safety guards enforce position limits, leverage caps, and loss protection

Tradeable Markets

All 229+ Hyperliquid perp markets plus HIP-3 tradfi assets:

• Crypto: BTC, ETH, SOL, HYPE, AVAX, SUI, ARB, LINK, and 200+ more
• Stocks: xyz:TSLA, xyz:NVDA, xyz:AAPL, xyz:GOOGL, xyz:AMZN, xyz:META, xyz:MSFT, xyz:COIN, xyz:PLTR...
• Commodities: xyz:GOLD, xyz:SILVER, xyz:BRENTOIL, xyz:CL, xyz:COPPER, xyz:NATGAS, xyz:PLATINUM
• Indices: xyz:SP500, xyz:XYZ100
• Forex: xyz:EUR, xyz:JPY

Safety Guards

All enforced in code, not just LLM prompts. Configurable via `.env`:

Guard	Default	Description
Max Position Size	10%	Single position capped at 10% of portfolio
Force Close	-20%	Auto-close positions at 20% loss
Max Leverage	10x	Hard leverage cap
Total Exposure	50%	All positions combined capped at 50%
Daily Circuit Breaker	-10%	Stops new trades at 10% daily drawdown
Mandatory Stop-Loss	5%	Auto-set SL if LLM doesn't provide one
Max Positions	10	Concurrent position limit
Balance Reserve	20%	Don't trade below 20% of initial balance

Setup

Prerequisites

• Python 3.12+
• Anthropic API key
• Hyperliquid wallet (agent wallet as signer + main wallet with funds)

Configuration

cp .env.example .env
# Edit .env with your keys

Required environment variables:

• ANTHROPIC_API_KEY — Claude API key
• `HYPERLIQUID_P