Tradingbalthazar Hyperliquid MCP Server V9

🚀 Hyperliquid超流體自動交易服務器完整指南

本指南將詳細介紹Hyperliquid MCP（市場控制面板）服務器，它是一個強大的工具，可用於與Hyperliquid交易所進行交互，能顯著提升交易效率和管理能力。

🚀 快速開始

要啟動Hyperliquid MCP服務器，您需要完成環境配置並運行啟動命令。

環境變量配置

可以通過設置以下環境變量來配置服務器：

• HYPERLIQUID_PRIVATE_KEY：用於身份驗證的以太坊私鑰（交易必需）。
• HYPERLIQUID_WALLET_ADDRESS：用戶錢包地址（交易必需）。
• HYPERLIQUID_VAULT_ADDRESS：保險庫地址（可選）。
• HYPERLIQUID_TESTNET：設置為 'true' 使用測試網， 'false' 使用主網，默認為 'false'。
• LOG_LEVEL：日誌級別 - 可選值為 'debug', 'info', 'warn', 或 'error'，默認為 'info'。

配置文件配置

可以在項目目錄中創建一個 .hyperliquid-config.json 文件，內容如下：

{
  "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"]
}

啟動服務器

運行以下命令即可啟動服務器：

node hyperliquid-mcp-server-complete.js

✨ 主要特性

Hyperliquid MCP服務器提供了豐富的功能，涵蓋市場數據、賬戶信息、訂單管理等多個方面：

• 市場數據工具：獲取即時價格、訂單簿和歷史數據。
• 賬戶信息工具：查看交易賬戶的餘額和頭寸。
• 訂單管理工具：下單、取消訂單及修改訂單。
• 位置管理工具：調整槓桿率和平倉操作。
• 轉移與提款工具：處理USDC、點對點資產和跨市場轉移。
• 保險庫管理工具：創建、查看和管理保險庫。
• 子賬戶管理工具：創建和管理子賬戶。

💻 使用示例

基礎用法

以下是一些使用服務器工具的基礎示例：

// 獲取指定加密貨幣的當前價格
const marketPrice = await getMarketPrice('BTC');
console.log(marketPrice);

// 獲取用戶永續期貨賬戶的信息
const accountInfo = await getAccountInfo();
console.log(accountInfo);

高級用法

在處理複雜交易場景時，可以組合使用多個工具：

// 下單市價單並調整頭寸槓桿率
await placeMarketOrder('ETH', 'buy', 1);
await adjustPosition('ETH', 5);

📚 詳細文檔

可用工具

市場數據工具

• getMarketPrice：獲取指定加密貨幣的當前價格。
• getOrderBook：獲取指定加密貨幣的當前訂單簿。
• getCandleData：獲取指定加密貨幣的歷史燭臺數據。
• getAllMids：獲取所有可用加密貨幣的中間價。

賬戶信息工具

• getAccountInfo：獲取用戶永續期貨賬戶的信息。
• getSpotAccountInfo：獲取用戶的現貨交易賬戶信息。
• getUserOpenOrders：獲取用戶的所有未成交訂單。
• getUserFills：獲取用戶的最近成交記錄。

訂單管理工具

• placeMarketOrder：下單市價單。
• placeLimitOrder：下單限價單。
• placeTriggerOrder：下單觸發單（止損或止盈）。
• placeTwapOrder：下單TWAP（時間加權平均價格）訂單。
• cancelOrder：取消指定訂單。
• cancelOrderByCloid：通過客戶訂單ID取消訂單。
• cancelAllOrders：取消所有訂單。

位置管理工具

• adjustPosition：調整頭寸的槓桿率。
• liquidatePosition：平倉操作。

轉移與提款工具

• 處理USDC和點對點資產轉移，支持跨市場和平臺之間的資金調配。

保險庫管理工具

• manageVault：創建、查看和管理保險庫。

子賬戶管理工具

• manageSubAccounts：創建和管理子賬戶。

🔧 技術細節

Hyperliquid MCP服務器通過與Hyperliquid交易所的API進行交互，實現了各種功能。它使用以太坊私鑰進行身份驗證，確保交易的安全性。通過設置環境變量或配置文件，可以靈活地配置服務器的運行環境，包括使用測試網或主網、日誌級別等。

⚠️ 重要提示

• 私鑰安全：確保私鑰不被洩露，建議使用加密存儲。
• 測試網優先：在正式環境中操作前，先在測試網進行充分測試。
• 權限控制：限制不必要的操作權限，避免未授權訪問。

📄 免責聲明

Hyperliquid對因使用此服務器而產生的任何直接或間接損失不承擔責任。用戶應自行承擔所有風險，並確保遵守相關法律法規。

通過以上配置和工具，您可以輕鬆實現與Hyperliquid交易所的自動化交互，提升交易效率和管理能力。