Hyperliquid

Hyperliquid is a decentralized perpetual futures exchange built on its own L1 blockchain. Unlike centralized exchanges, Hyperliquid uses on-chain order books and wallet-based authentication.

Creating an Agent Wallet

Hyperliquid uses a wallet-based agent pattern instead of traditional API keys. You'll generate an agent wallet that Crodl uses to trade on your behalf.

Step 1: Connect Your Wallet

Go to app.hyperliquid.xyz and connect your Web3 wallet (MetaMask, etc.).

Step 2: Navigate to API Section

Click on your wallet address in the top right, then select "API" from the menu.

You can also go directly to app.hyperliquid.xyz/API.

Step 3: Generate Agent Wallet

Click "Generate API Wallet". This creates a new agent wallet that can trade on your behalf.

Step 4: Approve the Agent

Sign the approval transaction in your Web3 wallet. This authorizes the agent to trade using your funds.

Step 5: Copy Wallet Details

Copy your Master Address (your main wallet), Agent Address, and Agent Private Key.

Step 6: Store Securely

Save the agent private key securely. If lost, you will need to generate a new agent wallet.

Your agent private key is sensitive. The agent wallet pattern lets you delegate trading authority without exposing your master wallet's private key. Never share your master wallet's private key with anyone.

Test on testnet first at app.hyperliquid-testnet.xyz before using real funds. You can revoke agent access anytime from the Hyperliquid UI.

Adding to Crodl

Go to Settings → API Keys
Select the Hyperliquid tab
Enter a Label for this connection
Enter your Master Address (your main 0x... wallet address)
Enter your Agent Address (the 0x... agent wallet address)
Enter your Agent Private Key
Select your Mode — Live or Testnet
Click Add API Key
Click Verify on the new key to test the connection

Your agent address must be approved on Hyperliquid before it will validate in Crodl. Make sure you completed the approval step above.

Features

Decentralized Trading

No KYC required
Self-custody of funds
On-chain order settlement
Transparent fee structure

Order Types

Market orders — Execute at current price
Limit orders — Execute at specified price
Trigger orders — Conditional execution

Position Mode

Hyperliquid supports one-way mode only — a single net position per symbol. Hedge mode (holding long and short simultaneously) is not supported; orders requesting hedge mode are rejected with a position_mode_unsupported error.

Data Available

Real-time positions and PnL
Open orders
Account balance and margin
Trade history

Data Refresh

Hyperliquid data refreshes on the same cadence as the centralized exchanges:

Refresh interval: every 30 seconds
Automatic backoff on errors
Request deduplication

Differences from CEX

Feature	CEX (Blofin, etc.)	Hyperliquid
Custody	Exchange-held	Self-custody
KYC	Required	Not required
API Auth	API Key + Secret	Master + Agent wallet
Settlement	Off-chain	On-chain
Position modes	One-way / hedge (varies)	One-way only
Modes	live / demo	live / testnet

Troubleshooting

Ensure your master address and agent address are valid Ethereum addresses (0x...)
Verify the agent private key matches the agent address
Confirm the agent wallet was approved on Hyperliquid
Check that you have sufficient margin in your Hyperliquid account
Make sure you selected the correct mode (live vs testnet)
See Common Issues for general help

OKX

Overview