Hyperliquid交易技能

为Hyperliquid永续期货交易所提供完整的交易和投资组合管理。

先决条件

一次性安装依赖项：

cd skills/hyperliquid/scripts && npm install

身份验证

对于只读操作（余额、持仓、价格）：

• 设置HYPERLIQUID_ADDRESS环境变量
• 无需私钥

对于交易操作：

• 设置HYPERLIQUID_PRIVATE_KEY环境变量
• 地址将自动从私钥派生

测试网：

• 设置HYPERLIQUID_TESTNET=1以使用测试网

核心操作

投资组合监控

检查余额：

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs balance

查看带盈亏的持仓：

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs positions

检查未成交订单：

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs orders

查看交易历史：

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs fills

获取代币价格：

node scripts/hyperliquid.mjs price BTC

交易操作

所有交易命令都需要HYPERLIQUID_PRIVATE_KEY。

下达限价订单：

# Buy 0.1 BTC at $45,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs buy BTC 0.1 45000

# Sell 1 ETH at $3,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs sell ETH 1 3000

市价订单（带5%滑点保护）：

# Market buy 0.5 BTC
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-buy BTC 0.5

# Market sell 2 ETH
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-sell ETH 2

取消订单：

# Cancel specific order
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel BTC 12345

# Cancel all orders
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all

# Cancel all orders for specific coin
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all BTC

输出格式

所有命令输出JSON格式。解析并格式化以在聊天界面显示：

对于余额/投资组合：

• 显示总权益、可用余额
• 列出持仓，包括仓位大小、入场价格、未实现盈亏
• 总结未成交订单

对于交易执行：

• 执行前确认订单详情
• 执行后报告订单ID和状态
• 若立即成交，显示成交价格

安全指南

在执行交易前：

1. 向用户确认交易参数（币种、数量、方向、价格）
2. 展示当前价格和持仓情况作为参考
3. 计算预估成本/收益

仓位规模管理：

• 若交易量超过账户权益20%则发出警告
• 根据账户余额建议合适的交易规模

价格检查：

• 对于限价单，将限价与当前市价进行比较
• 若限价偏离市价超过5%则发出警告（可能是错误）

错误处理

常见错误：

• "需要地址" → 设置HYPERLIQUID_ADDRESS或HYPERLIQUID_PRIVATE_KEY
• "需要私钥" → 交易需要HYPERLIQUID_PRIVATE_KEY
• "未知币种" → 通过meta命令检查可用币种
• HTTP错误 → 检查网络连接和API状态

发生错误时：

• 向用户显示错误信息
• 建议修复（设置环境变量，检查币种名称，验证余额）
• 不要自动重试交易

工作流示例

“我的Hyperliquid投资组合情况如何？”

1. 运行balance以获取总资产
2. 运行positions以获取未平仓头寸
3. 摘要格式：资产、包含盈亏的头寸、总未实现盈亏

“在Hyperliquid上买入0.5 BTC”

1. 运行price BTC以获取当前价格
2. 运行balance以验证资金是否充足
3. 与用户确认：“以市价买入0.5 BTC？当前价格：$X。预估成本：$Y”
4. 执行market-buy BTC 0.5
5. 报告订单结果

“Hyperliquid上当前的BTC价格是多少？”

1. 运行BTC价格
2. 响应格式："BTC: $X on Hyperliquid"

"平掉我的ETH仓位"

1. 运行仓位以获取当前ETH仓位大小
2. 若为多头 → 市价卖出，若为空头 → 市价买入
3. 按仓位大小执行
4. 报告结果

高级功能

列出所有可用币种：

node scripts/hyperliquid.mjs meta

查询其他地址：

# Check someone else's positions (read-only, public data)
node scripts/hyperliquid.mjs positions 0x1234...

注意事项

• 所有仓位大小均以基础货币为单位（BTC、ETH等）
• 价格单位为美元
• 市价单使用带有5%滑点保护的限价单
• Hyperliquid使用永续期货合约，而非现货交易
• 完整API文档请查阅 references/api.md