Hyperliquid MCP Server - Complete Implementation

Hyperliquid MCP Server - Complete Implementation

site icon
2025.04.11 0
JavaScript交易服务市场数据资金管理金融服务
Hyperliquid MCP Server 是一个围绕 Hyperliquid SDK 的全面封装服务,为 AI 助手提供了完整的现货和期货市场交易能力。它使 AI 助手能够与 Hyperliquid 交易所交互,获取市场数据、执行交易、管理仓位等。
View on GitHub

Overview

基本能力

产品定位

Hyperliquid MCP Server 是一个为 AI 助手设计的交易接口服务,提供与 Hyperliquid 交易所的全面交互能力。

核心功能

  • 全面的 API 覆盖:包括市场数据获取、订单管理、仓位管理、账户信息、资金转移、金库管理、子账户管理等。
  • 技术特性:支持私钥和钱包地址认证、实时市场数据访问、客户端订单 ID 跟踪、测试网和主网支持。

适用场景

  • AI 助手驱动的自动化交易
  • 市场数据分析和监控
  • 高频交易和算法交易
  • 资金管理和仓位调整

工具列表

  • 市场数据工具getMarketPrice, getOrderBook, getCandleData, getAllMids
  • 账户信息工具getAccountInfo, getSpotAccountInfo, getUserOpenOrders, getUserFills
  • 订单管理工具placeMarketOrder, placeLimitOrder, placeTriggerOrder, placeTwapOrder
  • 仓位管理工具updateLeverage, updateIsolatedMargin, closePosition, closeAllPositions
  • 资金转移工具usdTransfer, initiateWithdrawal, spotTransfer, transferBetweenSpotAndPerp
  • 金库管理工具createVault, getVaultDetails, vaultTransfer, vaultDistribute
  • 子账户管理工具createSubAccount, getSubAccounts, subAccountTransfer, subAccountSpotTransfer

常见问题解答

  • 私钥安全:私钥提供对资金的完全访问权限,切勿公开或共享。
  • 测试网使用:建议先在测试网上测试配置,再使用主网资金。
  • 访问限制:仅限受信任的 AI 助手和应用程序访问 MCP 服务器。

使用教程

使用依赖

  • Node.js (v14 或更高版本)
  • Hyperliquid 账户
  • 以太坊私钥(用于交易认证)
  • 钱包地址(用于交易)

安装教程

  1. 配置环境变量或创建 .hyperliquid-config.json 文件。
  2. 启动服务器:
node hyperliquid-mcp-server-complete.js

调试方式

  • 使用 LOG_LEVEL 环境变量设置日志级别(如 debug, info, warn, error)。
  • 检查服务器日志以获取操作和错误信息。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。