hyperliquid

Query Hyperliquid market data, account positions, fills, and funding via the public info endpoint.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manually checking Hyperliquid perpetual and spot markets, wallet positions, and trade history requires navigating the exchange UI or writing custom API calls. This Skill provides a read-only CLI that pulls market data, account state, and trade reviews directly from the Hyperliquid /info endpoint with no API key required. ## Core Features & Use Cases - Market Data Queries: List perp DEXs, markets, spot pairs, candles, funding history, and live L2 order book depth with sorting and limiting options. - Account Inspection: Review perp positions, spot balances, recent fills, and historical orders for any wallet address. - 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: Ask for a review of your wallet's 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 24h 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 to fetch perp and spot data from the public /info endpoint. Add --json to any command for machine-readable output.

How to check Hyperliquid positions and fills for a wallet address?▼

Use the state command for perp positions, spot-balances for spot inventory, and fills or orders for trade history. Pass the address as an argument or set HYPERLIQUID_USER_ADDRESS in ~/.gpucloud/.env as a default.

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

No API key is needed for the public /info endpoint used by this tool. It is read-only with no signing and no order placement, covering markets, candles, funding, order books, and account queries.

Can I use the Hyperliquid testnet instead of mainnet?▼

Yes, set HYPERLIQUID_API_URL to https://api.hyperliquid-testnet.xyz in your environment or ~/.gpucloud/.env file. The script defaults to the mainnet API at https://api.hyperliquid.xyz.

What are the limitations of Hyperliquid historical data queries?▼

Public info endpoints are rate-limited and large historical queries may return capped windows, requiring iteration with later startTime values. The fills endpoint only exposes a recent rolling window, and historicalOrders returns recent orders only, not a full archive.

How do I export Hyperliquid candles and funding data for backtesting?▼

Use the export command with a coin, interval, and hour window to write a normalized JSON file containing candle rows, funding rows, and summary stats. Use --end-time-ms for reproducible windows; you still need your own slippage and fill model.