hyperliquidRead-only Hyperliquid market data assistant (perps + spot optional) with support for natural-language requests and deterministic command parsing (terminal-style `hl ...` and slash-style `/hl ...`). Use to fetch quotes (mark/mid/oracle/funding/OI/volume), top movers, funding rankings, L2 order book, and candle snapshots via https://api.hyperliquid.xyz/info, and to format results for chat.
Install via ClawdBot CLI:
clawdbot install k0nkupa/hyperliquidImplement read-only market-data queries for Hyperliquid using the Info HTTP endpoint:
POST https://api.hyperliquid.xyz/infoContent-Type: application/jsonPrefer HTTP snapshot flows for v1. WebSocket streaming can be added later.
Treat these as equivalent:
hl quote BTC, hl movers --top 10 --window 24h/hl quote BTC, /hl overviewParse /hl and hl first (deterministic). If no prefix, fall back to intent extraction from natural language.
Market data:
quote : show mark/mid/oracle, 24h change (prevDayPx), 24h notional volume, open interest (perps), funding (perps), premium, impact pricesmovers [--window 24h] [--top N]: rank by 24h % change (markPx vs prevDayPx)funding-top|funding-bottom [--n N]: rank by funding (perps only)book : show top 20 levels per side (and spread)candles --interval <1m|...|1M> (--last N | --start --end ) overview: concise dashboard: top movers, top funding, top OI, top volumeAccount (read-only):
positions : show perp positions + margin summarybalances : show spot balancesorders : show open ordersfills [--n N] : show recent fillsSaved account aliases (stored locally in ~/.clawdbot/hyperliquid/config.json):
account listaccount add "sub account 1" HL:0x... [--default]account remove "sub account 1"account default "sub account 1"Natural language equivalents should work too:
Perpetuals:
metaAndAssetCtxs (preferred): universe + asset contexts for all perpsl2BookcandleSnapshotSpot (optional later):
spotMetaAndAssetCtxs, spotMetaSee references/hyperliquid-api.md for request bodies and field meanings.
Use the bundled scripts:
scripts/hyperliquid_api.mjs: thin HTTP client + helpers (safe defaults, timeouts)scripts/hyperliquid_chat.mjs: parses user text into an intent + args, calls API helpers, and prints a compact chat-friendly responseWhen responding:
Run locally:
node skills/hyperliquid/scripts/hyperliquid_chat.mjs "hl quote BTC"
node skills/hyperliquid/scripts/hyperliquid_chat.mjs "/hl movers --top 5"
Generated Mar 1, 2026
Traders at a crypto hedge fund or proprietary trading firm can use this skill to monitor real-time market data for Hyperliquid perpetuals and spot markets. They can quickly fetch quotes, order books, and top movers to inform trading decisions without leaving their chat environment, streamlining workflow and reducing context switching.
Individual investors and DeFi enthusiasts can integrate this skill into their portfolio management bots to track positions, balances, and recent fills on Hyperliquid. By using saved account aliases, they can easily switch between multiple sub-accounts and receive concise overviews of their holdings and performance.
Crypto influencers, analysts, and news outlets can leverage this skill to gather data for reports, videos, or social media posts. They can fetch funding rankings, candle snapshots, and top movers to highlight market trends and generate insights, enhancing the accuracy and timeliness of their content.
Developers building automated trading systems can use this skill as a read-only data source to feed market signals into their algorithms. By parsing natural language or deterministic commands, bots can retrieve quotes, order books, and funding rates to trigger trades or adjust strategies based on real-time Hyperliquid data.
Online learning platforms and crypto education services can embed this skill to provide students with hands-on experience accessing live market data. Learners can practice querying quotes, movers, and funding rankings to understand market dynamics, supported by the skill's natural language interface for ease of use.
Offer tiered subscription plans for businesses that need enhanced data access, such as higher rate limits, historical data archives, or premium endpoints. Revenue is generated through monthly or annual fees, with custom plans for high-volume users like trading firms or analytics platforms.
Provide a free basic version of the skill for individual users, with advanced features like saved account aliases, detailed reports, or automated alerts available for a fee. Upsell premium features to active traders and institutions seeking deeper insights and customization options.
License the skill's technology to other cryptocurrency exchanges or trading platforms as a white-label solution. They can rebrand and integrate it into their own systems, generating revenue through licensing fees or revenue-sharing agreements based on user engagement and data usage.
đź’¬ Integration Tip
Use the bundled scripts for easy setup, and start with HTTP snapshot flows before adding WebSocket streaming to keep initial integration simple and reliable.
Connect Claude to Clawdbot instantly and keep it connected 24/7. Run after setup to link your subscription, then auto-refreshes tokens forever.
ERC-8004 Trustless Agents - Register, discover, and build reputation for AI agents on Ethereum. Use when registering agents on-chain, querying agent registries, giving/receiving reputation feedback, or interacting with the AI agent trust layer.
Autonomous crypto trading on Base via Bankr. Use for trading tokens, monitoring launches, executing strategies, or managing a trading portfolio. Triggers on "trade", "buy", "sell", "launch", "snipe", "profit", "PnL", "portfolio balance", or any crypto trading task on Base.
Deploy ERC20 tokens on Base using Clanker SDK. Create tokens with built-in Uniswap V4 liquidity pools. Supports Base mainnet and Sepolia testnet. Requires PRIVATE_KEY in config.
Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when the user wants to check wallet balances, DeFi positions, NFT holdings, token prices, or transaction history. Supports Base, Ethereum, Polygon, Arbitrum, Optimism, and more. Requires ZAPPER_API_KEY.
Interact with Solana blockchain via Helius APIs. Create/manage wallets, check balances (SOL + tokens), send transactions, swap tokens via Jupiter, and monitor addresses. Use for any Solana blockchain operation, crypto wallet management, token transfers, DeFi swaps, or portfolio tracking.