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交易所的自动化交互，提升交易效率和管理能力。