Read-only Hyperliquid assistant for market data + account views.
- Supports natural language, terminal-style (
hl ...), and slash-style (/hl ...). - Uses Hyperliquid Info endpoint:
POST https://api.hyperliquid.xyz/info - No trading, no private keys.
- Quotes: mark/mid/oracle, 24h change, 24h notional volume, open interest, funding, premium, impact prices
- Movers (24h)
- Funding rankings (top/bottom)
- L2 order book (top levels)
- Candle snapshots (common intervals)
- Overview dashboard
Given an EVM address (master or sub-account), you can view:
- Perp positions + margin summary
- Spot balances
- Open orders
- Recent fills
Note: Use the address that actually owns the account/positions. Using an agent wallet address may return empty results.
- “What are the top movers on Hyperliquid today?”
- “Hyperliquid quote BTC”
- “Show me the order book for ETH”
- “Give me 1h candles for SOL for the last 48 bars”
- “Show my Hyperliquid positions HL:0x….”
hl quote BTC/hl movers --top 10hl funding-top --n 10hl funding-bottom --n 10hl book ETHhl candles SOL --interval 1h --last 48hl overview
hl positions HL:0x...hl balances HL:0x...hl orders HL:0x...hl fills HL:0x... --n 10
Accounts are stored locally in:
~/.clawdbot/hyperliquid/config.json
hl account add "sub account 1" HL:0x... --defaulthl account listhl account remove "sub account 1"hl account default "sub account 1"
hl positions "sub account 1"hl balances "sub account 1"hl orders "sub account 1"hl fills "sub account 1" --n 5
If a default account is set, you can omit the argument:
hl positions
Run the chat script directly:
node scripts/hyperliquid_chat.mjs "hl quote BTC"
node scripts/hyperliquid_chat.mjs "What are the top movers on Hyperliquid today?"
node scripts/hyperliquid_chat.mjs "hl positions HL:0x..."SKILL.md— skill instructions/triggeringscripts/hyperliquid_api.mjs— HTTP client + helpersscripts/hyperliquid_chat.mjs— parser + command dispatcher + formattingscripts/hyperliquid_config.mjs— saved account aliasesreferences/hyperliquid-api.md— API notes