hyperliquid-claw

? Hyperliquid Claw — OpenClaw Skill Definition

Version: 3.0.0 (Rust Edition)

Compatible with: OpenClaw / clawd.bot

name: hyperliquid-claw version: "3.0.0" description: > AI-driven trading skill for Hyperliquid perpetual futures. Built in Rust for maximum performance and safety. Gives your OpenClaw assistant full read and trade access to all 228+ perpetuals on the Hyperliquid DEX via a native MCP stdio server.

author: Hyperliquid Claw Contributors license: MIT homepage: https://github.com/YourUsername/HyperLiquid-Claw

── Runtime ──────────────────────────────────────────────────────────────────

runtime: type: binary command: hl-mcp # compiled Rust binary; runs as MCP stdio server install_hint: > cargo install --path . --bin hl-mcp

environment: required: [] optional: - name: HYPERLIQUID_ADDRESS description: Your wallet address (read-only mode — no private key needed) example: "0xABCDEF..." - name: HYPERLIQUID_PRIVATE_KEY description: Private key for executing trades (required for trading commands) example: "0xYourPrivateKey" - name: HYPERLIQUID_TESTNET description: Set to any value to use testnet instead of mainnet example: "1"

── Tools exposed to OpenClaw ─────────────────────────────────────────────────

tools:

• name: hl_price description: Get the current mark price for any Hyperliquid perpetual parameters: coin: { type: string, required: true, description: "Asset ticker, e.g. BTC, ETH, SOL" } examples:

  • "What's the BTC price?"
  • "Show me the ETH mark price"

• name: hl_meta description: List all 228+ tradeable perpetuals on Hyperliquid parameters: {} examples:

  • "What assets can I trade on Hyperliquid?"
  • "List all perpetuals"

• name: hl_market_scan description: > Scan all markets for momentum signals using the Rust momentum engine. Detects strong bull/bear moves with volume confirmation. parameters: top_n: { type: integer, required: false, default: 10, description: "Number of top results" } examples:

  • "Analyze the crypto market on Hyperliquid"
  • "What's moving right now? Show me the top opportunities"
  • "Scan for trading signals"

• name: hl_analyze description: > Deep momentum analysis for a single asset: price change, volume, OI, funding rate, signal classification and confidence score. parameters: coin: { type: string, required: true } examples:

  • "Analyze BTC momentum"
  • "What's the SOL signal right now?"
  • "Give me a full analysis of ETH"

• name: hl_balance description: Show account equity, margin usage, and free margin parameters: {} examples:

  • "Check my portfolio"
  • "What's my account balance?"
  • "How much margin do I have left?"

• name: hl_positions description: List all open perpetual positions with entry price, size, and unrealised P&L parameters: {} examples:

  • "Show my positions"
  • "What trades am I in?"
  • "Check my P&L"

• name: hl_orders description: List all open limit orders parameters: {} examples:

  • "Show my open orders"
  • "What limit orders do I have?"

• name: hl_fills description: Recent trade fills / execution history parameters: limit: { type: integer, required: false, default: 20 } examples:

  • "Show my recent trades"
  • "What fills did I get today?"

• name: hl_market_buy description: > Place a market buy (long) order. Uses IOC limit with 5% slippage buffer. Warns if position exceeds 20% of equity. parameters: coin: { type: string, required: true } size: { type: number, required: true, description: "Size in coin units" } examples:

  • "Buy 0.1 BTC"
  • "Enter a SOL long with 0.5 SOL"
  • "Go long on ETH, 1 ETH"

• name: hl_market_sell description: > Place a market sell / short order. Same safety features as market buy. parameters: coin: { type: string, required: true } size: { type: number, required: true } examples:

  • "Short 0.5 ETH"
  • "Sell 0.1 BTC"
  • "Close my BTC position"

• name: hl_limit_buy description: Place a GTC limit buy order parameters: coin: { type: string, required: true } size: { type: number, required: true } price: { type: number, required: true } examples:

  • "Buy 0.001 BTC at 88000"
  • "Limit buy ETH at 3100 for 1 ETH"

• name: hl_limit_sell description: Place a GTC limit sell order parameters: coin: { type: string, required: true } size: { type: number, required: true } price: { type: number, required: true } examples:

  • "Sell 1 ETH at 3500"
  • "Set a limit sell for 0.001 BTC at 95000"

• name: hl_cancel_all description: Cancel all open orders, or all orders for a specific coin parameters: coin: { type: string, required: false } examples:

  • "Cancel all my orders"
  • "Cancel all BTC orders"

• name: hl_set_leverage description: Set leverage for a coin (1–50x, cross or isolated margin) parameters: coin: { type: string, required: true } leverage: { type: integer, required: true, description: "1 to 50" } cross: { type: boolean, required: false, default: true, description: "true=cross, false=isolated" } examples:

  • "Set BTC to 10x cross leverage"
  • "Set ETH to 5x isolated"

── Momentum Strategy (built into the skill) ──────────────────────────────────

strategy: name: Momentum Scalp description: > Automated bull/bear detection via price change + volume confirmation. Implemented in the Rust MomentumEngine (src/analysis/signals.rs).

entry_conditions: - price_change_pct: "> 0.5% or < -0.5% (24h)" - volume_vs_oi: "> 1.5× baseline" - funding_rate: "contrarian filter applied"

risk_parameters: position_size_pct: 10 # % of account equity per trade max_loss_pct: 1 # stop loss take_profit_pct: 2 # profit target max_concurrent_positions: 1 max_hold_hours: 4

safety_limits: slippage_cap_pct: 5 # enforced in Rust ExchangeClient position_warning_pct: 20 # warn if trade > 20% equity limit_deviation_warning_pct: 5

── System prompt injection for OpenClaw ──────────────────────────────────────

system_prompt: | You have full access to the Hyperliquid perpetual futures DEX through the Hyperliquid Claw skill. You can:

READ (no key needed): • Check prices, list markets, scan for signals • View account balance, open positions, order history

TRADE (requires HYPERLIQUID_PRIVATE_KEY): • Place market and limit orders (buy/sell/long/short) • Cancel orders, set leverage • Close positions

SAFETY RULES — always enforce these:

1. Never risk more than 10% of equity on a single trade
2. Always confirm with the user before placing orders
3. Warn loudly if position would exceed 20% of equity
4. Recommend stop loss at -1% and take profit at +2%
5. Never auto-retry a failed trade
6. On testnet: all actions are safe to test freely

SIGNAL GUIDE: ? STRONG BULLISH → Consider long entry (confirm volume) ? BULLISH → Wait for confirmation before entering ⚪ NEUTRAL → No edge, stay flat ? BEARISH → Wait for confirmation ? STRONG BEARISH → Consider short entry (confirm volume)