https://github.com/taprwhiz/hyperliquid-ai-agent
hyperliquid ai trading agent with LLM models
https://github.com/taprwhiz/hyperliquid-ai-agent
hyperliquid hyperliquid-agent hyperliquid-ai-agent hyperliquid-perp-dex
Last synced: about 1 month ago
JSON representation
hyperliquid ai trading agent with LLM models
- Host: GitHub
- URL: https://github.com/taprwhiz/hyperliquid-ai-agent
- Owner: taprwhiz
- Created: 2026-05-21T00:14:25.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-21T09:33:45.000Z (2 months ago)
- Last Synced: 2026-05-21T16:13:54.656Z (2 months ago)
- Topics: hyperliquid, hyperliquid-agent, hyperliquid-ai-agent, hyperliquid-perp-dex
- Language: TypeScript
- Homepage:
- Size: 487 KB
- Stars: 1
- Watchers: 0
- Forks: 268
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Taprwhiz: AI Trading Agent on Hyperliquid
This project implements an AI-powered trading agent that leverages LLM models to analyze real-time market data from TAAPI, make informed trading decisions, and execute trades on the Hyperliquid decentralized exchange. The agent runs in a continuous loop, monitoring specified cryptocurrency assets at configurable intervals, using technical indicators to decide on buy/sell/hold actions, and manages positions with take-profit and stop-loss orders.
## Table of Contents
- [Disclaimer](#disclaimer)
- [Architecture](#architecture)
- [Taprwhiz Live Agents](#taprwhiz-live-agents)
- [Structure](#structure)
- [Env Configuration](#env-configuration)
- [Usage](#usage)
- [Tool Calling](#tool-calling)
- [Deployment to EigenCloud](#deployment-to-eigencloud)
## Disclaimer
There is no guarantee of any returns. This code has not been audited. Please use at your own risk.
## Architecture
See the full [Architecture Documentation](docs/ARCHITECTURE.md) for subsystems, data flow, and design principles.
## Taprwhiz Live Agents
- GPT-5 Pro: [Portfolio Dashboard](https://hypurrscan.io/address/0xa049db4b3dfcb25c3092891010a629d987d26113) | [Live Logs](https://35.190.43.182/logs/0xC0BE8E55f469c1a04c0F6d04356828C5793d8a9D) (Seeded with $200)
- DeepSeek R1: [Portfolio Dashboard](https://hypurrscan.io/address/0xa663c80d86fd7c045d9927bb6344d7a5827d31db) | [Live Logs](https://35.190.43.182/logs/0x4da68B78ef40D12f378b8498120f2F5A910Af1aD) (Seeded with $100) -- PAUSED
- Grok 4: [Portfolio Dashboard](https://hypurrscan.io/address/0x3c71f3cf324d0133558c81d42543115ef1a2be79) | [Live Logs](https://35.190.43.182/logs/0xe6a9f97f99847215ea5813812508e9354a22A2e0) (Seeded with $100) -- PAUSED
## Structure
- `src/index.ts`: Entry point, CLI parsing, API server, and trading loop bootstrap.
- `src/agent/decision-maker.ts`: LLM logic for trade decisions (OpenRouter with tool calling for TAAPI indicators).
- `src/indicators/taapi-client.ts`: Fetches indicators from TAAPI.
- `src/trading/hyperliquid-api.ts`: Executes trades on Hyperliquid.
- `src/config/settings.ts`: Centralized config loaded from `.env`.
## Env Configuration
Populate `.env` (use `.env.example` as reference):
- TAAPI_API_KEY
- HYPERLIQUID_PRIVATE_KEY (or LIGHTER_PRIVATE_KEY)
- OPENROUTER_API_KEY
- LLM_MODEL
- Optional: OPENROUTER_BASE_URL (`https://openrouter.ai/api/v1`), OPENROUTER_REFERER, OPENROUTER_APP_TITLE
### Obtaining API Keys
- **TAAPI_API_KEY**: Sign up at [TAAPI.io](https://taapi.io/) and generate an API key from your dashboard.
- **HYPERLIQUID_PRIVATE_KEY**: Generate an Ethereum-compatible private key for Hyperliquid. Use tools like MetaMask or `eth_account` library. For security, never share this key.
- **OPENROUTER_API_KEY**: Create an account at [OpenRouter.ai](https://openrouter.ai/), then generate an API key in your account settings.
- **LLM_MODEL**: No key needed; specify a model name like "x-ai/grok-4" (see OpenRouter models list).
## Usage
Run: `npm run dev -- --assets BTC ETH --interval 1h`
Or after building:
```bash
npm install
npm run build
npm start -- --assets BTC ETH --interval 1h
```
### Local API Endpoints
When the agent runs, it also serves a minimal API:
- `GET /diary?limit=200` — returns recent JSONL diary entries as JSON.
- `GET /logs?path=llm_requests.log&limit=2000` — tails the specified log file.
Configure bind host/port via env:
- `API_HOST` (default `0.0.0.0`)
- `API_PORT` or `APP_PORT` (default `3000`)
Docker:
```bash
docker build --platform linux/amd64 -t trading-agent .
docker run --rm -p 3000:3000 --env-file .env trading-agent
# Now: curl http://localhost:3000/diary
```
## Tool Calling
The agent can dynamically fetch any TAAPI indicator (e.g., EMA, RSI) via tool calls. See [TAAPI Indicators](https://taapi.io/indicators/) and [EMA Example](https://taapi.io/indicators/exponential-moving-average/) for details.
## Deployment to EigenCloud
EigenCloud (via EigenX CLI) allows deploying this trading agent in a Trusted Execution Environment (TEE) with secure key management.
### Prerequisites
- Allowlisted Ethereum account (Sepolia for testnet). Request onboarding at [EigenCloud Onboarding](https://onboarding.eigencloud.xyz).
- Docker installed.
- Sepolia ETH for deployments.
### Installation
#### macOS/Linux
```bash
curl -fsSL https://eigenx-scripts.s3.us-east-1.amazonaws.com/install-eigenx.sh | bash
```
#### Windows
```bash
curl -fsSL https://eigenx-scripts.s3.us-east-1.amazonaws.com/install-eigenx.ps1 | powershell -
```
### Initial Setup
```bash
docker login
eigenx auth login # Or eigenx auth generate --store (if you don't have a eth account, keep this account separate from your trading account)
```
### Deploy the Agent
From the project directory:
```bash
cp .env.example .env
# Edit .env: set ASSETS, INTERVAL, API keys
eigenx app deploy
```
### Monitoring
```bash
eigenx app info --watch
eigenx app logs --watch
```
### Updates
Edit code or .env, then:
```bash
eigenx app upgrade
```
For full CLI reference, see the [EigenX Documentation](https://github.com/Layr-Labs/eigenx-cli).