Tradingbalthazar Hyperliquid MCP Server V9

The Hyperliquid MCP service is a comprehensive trading interface server that fully implements all the functions of the Hyperliquid exchange SDK, including trading in the spot and futures markets, account management, data transmission, etc., providing a complete solution for AI assistants to interact with the Hyperliquid exchange.

Finance Developer tools #Trading Interface #Asset Management #Market Data .JavaScript

rating : 2 points

downloads : 8

update time : 2025-04-28

What is the Hyperliquid MCP Server?

The Hyperliquid MCP Server is a comprehensive tool based on the Hyperliquid API, aiming to enable AI assistants to easily operate cryptocurrency trading through the Smart Contract Model Context Protocol (MCP). It provides a one-stop solution from market data acquisition to complex order execution.

How to use the Hyperliquid MCP Server?

Simply set up the API key and run the server to start using powerful trading functions. You can easily manage your trading account through simple command-line or API calls.

Applicable Scenarios

Suitable for professional investors who need to efficiently manage cryptocurrency portfolios, quantitative traders, and developers who want to build AI-driven investment strategies.

Main Features

Market Data AnalysisObtain real-time market prices, depth order books, and K-line chart data of cryptocurrencies.

Order ManagementSupports various trading types such as market orders, limit orders, and stop-loss orders.

Position ManagementUpdate leverage, adjust margin, and close positions with one click.

Vault ManagementCreate, transfer, and modify personal vault accounts.

Advantages and Limitations

Advantages

Fully supports spot and perpetual contract trading.

Flexible order type selection to meet diverse needs.

A secure and reliable private key authentication mechanism.

Multi-language support for international use.

Limitations

Requires a certain network environment to ensure a stable WebSocket connection.

Initial configuration may require a certain technical background.

Trading fees are relatively high. It is recommended to use during low-volatility periods.

How to Use

Install Dependencies

Ensure that the Node.js version is greater than 14 and clone the project repository.

Configure Environment Variables

Set `HYPERLIQUID_PRIVATE_KEY` and `HYPERLIQUID_WALLET_ADDRESS`.

Start the Server

Run the script to start the MCP server.

Usage Examples

Example 1: Get Market QuotesUse the getMarketPrice function to query the latest price of a certain currency.

Example 2: Execute a Limit BuyBuy a specific amount of cryptocurrency through the placeLimitOrder function.

Frequently Asked Questions

How to ensure trading security?

Does it support the testnet?

Related Resources

Hyperliquid Official Documentation

Detailed API interface description.

GitHub Code Repository

Open-source code examples and contribution guidelines.

YouTube Tutorial Video

Quick start guide.

🚀 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.