This guide provides a technical walkthrough for setting up Hyperliquid API Access to programmatically Trade on Hyperliquid. We will cover key generation and basic order placement on the purpose-built Hyperliquid L1 Blockchain.
Step 1: Understanding the Architecture
Hyperliquid is not a smart contract on Ethereum; it is a high-performance order book DEX built on its own Layer 1 blockchain. This architecture allows for CEX-like speed with DEX self-custody. All interactions are API calls to the L1 nodes.
Step 2: Generating API Keys
Security is paramount. Do not expose your primary wallet's private key.
Navigate to the Hyperliquid Exchange Official settings page.
Generate a new API key. This key will be tied to your trading account but does not grant withdrawal permissions by default.
Store your API secret securely. It will not be shown again.
This is a critical step in the Hyperliquid Security Model.
Step 3: Connecting to the API
You can interact with the API via Websocket or REST. For this example, we'll use a basic Python script with the official SDK.
python
Ensure you have the official hyperliquid-python-sdk installed
from hyperliquid.info import Info
from hyperliquid.exchange import Exchange
from hyperliquid.utils import *
Your wallet address and private key (use a dedicated burner wallet for trading)
address = "0x..."
private_key = "0x..."
info = Info(constants.MAINNET_API_URL, skip_ws=True)
exchange = Exchange(private_key, constants.MAINNET_API_URL)
Fetching user state
user_state = info.user_state(address)
print("User State:", user_state)
Placing a limit order
Ensure you know the correct asset name, e.g., "ETH"
asset = "ETH"
is_buy = True
limit_px = 3000.0
sz = 0.01
order_result = exchange.order(asset, is_buy, sz, limit_px)
print("Order Result:", order_result)
Step 4: Exploring Advanced Features
Beyond basic orders, the API allows for complex interactions, such as creating a Hyperliquid Vaults Strategy or querying the real-time Hyperliquid Fees Explained for your account tier.
For a complete overview of all endpoints and SDK functionality, refer to the Full Official Documentation.
Top comments (0)