Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Query Hyperliquid DEX for account balances, positions, PnL, and margin data via ClawdBot API
Query Hyperliquid DEX for account balances, positions, PnL, and margin data via ClawdBot API
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Query your Hyperliquid perpetuals account for real-time balances, open positions, unrealized PnL, and margin data.
This skill is designed for ClawdBot - it calls ClawdBot's internal API server which proxies requests to the official Hyperliquid API at https://api.hyperliquid.xyz. Architecture: User โ ClawdBot Gateway โ ClawdBot API Server โ Hyperliquid Public API (Railway) (api.hyperliquid.xyz) The ClawdBot API server handles: Timeout protection (15s) Response parsing and formatting Default wallet address from env vars
Account Overview: Get total account value, free collateral, and margin usage Position Tracking: View all open perpetual positions with size, direction, entry price PnL Monitoring: Real-time unrealized PnL and return on equity per position Risk Management: Liquidation prices and leverage info for each position Multi-Wallet: Query any wallet address or use configured trading wallet
VariableRequiredDescriptionTRADING_WALLET_ADDRESSNoDefault wallet address (0x format) to query when none provided
ClawdBot Internal API: POST {CLAWDBOT_API_URL}/api/hyperliquid/account Upstream API (called by ClawdBot): POST https://api.hyperliquid.xyz/info
{ "walletAddress": "0x..." } If no wallet address provided, uses TRADING_WALLET_ADDRESS env var.
{ "timestamp": "2026-02-10T03:30:00.000Z", "walletAddress": "0x...", "account": { "accountValue": 10523.45, "totalPositionNotional": 25000.00, "freeCollateral": 5200.00, "totalMarginUsed": 5323.45 }, "positions": [ { "coin": "ETH", "direction": "long", "size": 2.5, "entryPrice": 2450.00, "positionValue": 6250.00, "unrealizedPnl": 125.50, "returnOnEquity": 0.024, "leverage": { "type": "cross", "value": 5 }, "liquidationPrice": 1850.00, "marginUsed": 1250.00 } ], "positionCount": 1 }
Read-only: This skill only reads account data, no trading/signing capabilities Public API: Uses Hyperliquid's public info API (no authentication required) No private keys: Only wallet addresses (public) are used Timeout protected: 15-second timeout prevents hanging requests
"What's my Hyperliquid balance?" "Show my HL account value"
"What positions do I have open on Hyperliquid?" "Am I in profit on my perps?" "What's my unrealized PnL?"
"What are my liquidation prices on Hyperliquid?" "How much margin am I using?" "What leverage am I running?"
Hyperliquid Docs ichimoku - Ichimoku Cloud trading signals wallet-tracker - Monitor wallet balances across chains crypto-tracker - Track crypto prices and portfolios
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.