skills.rest
vivekgoquest
vivekgoquestCOMMUNITY
Explore all skills by this author →
GitHub

hyperliquid

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

Updated Aug 22, 2026
Search Tags:#trading#market data#crypto#perpetuals#Hyperliquid#funding rate#trade review
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill hyperliquid-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperliquid
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/blockchain/hyperliquid
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill hyperliquid-vivekgoquest

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, fills, and funding history directly from the public /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 snapshots 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 preparation. - 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 to see net PnL after fees, fee drag, and whether losses came from leaning 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 a specific 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, spots, candles, funding, or l2 followed by a coin symbol. Add --json for machine-readable output and use flags like --limit, --sort, --interval, and --hours to control the results.

How to check Hyperliquid positions and balances for a wallet?▼

Use the state command for perp positions and spot-balances for spot inventory, passing the wallet address as the first argument. You can also set HYPERLIQUID_USER_ADDRESS in the .env file so the address is optional for state, fills, orders, and review commands.

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. All queries are read-only with no signing or order placement, and the script relies solely on the Python standard library with no external packages.

Can I use the Hyperliquid testnet instead of mainnet?▼

Yes, set HYPERLIQUID_API_URL to https://api.hyperliquid-testnet.xyz in your environment or the .env file under ~/.hermes. The script defaults to the mainnet API at https://api.hyperliquid.xyz when no override is provided.

What are the limitations of Hyperliquid fills and orders history?▼

The fills command uses userFillsByTime, which only exposes a recent rolling window rather than full archive history, and historicalOrders returns recent orders only. Large historical queries may also be capped by rate limits, requiring pagination with later startTime values.

How do I export Hyperliquid candles 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, but note you still need your own slippage and fill model for actual backtesting.

Related Skills

Explore More Finance & Accounting Skills→
sheawinklersheawinkler
78

hyperliquid

Fetch Hyperliquid market and account data from public endpoints via Python CLI.

Community
Intermediate
VernonOYVernonOY
81

alpha-backtest

Backtest single- and multi-factor portfolios with gate checks and IS/OOS evaluation.

Community
Advanced
datagridSolutiondatagridSolution

Cross-Chain Aggregator

Aggregate wallet tokens, DeFi positions, staking, and NFTs across blockchain networks into unified portfolio views with per-chain breakdowns.

Official
Advanced
2025Emma2025Emma
22.7k

cryptofeed

Stream real-time cryptocurrency market data from multiple exchanges via WebSocket.

Community
Advanced