Hyperliquid

tradectl supports Hyperliquid perpetuals via the on-chain order interface.

Supported features

• Real-time WebSocket market data (ticker + trades)
• Market and limit orders
• TP / SL via ExitOrder (translated to Hyperliquid trigger orders)
• On-chain settlement
• No KYC required

API wallet setup

Hyperliquid uses wallet-based authentication. tradectl signs orders with an API wallet (a sub-key of your main account), not your main wallet's private key.

1. Open the Hyperliquid web UI → More → API
2. Generate a new API wallet — Hyperliquid returns the wallet address and a private key
3. Authorize the API wallet on-chain (one-time signature with your main wallet)
4. In tradectl, use the API wallet address as the API key and its private key as the secret

WARNING

Treat the API wallet's private key like any exchange secret. tradectl encrypts it with AES-256-GCM at rest and only decrypts it in memory at runtime.

Configuration

{
  "api": { "provider": "Hyperliquid", "key": "<wallet-address>", "secret": "<private-key>" },
  "strats": [{
    "name": "btc-perp",
    "type": "shot",
    "marketType": "LINEAR",
    "isEmulator": false,
    "pairs": ["BTC", "ETH"],
    "leverage": 5
  }]
}

Notes

• Hyperliquid uses bare-coin symbol names (BTC, ETH) — no USDT suffix.
• Fees are typically lower than CEX alternatives, and there are no funding payments visible in the API for some assets.
• All settlement happens on-chain — fills can take a fraction of a second longer to confirm than a CEX.