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