hyperliquid

Trade perpetual futures on Hyperliquid via signed REST and WebSocket APIs.

6|20|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/andresdefi/cryptoskills --skill hyperliquid-andresdefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperliquid
Source: https://github.com/andresdefi/cryptoskills/tree/main/skills/hyperliquid
Command: npx skills add https://github.com/andresdefi/cryptoskills --skill hyperliquid-andresdefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? LLMs have stale or incorrect knowledge about the Hyperliquid API — wrong chain IDs for EIP-712 signing, numeric instead of string price formats, hardcoded asset indices, and assumed API-key authentication — causing failed orders, signature errors, and lost debugging time when building trading integrations. ## Core Features & Use Cases - Order Execution: Place limit, market, trigger (TP/SL), TWAP, and batch orders with correct EIP-712 phantom-agent signing, plus cancel by OID or client order ID. - Position & Account Management: Set cross/isolated leverage, adjust isolated margin, monitor liquidation prices, manage subaccounts, and deposit into vaults. - Real-Time Data Streaming: Subscribe to trades, L2 orderbook, candles, user fills, and position updates over WebSocket with reconnection and REST backfill patterns. - Use Case: Build a grid trading bot that places layered orders around mid price, monitors fills via WebSocket, replaces filled orders, and protects itself with a dead man's switch schedule-cancel heartbeat. ## Quick Start Use the hyperliquid skill to place a 0.1 ETH limit buy order at $3000 with the Python SDK and show me my open positions.

Frequently Asked Questions about hyperliquid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place an order on Hyperliquid with Python?

Install hyperliquid-python-sdk, create an Exchange instance with your wallet, and call exchange.order with the coin name, side, size, limit price, and order type. Use exchange.market_open for market orders with a slippage tolerance.

How does Hyperliquid API authentication work without API keys?

Hyperliquid uses EIP-712 wallet signatures instead of API keys. L1 trading actions sign with chain ID 1337 using a phantom agent scheme, while account actions like withdrawals use chain ID 421614. Agent wallets can be approved for automated trading.

Why does Hyperliquid return 'User or API Wallet does not exist'?

This error means the EIP-712 signature recovered a different address than expected, usually from using the wrong chain ID, incorrect msgpack field ordering, or float instead of string precision. Use the official SDK's signing methods and ensure the wallet has deposited USDC.

Does the Hyperliquid WebSocket reconnect automatically?

No, WebSocket connections do not auto-reconnect and missed messages are not replayed. Implement reconnection with exponential backoff and backfill state via the Info REST API endpoints like clearinghouseState after reconnecting.

What is the minimum order size on Hyperliquid?

Perpetual orders require a minimum notional value of $10, and spot orders require 10 units of the quote token. Orders below this threshold are rejected with a MinTradeNtl error.

Is the official Hyperliquid Python SDK asynchronous?

No, the official hyperliquid-python-sdk is synchronous and uses requests under the hood. For async workloads, use a community SDK or build your own client with aiohttp.