hyperliquid

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

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

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. ## Core Features & Use Cases - Market Data Queries: Fetch perp and spot markets, candles, funding rates, and L2 order book snapshots through 12 CLI commands. - Account Inspection: Review perp positions, spot balances, recent fills, and orders for any wallet address. - Trade Review & Export: Generate post-trade reviews with realized PnL, fees, and win/loss stats, or export normalized candle and funding JSON datasets for backtesting prep. - Use Case: Ask for a review of your last 72 hours of trading to see which coins lost money, how much fees consumed, and whether you traded against the market trend. ## Quick Start Ask the agent to show the top Hyperliquid perp markets by volume or to review recent fills for your wallet address.

Frequently Asked Questions about hyperliquid

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

FAQPage Schema
How do I query Hyperliquid market data from the command line?

Run the hyperliquid_client.py script with commands like markets, candles, funding, or l2 followed by a coin symbol. Add --json for machine-readable output and use flags like --limit, --interval, and --hours to control the results.

How to review Hyperliquid trade history and PnL for a wallet?

Use the review command with a wallet address to get realized PnL, fees, win/loss counts, and per-coin breakdowns over a time window. The fills and orders commands provide the raw trade-by-trade detail for deeper inspection.

Does the Hyperliquid API require an API key for market data?

No API key is needed for read-only queries. This tool uses only the public /info endpoint, so there is no signing or authentication; optionally set HYPERLIQUID_USER_ADDRESS in ~/.hermes/.env as a default wallet.

Can I export Hyperliquid candles and funding data for backtesting?

Yes, the export command writes a normalized JSON file containing candle rows, funding rows, time window metadata, and summary stats. Use --end-time-ms for reproducible windows, but note you still need your own slippage and fill model.

What are the limitations of Hyperliquid historical data queries?

The fills endpoint only exposes a recent rolling window, not full archive history, and historicalOrders returns recent orders only. Public endpoints are rate-limited, so large windows may require paginating with later startTime values.