This plugin enables interaction with the Hyperliquid DEX through Eliza, providing spot trading capabilities.
- 💱 Spot Trading
- Market orders (immediate execution)
- Limit orders (price-specific)
- Smart price validation to prevent mistakes
- 📊 Price Checking
- Real-time price information
- 24h price change
- Volume statistics
- 🔄 Order Management
- Cancel all open orders
- Clear feedback on execution
Add the plugin to your Eliza configuration:
{
"plugins": ["@elizaos/plugin-hyperliquid"]
}Set the following environment variables:
HYPERLIQUID_PRIVATE_KEY=your_private_key # Required for trading and cancelling orders
HYPERLIQUID_TESTNET=true_or_false # Optional, defaults to falsePlace spot market or limit orders.
Examples:
# Market Orders
"buy 1 PIP" -> Buys 1 PIP at market price
"sell 2 HYPE" -> Sells 2 HYPE at market price
"market buy 1 ETH" -> Buys 1 ETH at market price
# Limit Orders
"buy 1 PIP at 20 USDC" -> Places buy order for 1 PIP at 20 USDC
"sell 0.5 HYPE at 21 USDC" -> Places sell order for 0.5 HYPE at 21 USDC
Get current price information for any token.
Examples:
"What's the price of PIP?"
"Check HYPE price"
"Get ETH price"
Returns: Current price, 24h change, and volume.
Cancel all your open orders.
Examples:
"Cancel all orders"
"Cancel my orders"
The plugin includes smart price validation to prevent mistakes:
- Market Orders: Validates price is within ±50% of market price
- Limit Orders:
- Buy orders must be below market price
- Sell orders must be above market price
- Warns if price is very different from market (±80%)
The plugin provides clear error messages for common issues:
- Invalid token symbols
- Price validation failures
- Network connection issues
- Order execution failures
- Store your private key securely using environment variables
- Test with small amounts first
- Use testnet for initial testing
- Monitor your orders regularly
- Double-check prices before confirming trades
MIT