CAI: hyperliquid-with-cai

SKILL.md

---
name: hyperliquid-with-cai
description: 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.
metadata:
  version: 1.0.15
---

# 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

```bash
openclaw secrets set CAI_API_KEY "your_dashboard_api_key"
```

Scope: **`platform`** or **`full`**.

## Canonical Reference

- https://cai.com/skill.md §6.1b
- https://cai.com/specs/cai-tools.manifest.json
- https://cai.com/developers.html