How sanketagarwal/hyperliquid-trading-agent works
This is a Hyperliquid perpetual-futures trading agent: a configured trading loop gathers account and candle context, computes local indicators, asks Claude for per-asset decisions, applies code-enforced risk checks, and submits approved orders. The loop also exposes diary and log endpoints. The README documents the overall sequence; sampled source confirms the main orchestration, exchange wrapper, indicator calculations, Claude integration, and risk checks. Some implementation details in the unsampled portions of the loop are not independently verified here.
Main entry points: main.py Trading loop and API · hyperliquid_api.py Hyperliquid client · decision_maker.py Claude decisions · config_loader.py Environment config
Components 9
Trading loop
- Trading loop and API
src/main.py - Environment config
src/config_loader.py
Market analysis
- Local indicators
src/indicators/local_indicators.py - Claude decisions
src/agent/decision_maker.py
Risk and execution
- Hyperliquid client
src/trading/hyperliquid_api.py - Risk guards
src/risk_manager.py
External interfaces
- Anthropic Claude
- Hyperliquid exchange
Other components
- Operator
Connections 18
- Operator → Trading loop and API: starts loop
- Trading loop and API → Environment config: reads settings
- Trading loop and API → Hyperliquid client: fetches account and market data
- Hyperliquid client → Hyperliquid exchange: queries candles and account
- Hyperliquid client → Hyperliquid exchange: submits and manages orders
- Trading loop and API → Local indicators: computes indicators
- Trading loop and API → Claude decisions: requests decisions
- Claude decisions → Anthropic Claude: sends context
- Anthropic Claude → Claude decisions: returns decisions
- Trading loop and API → Risk guards: validates trades
- Trading loop and API → Hyperliquid client: executes approved trades
- Trading loop and API → Hyperliquid client: closes loss-limit positions
- Operator → Trading loop and API: requests diary or logs
- Trading loop and API → Operator: serves API response
- Trading loop and API → Claude decisions: records trade activity
- Claude decisions → Environment config: reads settings
- Risk guards → Environment config: reads limits
- Hyperliquid client → Environment config: reads credentials