Tradingbalthazar Hyperliquid MCP Server V9

🚀 Hyperliquid Automated Trading Server Complete Guide

Hyperliquid MCP (Market Control Panel) server is a powerful tool designed for interacting with the Hyperliquid exchange. It offers a wide range of features, enabling users to manage their trading activities effectively.

🚀 Quick Start

Prerequisites

• Ensure Node.js is installed on your system.

Starting the Server

Run the following command to start the server:

node hyperliquid-mcp-server-complete.js

✨ Features

• Market Data Tools: Retrieve real - time prices, order books, and historical data.
• Account Information Tools: View the balance and positions of trading accounts.
• Order Management Tools: Place, cancel, and modify orders.
• Position Management Tools: Adjust leverage and liquidate positions.
• Transfer and Withdrawal Tools: Handle USDC, peer - to - peer asset transfers, and cross - market transfers.
• Vault Management Tools: Create, view, and manage vaults.
• Sub - account Management Tools: Create and manage sub - accounts.

📦 Installation

Environment Variable Configuration

You can configure the server by setting the following environment variables:

• HYPERLIQUID_PRIVATE_KEY: Ethereum private key for authentication (required for trading).
• HYPERLIQUID_WALLET_ADDRESS: User wallet address (required for trading).
• HYPERLIQUID_VAULT_ADDRESS: Vault address (optional).
• HYPERLIQUID_TESTNET: Set to 'true' to use the testnet, 'false' to use the mainnet. The default is 'false'.
• LOG_LEVEL: Log level - available values are 'debug', 'info', 'warn', or 'error'. The default is 'info'.

Configuration File Configuration

Create a .hyperliquid-config.json file in the project directory with the following content:

{
  "privateKey": "your-ethereum-private-key",
  "walletAddress": "your-wallet-address",
  "vaultAddress": "your-vault-address",
  "testnet": false,
  "logLevel": "info",
  "popularCoins": ["BTC", "ETH", "SOL", "AVAX", "ARB", "DOGE", "LINK", "MATIC"]
}

💻 Usage Examples

Market Data Tools

• getMarketPrice: Get the current price of a specified cryptocurrency.
• getOrderBook: Get the current order book of a specified cryptocurrency.
• getCandleData: Get the historical candlestick data of a specified cryptocurrency.
• getAllMids: Get the mid - prices of all available cryptocurrencies.

Account Information Tools

• getAccountInfo: Get information about the user's perpetual futures account.
• getSpotAccountInfo: Get information about the user's spot trading account.
• getUserOpenOrders: Get all of the user's open orders.
• getUserFills: Get the user's recent trade fills.

Order Management Tools

• placeMarketOrder: Place a market order.
• placeLimitOrder: Place a limit order.
• placeTriggerOrder: Place a trigger order (stop - loss or take - profit).
• placeTwapOrder: Place a TWAP (Time - Weighted Average Price) order.
• cancelOrder: Cancel a specified order.
• cancelOrderByCloid: Cancel an order by the client order ID.
• cancelAllOrders: Cancel all orders.

Position Management Tools

• adjustPosition: Adjust the leverage of a position.
• liquidatePosition: Liquidate a position.

Transfer and Withdrawal Tools

• Handle USDC and peer - to - peer asset transfers, supporting fund allocation across markets and platforms.

Vault Management Tools

• manageVault: Create, view, and manage vaults.

Sub - account Management Tools

• manageSubAccounts: Create and manage sub - accounts.

📚 Documentation

Security Precautions

⚠️ Important Note

• Private Key Security: Ensure that your private key is not leaked. It is recommended to use encrypted storage.
• Testnet First: Conduct thorough testing on the testnet before operating in the production environment.
• Permission Control: Limit unnecessary operation permissions to avoid unauthorized access.

Disclaimer

Hyperliquid is not responsible for any direct or indirect losses arising from the use of this server. Users should assume all risks and ensure compliance with relevant laws and regulations.