hyperliquid

Query Hyperliquid market data, account history, and trade reviews via the public info endpoint.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill hyperliquid-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperliquid
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/blockchain/hyperliquid
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill hyperliquid-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Traders and analysts need quick access to Hyperliquid perpetual and spot market data, wallet positions, and fill history without writing API integration code or managing API keys. This Skill provides a read-only CLI that queries the public /info endpoint and formats results for immediate inspection or export. ## Core Features & Use Cases - Market Data Queries: List perp dexs, markets, spot pairs, candles, funding history, and live L2 order book snapshots with sorting and limiting options. - Account Inspection: Review perp positions, spot balances, recent fills, and orders for any wallet address, with an optional default address from environment config. - Trade Review & Export: Generate heuristic post-trade reviews with realized PnL, fees, win rates, and market context, or export normalized candle and funding JSON datasets for backtesting prep. - Use Case: A trader wants to understand why last week's BTC trades lost money. Run the review command for the wallet over 168 hours, identify the weakest coin, then pull fills, candles, and funding for that period to judge decision quality. ## Quick Start Ask the agent to show the top Hyperliquid perp markets by 24h volume using the hyperliquid skill.

Frequently Asked Questions about hyperliquid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Hyperliquid positions for a wallet address?▼

Run the state command with the wallet address to see perp positions, margin summary, and withdrawable balance. Use spot-balances for spot inventory. Set HYPERLIQUID_USER_ADDRESS in the .env file to omit the address argument.

How to get Hyperliquid funding rate history for a coin?▼

Use the funding command with a coin symbol and an hours window, for example funding BTC --hours 168. It returns timestamped funding rates and premiums from the fundingHistory endpoint, sorted chronologically.

Does the Hyperliquid CLI require an API key?▼

No API key is required. The tool only calls the public read-only /info endpoint, so there is no signing or order placement. It uses only the Python standard library with no external packages.

Can I use the Hyperliquid CLI with testnet?▼

Yes, set HYPERLIQUID_API_URL to https://api.hyperliquid-testnet.xyz in your environment or the .env file under ZEUS_HOME. All commands then target the testnet info endpoint.

What are the limitations of Hyperliquid fills history queries?▼

The fills command uses userFillsByTime, which only exposes a recent rolling window rather than full archive history. Similarly, historicalOrders returns recent orders only, so long-range trade audits are not possible.

Why does the Hyperliquid review command not match my actual PnL?▼

The review command is heuristic and cannot reconstruct intent, order placement quality, or true slippage from fills alone. It reports realized PnL and fees from reported fills, which may differ from complete account performance.