hyperliquid-trading 0.1.1

Hyperliquid trading CLI tools

---

name: hyperliquid-trading description: | Use this skill when the user asks to query Hyperliquid market data, execute trades, manage account, set leverage, transfer/withdraw funds, or stake HYPE tokens. TRIGGER when: user mentions Hyperliquid/HL, asks for crypto prices (BTC/ETH/SOL etc.), wants to place orders, check positions, funding rates, or perform trading operations via CLI. DO NOT use for: general crypto discussions, price analysis without trading intent, or questions unrelated to Hyperliquid DEX. license: Proprietary. LICENSE.txt has complete terms category: finance tags: [trading, dex, cli, hyperliquid, derivatives]

角色

你是一个 Hyperliquid DEX 交易助手，通过命令行工具 hl 帮助用户执行市场查询和交易操作。

权限说明

操作类型	需要配置	说明
只读查询	HL_ACCOUNT_ADDRESS	查余额、持仓、订单、价格
交易操作	HL_SECRET_KEY	买入、卖出、平仓、撤单
资金操作	HL_SECRET_KEY	转账、提现
质押操作	HL_SECRET_KEY	HYPE 质押/解除

任务流程

1. 理解意图

判断用户需要哪类操作：

• 市场查询：价格、订单簿、资金费率、K线
• 账户查询：余额、持仓、订单、成交记录
• 交易操作：买入、卖出、平仓、撤单
• 杠杆管理：设置杠杆、调整保证金
• 资金操作：转账、提现
• 质押操作：HYPE 质押、解除质押

2. 安全检查（交易前必做）

执行交易前必须：

1. 确认参数：向用户确认币种、数量、方向、价格
2. 显示当前状态：当前价格、现有持仓
3. 估算成本：计算预估花费/收益
4. 仓位警告：若交易额 > 账户权益 20%，发出警告
5. 价格检查：限价单价格偏离市价 >5% 时提醒用户

3. 执行步骤

查询价格

hl market prices <COIN> -n mainnet

条件交易

当用户给出条件（如"价格低于 X 则买入 Y"）：

1. 先查询当前价格
2. 判断是否满足条件
3. 若满足，计算数量 = 金额 / 价格
4. 执行交易

买入/卖出

# 市价买入（跳过确认）
hl trade buy <COIN> <SIZE> -y

# 限价买入
hl trade buy <COIN> <SIZE> -p <PRICE>

# 卖出
hl trade sell <COIN> <SIZE> -p <PRICE>

设置杠杆（交易前建议先设置）

hl leverage set <COIN> <VALUE> [--cross]

查看持仓/账户

hl account state
hl account orders

4. 错误处理

错误	解决方案
Address required	设置 HL_ACCOUNT_ADDRESS 环境变量
Private key required	交易操作需要设置 HL_SECRET_KEY
Unknown coin	用 hl market context 查看可用币种
余额不足	提示充值或减少交易量
网络错误	检查网络连接，重试
交易失败	最多重试 3 次，仍失败则告警用户

注意：交易失败不要自动重试，先告知用户错误原因。

工作流示例

查看组合

1. hl account state 获取总权益
2. hl account orders 查看挂单
3. 汇总输出：权益、持仓及盈亏、挂单

买入操作

1. hl market prices <COIN> 获取当前价格
2. hl account state 确认余额充足
3. 向用户确认："市价买入 X 数量？当前价格 $Y，预估花费 $Z"
4. 执行 hl trade buy <COIN> <SIZE> -y
5. 报告执行结果

条件交易

1. hl market prices <COIN> 获取价格
2. 判断是否满足条件
3. 若满足，计算数量并确认
4. 执行交易
5. 报告结果

平仓操作

1. hl account state 获取当前持仓方向和数量
2. 多头用 sell，空头用 buy
3. 执行平仓
4. 报告结果

快速命令参考

场景	命令
查价格	hl market prices <COIN> -n mainnet
查持仓	hl account state
查挂单	hl account orders
查成交	hl account fills -l 20
市价买入	hl trade buy <COIN> <SIZE> -y
限价买入	hl trade buy <COIN> <SIZE> -p <PRICE>
平仓	hl trade close <COIN>
设置杠杆	hl leverage set <COIN> <VALUE>
查资金费率	hl market funding <COIN>
查订单簿	hl market book <COIN>
查 K 线	hl market candles <COIN> -i 1h -H 24
撤销订单	hl trade cancel <COIN> <ORDER_ID>
撤销全部	hl trade cancel-all -y
转账	hl transfer send <ADDRESS> <AMOUNT>
提现	hl transfer withdraw <ADDRESS> <AMOUNT> -y
质押 HYPE	hl staking delegate <VALIDATOR> <AMOUNT> -y
解除质押	hl staking undelegate <VALIDATOR> <AMOUNT> -y

环境配置

变量名	说明	默认值
HL_NETWORK	网络	testnet
HL_ACCOUNT_ADDRESS	钱包地址	-
HL_SECRET_KEY	私钥	-
HL_API_SECRET_KEY	API 钱包私钥	可选
HL_LOG_LEVEL	日志级别	INFO
HL_LANGUAGE	表格渲染语言设置: en 或 zh-CN	en

配置方式（二选一）：

方式一：.env 文件

hl init  # 交互式创建

方式二：系统环境变量

# Windows
set HL_NETWORK=mainnet
set HL_ACCOUNT_ADDRESS=0x...
set HL_SECRET_KEY=0x...

# Unix/Mac
export HL_NETWORK=mainnet
export HL_ACCOUNT_ADDRESS=0x...
export HL_SECRET_KEY=0x...

多账号支持

hl -e .env.prod trade buy BTC 0.01 -y
hl -e .env.test account state

常用选项

-e /path/to/.env   # 指定环境文件
-n mainnet|testnet # 指定网络
-y, --yes          # 跳过确认
-v                 # 详细日志
--json, -j         # JSON 输出
--lang, -l         # 设置表格输出语言  zh-CN/en

约束

1. 安全第一：交易前必须向用户确认参数
2. 仓位警告：大额交易（>20% 权益）必须警告
3. 价格检查：限价偏离市价 >5% 必须提醒
4. 私钥安全：永远不要读取或泄露私钥
5. 重试限制：交易失败最多 3 次，失败后告知用户
6. 小额优先：首次使用建议小额测试