undefined

undefined

if ! command -v hyperliquid >/dev/null 2>&1; then
  OS=$(uname -s | tr A-Z a-z)
  ARCH=$(uname -m)
  EXT=""
  case "${OS}_${ARCH}" in
    darwin_arm64)  TARGET="aarch64-apple-darwin" ;;
    darwin_x86_64) TARGET="x86_64-apple-darwin" ;;
    linux_x86_64)  TARGET="x86_64-unknown-linux-gnu" ;;
    linux_i686)    TARGET="i686-unknown-linux-gnu" ;;
    linux_aarch64) TARGET="aarch64-unknown-linux-gnu" ;;
    linux_armv7l)  TARGET="armv7-unknown-linux-gnueabihf" ;;
    mingw*_x86_64|msys*_x86_64|cygwin*_x86_64)   TARGET="x86_64-pc-windows-msvc"; EXT=".exe" ;;
    mingw*_i686|msys*_i686|cygwin*_i686)           TARGET="i686-pc-windows-msvc"; EXT=".exe" ;;
    mingw*_aarch64|msys*_aarch64|cygwin*_aarch64)  TARGET="aarch64-pc-windows-msvc"; EXT=".exe" ;;
  esac
  mkdir -p ~/.local/bin
  curl -fsSL "https://github.com/okx/plugin-store/releases/download/plugins/hyperliquid@0.1.0/hyperliquid-${TARGET}${EXT}" -o ~/.local/bin/hyperliquid${EXT}
  chmod +x ~/.local/bin/hyperliquid${EXT}
fi

REPORT_FLAG="$HOME/.plugin-store/reported/hyperliquid"
if [ ! -f "$REPORT_FLAG" ]; then
  mkdir -p "$HOME/.plugin-store/reported"
  # Device fingerprint → SHA256 → 32-char device ID
  DEV_RAW="$(hostname):$(uname -s):$(uname -m):$HOME"
  DEV_ID=$(echo -n "$DEV_RAW" | shasum -a 256 | head -c 32)
  # HMAC signature (obfuscated key, same as CLI binary)
  _K=$(echo 'OE9nNWFRUFdfSVJkektrMExOV2RNeTIzV2JibXo3ZWNTbExJUDFIWnVoZw==' | base64 -d 2>/dev/null || echo 'OE9nNWFRUFdfSVJkektrMExOV2RNeTIzV2JibXo3ZWNTbExJUDFIWnVoZw==' | openssl base64 -d)
  HMAC_SIG=$(echo -n "${_K}${DEV_ID}" | shasum -a 256 | head -c 8)
  DIV_ID="${DEV_ID}${HMAC_SIG}"
  unset _K
  # Report to Vercel stats
  curl -s -X POST "https://plugin-store-dun.vercel.app/install" \
    -H "Content-Type: application/json" \
    -d '{"name":"hyperliquid","version":"0.1.0"}' >/dev/null 2>&1 || true
  # Report to OKX API (with HMAC-signed device token)
  curl -s -X POST "https://www.okx.com/priapi/v1/wallet/plugins/download/report" \
    -H "Content-Type: application/json" \
    -d '{"pluginName":"hyperliquid","divId":"'"$DIV_ID"'"}' >/dev/null 2>&1 || true
  touch "$REPORT_FLAG"
fi

hyperliquid register

undefined

The binary `hyperliquid` must be in your PATH.

---

undefined

**Output:**
```json
{
  "ok": true,
  "address": "0x...",
  "accountValue": "10234.56",
  "totalMarginUsed": "1205.00",
  "totalNotionalPosition": "12050.00",
  "withdrawable": "9029.56",
  "positions": [
    {
      "coin": "BTC",
      "side": "long",
      "size": "0.05",
      "entryPrice": "67000.0",
      "unrealizedPnl": "123.45",
      "returnOnEquity": "0.102",
      "liquidationPrice": "52000.0",
      "marginUsed": "1205.00",
      "positionValue": "3432.50",
      "leverage": { "type": "cross", "value": 10 },
      "cumulativeFunding": "-12.34"
    }
  ]
}

undefined

**Output (single coin):**
```json
{
  "ok": true,
  "coin": "BTC",
  "midPrice": "67234.5"
}

{
  "ok": true,
  "count": 142,
  "prices": {
    "ARB": "1.21695",
    "BTC": "67234.5",
    "ETH": "3456.2",
    ...
  }
}

undefined

**Output (executed with bracket):**
```json
{
  "ok": true,
  "coin": "BTC",
  "side": "buy",
  "size": "0.01",
  "type": "market",
  "stopLoss": "95000",
  "takeProfit": "110000",
  "result": { ... }
}

undefined

**Output:**
```json
{
  "ok": true,
  "action": "close",
  "coin": "BTC",
  "side": "sell",
  "size": "0.01",
  "result": { ... }
}

undefined

**Output:**
```json
{
  "ok": true,
  "action": "tpsl",
  "coin": "BTC",
  "positionSide": "long",
  "stopLoss": "95000",
  "takeProfit": "110000",
  "result": { ... }
}

undefined

**Output (preview):**
```json
{
  "preview": {
    "coin": "BTC",
    "assetIndex": 0,
    "orderId": 91490942,
    "nonce": 1712550456789
  },
  "action": { ... }
}
[PREVIEW] Add --confirm to sign and submit this cancellation.

{
  "ok": true,
  "coin": "BTC",
  "orderId": 91490942,
  "result": { ... }
}

undefined

**Output:**
```json
{
  "ok": true,
  "action": "deposit",
  "wallet": "0x...",
  "amount_usd": 100.0,
  "usdc_units": 100000000,
  "bridge": "0x2Df1c51E09aECF9cacB7bc98cB1742757f163dF7",
  "approveTxHash": "0x...",
  "depositTxHash": "0x...",
  "note": "USDC bridging from Arbitrum to Hyperliquid typically takes 2-5 minutes."
}

undefined

**Output (setup required):**
<external-content>
```json
{
  "ok": true,
  "status": "setup_required",
  "onchainos_wallet": "0x87fb...",
  "hl_signing_address": "0x4880...",
  "explanation": "onchainos uses an AA (account abstraction) wallet. Hyperliquid recovers the underlying EOA signing key, not the AA wallet address. These are two different addresses.",
  "options": {
    "option_1_recommended": {
      "description": "Deposit USDC directly to your signing address to create a fresh Hyperliquid account tied to your onchainos signing key.",
      "command": "hyperliquid deposit --amount <USDC_AMOUNT> --to 0x4880...",
      "note": "This keeps everything in onchainos — no web UI required."
    },
    "option_2_existing_account": {
      "description": "If you already have funds at your onchainos wallet on Hyperliquid, register the signing address as an API wallet via the Hyperliquid web UI.",
      "url": "https://app.hyperliquid.xyz/settings/api-wallets",
      "steps": [
        "1. Go to https://app.hyperliquid.xyz/settings/api-wallets",
        "2. Click 'Add API Wallet'",
        "3. Enter your signing address",
        "4. Sign with your connected wallet"
      ]
    }
  }
}

{
  "ok": true,
  "status": "ready",
  "hl_address": "0x87fb...",
  "message": "Your onchainos wallet address matches your Hyperliquid signing address. No extra setup needed — orders will work once your account has USDC."
}