Hyperliquid 超流体自动交易服务器完整指南

1. 功能概述

Hyperliquid MCP（市场控制面板）服务器是一个强大的工具，用于与Hyperliquid交易所进行交互。它提供了丰富的功能，包括：

• 市场数据工具：获取实时价格、订单簿和历史数据。
• 账户信息工具：查看交易账户的余额和头寸。
• 订单管理工具：下单、取消订单及修改订单。
• 位置管理工具：调整杠杆率和平仓操作。
• 转移与提款工具：处理USDC、点对点资产和跨市场转移。
• 保险库管理工具：创建、查看和管理保险库。
• 子账户管理工具：创建和管理子账户。

2. 配置指南

环境变量配置

可以通过设置以下环境变量来配置服务器：

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

3. 启动服务器

运行以下命令即可启动服务器：

node hyperliquid-mcp-server-complete.js

4. 可用工具

市场数据工具

• getMarketPrice：获取指定加密货币的当前价格。
• getOrderBook：获取指定加密货币的当前订单簿。
• getCandleData：获取指定加密货币的历史烛台数据。
• getAllMids：获取所有可用加密货币的中间价。

账户信息工具

• getAccountInfo：获取用户永续期货账户的信息。
• getSpotAccountInfo：获取用户的现货交易账户信息。
• getUserOpenOrders：获取用户的所有未成交订单。
• getUserFills：获取用户的最近成交记录。

订单管理工具

• placeMarketOrder：下单市价单。
• placeLimitOrder：下单限价单。
• placeTriggerOrder：下单触发单（止损或止盈）。
• placeTwapOrder：下单TWAP（时间加权平均价格）订单。
• cancelOrder：取消指定订单。
• cancelOrderByCloid：通过客户订单ID取消订单。
• cancelAllOrders：取消所有订单。

位置管理工具

• adjustPosition：调整头寸的杠杆率。
• liquidatePosition：平仓操作。

转移与提款工具

• 处理USDC和点对点资产转移，支持跨市场和平台之间的资金调配。

保险库管理工具

• manageVault：创建、查看和管理保险库。

子账户管理工具

• manageSubAccounts：创建和管理子账户。

5. 安全注意事项

• 私钥安全：确保私钥不被泄露，建议使用加密存储。
• 测试网优先：在正式环境中操作前，先在测试网进行充分测试。
• 权限控制：限制不必要的操作权限，避免未授权访问。

6. 免责声明

Hyperliquid 对因使用此服务器而产生的任何直接或间接损失不承担责任。用户应自行承担所有风险，并确保遵守相关法律法规。

通过以上配置和工具，您可以轻松实现与Hyperliquid交易所的自动化交互，提升交易效率和管理能力。