ClawHub

CAI: hyperliquid-with-cai

Other

Trade Hyperliquid perps via CAI Route B — no HL website signup; approveAgent on /act, defi_trade place/cancel, defi_orders and defi_positions. Requires platform or full API scope. Powered by CAI.com. Canonical skill v1.0.15.

Install

openclaw skills install hyperliquid-with-cai

Hyperliquid with CAI (Route B)

CAI E-mode trades Hyperliquid perpetuals using a custodial EVM address and a derived agent key. The user does not register on hyperliquid.xyz. Protocol onboarding is approveAgent (and optional deposit) via hosted /act, not a separate HL account.

When to Use

  • "Trade Hyperliquid perps with my CAI wallet"
  • "Enable HL agent trading without creating a Hyperliquid account"
  • "Place a small BTC perp on Hyperliquid after enrollment"
  • "Show my HL open orders and positions"

Route B task flow (preferred)

  1. User enables hyperliquid at https://cai.com/automation-settings.
  2. platform_readiness or defi_portfolio with platform_slug=hyperliquid. If deposit_required, guide user through /act with optional hl_deposit_usd or explain bridge timing (~1 min after ARB USDC bridge).
  3. If not enrolled: platform_automation_enroll with platform_slug=hyperliquid → user completes /act (approveAgent).
  4. Place: defi_trade example:
    • platform_slug: hyperliquid
    • action: place
    • asset: BTC (or HIP-3 xyz:SYMBOL)
    • size, price, is_buy, intent_usd, optional dex
  5. Status: defi_orders and defi_positions with ?platform_slug=hyperliquid. Use returned order_id (oid) for cancel — not EVM tx_hash.
  6. Cancel: defi_trade with action: cancel, oid + asset (or cancels[]).

Legacy aliases

  • hyperliquid_readiness, hyperliquid_place_order, hyperliquid_cancel, hyperliquid_positions — equivalent reads/writes; prefer Route B tools when routing.

What NOT to say

  • Do not tell users to "register on Hyperliquid" or "login to hyperliquid.xyz".
  • Do not use transfer_status for HL order lifecycle (use defi_orders).

Honesty

  • gap_id: GAP_DEFI_HYPERLIQUID_V1, GAP_DEFI_AUTOMATION_V1 — partial_live until enroll + trade smokes pass.
  • Agent key cannot withdraw to arbitrary addresses (protocol design).
  • HIP-3 / trade.xyz markets: use asset like xyz:NVDA or dex param — see trade-xyz-with-cai wrapper for narrative.

Quick Setup

openclaw secrets set CAI_API_KEY "your_dashboard_api_key"

Scope: platform or full.

Canonical Reference