Files
nofx/trader/hyperliquid_trader.go
ZhouYongyou fe8ba6ac34 fix(hyperliquid): query both Spot and Perpetuals balance to resolve "0 balance" false reports
## Problem Analysis

PR #443 fixed Withdrawable field priority, but users still reported "wallet has funds but shows 0".

**Root Cause**: Hyperliquid has TWO separate account systems:
1. **Spot Account** (現貨帳戶) - holds USDC/tokens
2. **Perpetuals Account** (合約帳戶) - for futures trading

Previous implementation ONLY queried Perpetuals (`UserState`), completely missing Spot balance.

## Real-World Scenario

User's actual account state:
- Spot Account: 100 USDC  (not detected before)
- Perpetuals: 0 USDC
- **Old display**: 0.00 USDC 
- **New display**: 100.00 USDC 

## Solution Implemented

### 1. Query Both Accounts
```go
// Step 1: Query Spot balance (SpotUserState)
spotState := exchange.Info().SpotUserState(ctx, walletAddr)
spotUSDCBalance := spotState.Balances[USDC].Total

// Step 2: Query Perpetuals balance (UserState)
accountState := exchange.Info().UserState(ctx, walletAddr)
perpetualsValue := accountState.MarginSummary.AccountValue

// Step 3: Combine both
totalBalance = spotUSDCBalance + perpetualsValue
```

### 2. Enhanced Logging
New log format shows separate breakdowns:
```
✓ Hyperliquid 账户总览:
  • Spot 现货余额: 100.00 USDC
  • Perpetuals 合约净值: 0.00 USDC
  • Perpetuals 可用余额: 0.00 USDC
  • 保证金占用: 0.00 USDC
   总净值: 100.00 USDC | 总可用: 100.00 USDC
```

### 3. Backward Compatibility
- If SpotUserState fails (API error), continues with Perpetuals only
- Logs warning instead of failing completely
- Maintains same return structure for auto_trader.go

## Technical Details

**API Endpoints Used**:
- `Info.SpotUserState(ctx, address)` → returns `SpotUserState{Balances[]}`
- `Info.UserState(ctx, address)` → returns perpetuals state

**Balance Fields**:
- `SpotBalance.Total` - total USDC in spot (includes held + free)
- `SpotBalance.Hold` - amount locked in spot orders
- Combined with existing Perpetuals logic

## Impact

**Before**: Users with Spot-only funds saw 0 balance → couldn't trade
**After**: Correctly shows Spot + Perpetuals combined balance

Closes false "insufficient balance" reports when funds exist in Spot account.

## References

- Hyperliquid API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot
- Related: PR #443 (Withdrawable field priority)
- SDK: github.com/sonirico/go-hyperliquid v0.17.0

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-05 03:08:35 +08:00

795 lines
24 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

package trader
import (
"context"
"encoding/json"
"fmt"
"log"
"strconv"
"github.com/ethereum/go-ethereum/crypto"
"github.com/sonirico/go-hyperliquid"
)
// HyperliquidTrader Hyperliquid交易器
type HyperliquidTrader struct {
exchange *hyperliquid.Exchange
ctx context.Context
walletAddr string
meta *hyperliquid.Meta // 缓存meta信息包含精度等
isCrossMargin bool // 是否为全仓模式
}
// NewHyperliquidTrader 创建Hyperliquid交易器
func NewHyperliquidTrader(privateKeyHex string, walletAddr string, testnet bool) (*HyperliquidTrader, error) {
// 解析私钥
privateKey, err := crypto.HexToECDSA(privateKeyHex)
if err != nil {
return nil, fmt.Errorf("解析私钥失败: %w", err)
}
// 选择API URL
apiURL := hyperliquid.MainnetAPIURL
if testnet {
apiURL = hyperliquid.TestnetAPIURL
}
// // 从私钥生成钱包地址
// pubKey := privateKey.Public()
// publicKeyECDSA, ok := pubKey.(*ecdsa.PublicKey)
// if !ok {
// return nil, fmt.Errorf("无法转换公钥")
// }
// walletAddr := crypto.PubkeyToAddress(*publicKeyECDSA).Hex()
ctx := context.Background()
// 创建Exchange客户端Exchange包含Info功能
exchange := hyperliquid.NewExchange(
ctx,
privateKey,
apiURL,
nil, // Meta will be fetched automatically
"", // vault address (empty for personal account)
walletAddr, // wallet address
nil, // SpotMeta will be fetched automatically
)
log.Printf("✓ Hyperliquid交易器初始化成功 (testnet=%v, wallet=%s)", testnet, walletAddr)
// 获取meta信息包含精度等配置
meta, err := exchange.Info().Meta(ctx)
if err != nil {
return nil, fmt.Errorf("获取meta信息失败: %w", err)
}
return &HyperliquidTrader{
exchange: exchange,
ctx: ctx,
walletAddr: walletAddr,
meta: meta,
isCrossMargin: true, // 默认使用全仓模式
}, nil
}
// GetBalance 获取账户余额(同时查询 Spot 和 Perpetuals
func (t *HyperliquidTrader) GetBalance() (map[string]interface{}, error) {
log.Printf("🔄 正在调用Hyperliquid API获取账户余额...")
// ✅ 第一步:查询 Spot 现货余额(用户的 USDC/USDT 可能在这里)
spotState, err := t.exchange.Info().SpotUserState(t.ctx, t.walletAddr)
var spotUSDCBalance float64 = 0.0
if err != nil {
log.Printf("⚠️ 查询 Spot 余额失败(可能无现货资产): %v", err)
} else if spotState != nil && len(spotState.Balances) > 0 {
// 查找 USDC 余额Hyperliquid 现货主要使用 USDC
for _, balance := range spotState.Balances {
if balance.Coin == "USDC" {
spotUSDCBalance, _ = strconv.ParseFloat(balance.Total, 64)
log.Printf("✓ 发现 Spot 现货余额: %.2f USDC", spotUSDCBalance)
break
}
}
}
// ✅ 第二步:查询 Perpetuals 合约余额
accountState, err := t.exchange.Info().UserState(t.ctx, t.walletAddr)
if err != nil {
log.Printf("❌ Hyperliquid Perpetuals API调用失败: %v", err)
return nil, fmt.Errorf("获取账户信息失败: %w", err)
}
// 解析余额信息MarginSummary字段都是string
result := make(map[string]interface{})
// 🔍 调试打印API返回的完整CrossMarginSummary结构
summaryJSON, _ := json.MarshalIndent(accountState.MarginSummary, " ", " ")
log.Printf("🔍 [DEBUG] Hyperliquid Perpetuals CrossMarginSummary完整数据:")
log.Printf("%s", string(summaryJSON))
accountValue, _ := strconv.ParseFloat(accountState.MarginSummary.AccountValue, 64)
totalMarginUsed, _ := strconv.ParseFloat(accountState.MarginSummary.TotalMarginUsed, 64)
// ⚠️ 关键修复:将 Spot 现货余额加入总余额
accountValue += spotUSDCBalance
// ⚠️ 关键修复:从所有持仓中累加真正的未实现盈亏
totalUnrealizedPnl := 0.0
for _, assetPos := range accountState.AssetPositions {
unrealizedPnl, _ := strconv.ParseFloat(assetPos.Position.UnrealizedPnl, 64)
totalUnrealizedPnl += unrealizedPnl
}
// ✅ 正确理解Hyperliquid字段
// AccountValue = 总账户净值(已包含空闲资金+持仓价值+未实现盈亏)
// TotalMarginUsed = 持仓占用的保证金已包含在AccountValue中仅用于显示
//
// 为了兼容auto_trader.go的计算逻辑totalEquity = totalWalletBalance + totalUnrealizedProfit
// 需要返回"不包含未实现盈亏的钱包余额"
walletBalanceWithoutUnrealized := accountValue - totalUnrealizedPnl
// ⚠️ 优先使用Withdrawable字段Hyperliquid API返回的真实可用余额
availableBalance := 0.0
if accountState.Withdrawable != "" {
withdrawable, err := strconv.ParseFloat(accountState.Withdrawable, 64)
if err == nil {
availableBalance = withdrawable
log.Printf("✓ 使用Hyperliquid API的Withdrawable字段: %.2f USDT", availableBalance)
} else {
log.Printf("⚠️ 解析Withdrawable字段失败: %v将使用计算值", err)
}
}
// 后备方案如果Withdrawable不可用使用计算值确保不为负数
if availableBalance == 0 && accountState.Withdrawable == "" {
availableBalance = accountValue - totalMarginUsed
if availableBalance < 0 {
log.Printf("⚠️ [Hyperliquid] 计算的可用余额为负 (%.2f - %.2f = %.2f)已调整为0。",
accountValue, totalMarginUsed, availableBalance)
log.Printf(" 提示这可能是因为Hyperliquid的TotalMarginUsed计算方式不同或持仓处于高风险状态")
availableBalance = 0
}
}
// ✅ 可用余额 = Spot 现货余额 + Perpetuals 可用余额
totalAvailableBalance := spotUSDCBalance + availableBalance
result["totalWalletBalance"] = walletBalanceWithoutUnrealized // 钱包余额(不含未实现盈亏)
result["availableBalance"] = totalAvailableBalance // 总可用余额Spot + Perpetuals
result["totalUnrealizedProfit"] = totalUnrealizedPnl // 未实现盈亏
log.Printf("✓ Hyperliquid 账户总览:")
log.Printf(" • Spot 现货余额: %.2f USDC", spotUSDCBalance)
log.Printf(" • Perpetuals 合约净值: %.2f USDC (钱包%.2f + 未实现%.2f)",
accountValue-spotUSDCBalance,
walletBalanceWithoutUnrealized-spotUSDCBalance,
totalUnrealizedPnl)
log.Printf(" • Perpetuals 可用余额: %.2f USDC", availableBalance)
log.Printf(" • 保证金占用: %.2f USDC", totalMarginUsed)
log.Printf(" ⭐ 总净值: %.2f USDC | 总可用: %.2f USDC", accountValue, totalAvailableBalance)
return result, nil
}
// GetPositions 获取所有持仓
func (t *HyperliquidTrader) GetPositions() ([]map[string]interface{}, error) {
// 获取账户状态
accountState, err := t.exchange.Info().UserState(t.ctx, t.walletAddr)
if err != nil {
return nil, fmt.Errorf("获取持仓失败: %w", err)
}
var result []map[string]interface{}
// 遍历所有持仓
for _, assetPos := range accountState.AssetPositions {
position := assetPos.Position
// 持仓数量string类型
posAmt, _ := strconv.ParseFloat(position.Szi, 64)
if posAmt == 0 {
continue // 跳过无持仓的
}
posMap := make(map[string]interface{})
// 标准化symbol格式Hyperliquid使用如"BTC",我们转换为"BTCUSDT"
symbol := position.Coin + "USDT"
posMap["symbol"] = symbol
// 持仓数量和方向
if posAmt > 0 {
posMap["side"] = "long"
posMap["positionAmt"] = posAmt
} else {
posMap["side"] = "short"
posMap["positionAmt"] = -posAmt // 转为正数
}
// 价格信息EntryPx和LiquidationPx是指针类型
var entryPrice, liquidationPx float64
if position.EntryPx != nil {
entryPrice, _ = strconv.ParseFloat(*position.EntryPx, 64)
}
if position.LiquidationPx != nil {
liquidationPx, _ = strconv.ParseFloat(*position.LiquidationPx, 64)
}
positionValue, _ := strconv.ParseFloat(position.PositionValue, 64)
unrealizedPnl, _ := strconv.ParseFloat(position.UnrealizedPnl, 64)
// 计算mark pricepositionValue / abs(posAmt)
var markPrice float64
if posAmt != 0 {
markPrice = positionValue / absFloat(posAmt)
}
posMap["entryPrice"] = entryPrice
posMap["markPrice"] = markPrice
posMap["unRealizedProfit"] = unrealizedPnl
posMap["leverage"] = float64(position.Leverage.Value)
posMap["liquidationPrice"] = liquidationPx
result = append(result, posMap)
}
return result, nil
}
// SetMarginMode 设置仓位模式 (在SetLeverage时一并设置)
func (t *HyperliquidTrader) SetMarginMode(symbol string, isCrossMargin bool) error {
// Hyperliquid的仓位模式在SetLeverage时设置这里只记录
t.isCrossMargin = isCrossMargin
marginModeStr := "全仓"
if !isCrossMargin {
marginModeStr = "逐仓"
}
log.Printf(" ✓ %s 将使用 %s 模式", symbol, marginModeStr)
return nil
}
// SetLeverage 设置杠杆
func (t *HyperliquidTrader) SetLeverage(symbol string, leverage int) error {
// Hyperliquid symbol格式去掉USDT后缀
coin := convertSymbolToHyperliquid(symbol)
// 调用UpdateLeverage (leverage int, name string, isCross bool)
// 第三个参数: true=全仓模式, false=逐仓模式
_, err := t.exchange.UpdateLeverage(t.ctx, leverage, coin, t.isCrossMargin)
if err != nil {
return fmt.Errorf("设置杠杆失败: %w", err)
}
log.Printf(" ✓ %s 杠杆已切换为 %dx", symbol, leverage)
return nil
}
// OpenLong 开多仓
func (t *HyperliquidTrader) OpenLong(symbol string, quantity float64, leverage int) (map[string]interface{}, error) {
// 先取消该币种的所有委托单
if err := t.CancelAllOrders(symbol); err != nil {
log.Printf(" ⚠ 取消旧委托单失败: %v", err)
}
// 设置杠杆
if err := t.SetLeverage(symbol, leverage); err != nil {
return nil, err
}
// Hyperliquid symbol格式
coin := convertSymbolToHyperliquid(symbol)
// 获取当前价格(用于市价单)
price, err := t.GetMarketPrice(symbol)
if err != nil {
return nil, err
}
// ⚠️ 关键:根据币种精度要求,四舍五入数量
roundedQuantity := t.roundToSzDecimals(coin, quantity)
log.Printf(" 📏 数量精度处理: %.8f -> %.8f (szDecimals=%d)", quantity, roundedQuantity, t.getSzDecimals(coin))
// ⚠️ 关键价格也需要处理为5位有效数字
aggressivePrice := t.roundPriceToSigfigs(price * 1.01)
log.Printf(" 💰 价格精度处理: %.8f -> %.8f (5位有效数字)", price*1.01, aggressivePrice)
// 创建市价买入订单使用IOC limit order with aggressive price
order := hyperliquid.CreateOrderRequest{
Coin: coin,
IsBuy: true,
Size: roundedQuantity, // 使用四舍五入后的数量
Price: aggressivePrice, // 使用处理后的价格
OrderType: hyperliquid.OrderType{
Limit: &hyperliquid.LimitOrderType{
Tif: hyperliquid.TifIoc, // Immediate or Cancel (类似市价单)
},
},
ReduceOnly: false,
}
_, err = t.exchange.Order(t.ctx, order, nil)
if err != nil {
return nil, fmt.Errorf("开多仓失败: %w", err)
}
log.Printf("✓ 开多仓成功: %s 数量: %.4f", symbol, roundedQuantity)
result := make(map[string]interface{})
result["orderId"] = 0 // Hyperliquid没有返回order ID
result["symbol"] = symbol
result["status"] = "FILLED"
return result, nil
}
// OpenShort 开空仓
func (t *HyperliquidTrader) OpenShort(symbol string, quantity float64, leverage int) (map[string]interface{}, error) {
// 先取消该币种的所有委托单
if err := t.CancelAllOrders(symbol); err != nil {
log.Printf(" ⚠ 取消旧委托单失败: %v", err)
}
// 设置杠杆
if err := t.SetLeverage(symbol, leverage); err != nil {
return nil, err
}
// Hyperliquid symbol格式
coin := convertSymbolToHyperliquid(symbol)
// 获取当前价格
price, err := t.GetMarketPrice(symbol)
if err != nil {
return nil, err
}
// ⚠️ 关键:根据币种精度要求,四舍五入数量
roundedQuantity := t.roundToSzDecimals(coin, quantity)
log.Printf(" 📏 数量精度处理: %.8f -> %.8f (szDecimals=%d)", quantity, roundedQuantity, t.getSzDecimals(coin))
// ⚠️ 关键价格也需要处理为5位有效数字
aggressivePrice := t.roundPriceToSigfigs(price * 0.99)
log.Printf(" 💰 价格精度处理: %.8f -> %.8f (5位有效数字)", price*0.99, aggressivePrice)
// 创建市价卖出订单
order := hyperliquid.CreateOrderRequest{
Coin: coin,
IsBuy: false,
Size: roundedQuantity, // 使用四舍五入后的数量
Price: aggressivePrice, // 使用处理后的价格
OrderType: hyperliquid.OrderType{
Limit: &hyperliquid.LimitOrderType{
Tif: hyperliquid.TifIoc,
},
},
ReduceOnly: false,
}
_, err = t.exchange.Order(t.ctx, order, nil)
if err != nil {
return nil, fmt.Errorf("开空仓失败: %w", err)
}
log.Printf("✓ 开空仓成功: %s 数量: %.4f", symbol, roundedQuantity)
result := make(map[string]interface{})
result["orderId"] = 0
result["symbol"] = symbol
result["status"] = "FILLED"
return result, nil
}
// CloseLong 平多仓
func (t *HyperliquidTrader) CloseLong(symbol string, quantity float64) (map[string]interface{}, error) {
// 如果数量为0获取当前持仓数量
if quantity == 0 {
positions, err := t.GetPositions()
if err != nil {
return nil, err
}
for _, pos := range positions {
if pos["symbol"] == symbol && pos["side"] == "long" {
quantity = pos["positionAmt"].(float64)
break
}
}
if quantity == 0 {
return nil, fmt.Errorf("没有找到 %s 的多仓", symbol)
}
}
// Hyperliquid symbol格式
coin := convertSymbolToHyperliquid(symbol)
// 获取当前价格
price, err := t.GetMarketPrice(symbol)
if err != nil {
return nil, err
}
// ⚠️ 关键:根据币种精度要求,四舍五入数量
roundedQuantity := t.roundToSzDecimals(coin, quantity)
log.Printf(" 📏 数量精度处理: %.8f -> %.8f (szDecimals=%d)", quantity, roundedQuantity, t.getSzDecimals(coin))
// ⚠️ 关键价格也需要处理为5位有效数字
aggressivePrice := t.roundPriceToSigfigs(price * 0.99)
log.Printf(" 💰 价格精度处理: %.8f -> %.8f (5位有效数字)", price*0.99, aggressivePrice)
// 创建平仓订单(卖出 + ReduceOnly
order := hyperliquid.CreateOrderRequest{
Coin: coin,
IsBuy: false,
Size: roundedQuantity, // 使用四舍五入后的数量
Price: aggressivePrice, // 使用处理后的价格
OrderType: hyperliquid.OrderType{
Limit: &hyperliquid.LimitOrderType{
Tif: hyperliquid.TifIoc,
},
},
ReduceOnly: true, // 只平仓,不开新仓
}
_, err = t.exchange.Order(t.ctx, order, nil)
if err != nil {
return nil, fmt.Errorf("平多仓失败: %w", err)
}
log.Printf("✓ 平多仓成功: %s 数量: %.4f", symbol, roundedQuantity)
// 平仓后取消该币种的所有挂单
if err := t.CancelAllOrders(symbol); err != nil {
log.Printf(" ⚠ 取消挂单失败: %v", err)
}
result := make(map[string]interface{})
result["orderId"] = 0
result["symbol"] = symbol
result["status"] = "FILLED"
return result, nil
}
// CloseShort 平空仓
func (t *HyperliquidTrader) CloseShort(symbol string, quantity float64) (map[string]interface{}, error) {
// 如果数量为0获取当前持仓数量
if quantity == 0 {
positions, err := t.GetPositions()
if err != nil {
return nil, err
}
for _, pos := range positions {
if pos["symbol"] == symbol && pos["side"] == "short" {
quantity = pos["positionAmt"].(float64)
break
}
}
if quantity == 0 {
return nil, fmt.Errorf("没有找到 %s 的空仓", symbol)
}
}
// Hyperliquid symbol格式
coin := convertSymbolToHyperliquid(symbol)
// 获取当前价格
price, err := t.GetMarketPrice(symbol)
if err != nil {
return nil, err
}
// ⚠️ 关键:根据币种精度要求,四舍五入数量
roundedQuantity := t.roundToSzDecimals(coin, quantity)
log.Printf(" 📏 数量精度处理: %.8f -> %.8f (szDecimals=%d)", quantity, roundedQuantity, t.getSzDecimals(coin))
// ⚠️ 关键价格也需要处理为5位有效数字
aggressivePrice := t.roundPriceToSigfigs(price * 1.01)
log.Printf(" 💰 价格精度处理: %.8f -> %.8f (5位有效数字)", price*1.01, aggressivePrice)
// 创建平仓订单(买入 + ReduceOnly
order := hyperliquid.CreateOrderRequest{
Coin: coin,
IsBuy: true,
Size: roundedQuantity, // 使用四舍五入后的数量
Price: aggressivePrice, // 使用处理后的价格
OrderType: hyperliquid.OrderType{
Limit: &hyperliquid.LimitOrderType{
Tif: hyperliquid.TifIoc,
},
},
ReduceOnly: true,
}
_, err = t.exchange.Order(t.ctx, order, nil)
if err != nil {
return nil, fmt.Errorf("平空仓失败: %w", err)
}
log.Printf("✓ 平空仓成功: %s 数量: %.4f", symbol, roundedQuantity)
// 平仓后取消该币种的所有挂单
if err := t.CancelAllOrders(symbol); err != nil {
log.Printf(" ⚠ 取消挂单失败: %v", err)
}
result := make(map[string]interface{})
result["orderId"] = 0
result["symbol"] = symbol
result["status"] = "FILLED"
return result, nil
}
// CancelAllOrders 取消该币种的所有挂单
func (t *HyperliquidTrader) CancelAllOrders(symbol string) error {
coin := convertSymbolToHyperliquid(symbol)
// 获取所有挂单
openOrders, err := t.exchange.Info().OpenOrders(t.ctx, t.walletAddr)
if err != nil {
return fmt.Errorf("获取挂单失败: %w", err)
}
// 取消该币种的所有挂单
for _, order := range openOrders {
if order.Coin == coin {
_, err := t.exchange.Cancel(t.ctx, coin, order.Oid)
if err != nil {
log.Printf(" ⚠ 取消订单失败 (oid=%d): %v", order.Oid, err)
}
}
}
log.Printf(" ✓ 已取消 %s 的所有挂单", symbol)
return nil
}
// CancelStopOrders 取消该币种的止盈/止损单(用于调整止盈止损位置)
func (t *HyperliquidTrader) CancelStopOrders(symbol string) error {
coin := convertSymbolToHyperliquid(symbol)
// 获取所有挂单
openOrders, err := t.exchange.Info().OpenOrders(t.ctx, t.walletAddr)
if err != nil {
return fmt.Errorf("获取挂单失败: %w", err)
}
// 注意Hyperliquid SDK 的 OpenOrder 结构不暴露 trigger 字段
// 因此暂时取消该币种的所有挂单(包括止盈止损单)
// 这是安全的,因为在设置新的止盈止损之前,应该清理所有旧订单
canceledCount := 0
for _, order := range openOrders {
if order.Coin == coin {
_, err := t.exchange.Cancel(t.ctx, coin, order.Oid)
if err != nil {
log.Printf(" ⚠ 取消订单失败 (oid=%d): %v", order.Oid, err)
continue
}
canceledCount++
}
}
if canceledCount == 0 {
log.Printf(" %s 没有挂单需要取消", symbol)
} else {
log.Printf(" ✓ 已取消 %s 的 %d 个挂单(包括止盈/止损单)", symbol, canceledCount)
}
return nil
}
// CancelStopLossOrders 仅取消止损单Hyperliquid 暂无法区分止损和止盈,取消所有)
func (t *HyperliquidTrader) CancelStopLossOrders(symbol string) error {
// Hyperliquid SDK 的 OpenOrder 结构不暴露 trigger 字段
// 无法区分止损和止盈单,因此取消该币种的所有挂单
log.Printf(" ⚠️ Hyperliquid 无法区分止损/止盈单,将取消所有挂单")
return t.CancelStopOrders(symbol)
}
// CancelTakeProfitOrders 仅取消止盈单Hyperliquid 暂无法区分止损和止盈,取消所有)
func (t *HyperliquidTrader) CancelTakeProfitOrders(symbol string) error {
// Hyperliquid SDK 的 OpenOrder 结构不暴露 trigger 字段
// 无法区分止损和止盈单,因此取消该币种的所有挂单
log.Printf(" ⚠️ Hyperliquid 无法区分止损/止盈单,将取消所有挂单")
return t.CancelStopOrders(symbol)
}
// GetMarketPrice 获取市场价格
func (t *HyperliquidTrader) GetMarketPrice(symbol string) (float64, error) {
coin := convertSymbolToHyperliquid(symbol)
// 获取所有市场价格
allMids, err := t.exchange.Info().AllMids(t.ctx)
if err != nil {
return 0, fmt.Errorf("获取价格失败: %w", err)
}
// 查找对应币种的价格allMids是map[string]string
if priceStr, ok := allMids[coin]; ok {
priceFloat, err := strconv.ParseFloat(priceStr, 64)
if err == nil {
return priceFloat, nil
}
return 0, fmt.Errorf("价格格式错误: %v", err)
}
return 0, fmt.Errorf("未找到 %s 的价格", symbol)
}
// SetStopLoss 设置止损单
func (t *HyperliquidTrader) SetStopLoss(symbol string, positionSide string, quantity, stopPrice float64) error {
coin := convertSymbolToHyperliquid(symbol)
isBuy := positionSide == "SHORT" // 空仓止损=买入,多仓止损=卖出
// ⚠️ 关键:根据币种精度要求,四舍五入数量
roundedQuantity := t.roundToSzDecimals(coin, quantity)
// ⚠️ 关键价格也需要处理为5位有效数字
roundedStopPrice := t.roundPriceToSigfigs(stopPrice)
// 创建止损单Trigger Order
order := hyperliquid.CreateOrderRequest{
Coin: coin,
IsBuy: isBuy,
Size: roundedQuantity, // 使用四舍五入后的数量
Price: roundedStopPrice, // 使用处理后的价格
OrderType: hyperliquid.OrderType{
Trigger: &hyperliquid.TriggerOrderType{
TriggerPx: roundedStopPrice,
IsMarket: true,
Tpsl: "sl", // stop loss
},
},
ReduceOnly: true,
}
_, err := t.exchange.Order(t.ctx, order, nil)
if err != nil {
return fmt.Errorf("设置止损失败: %w", err)
}
log.Printf(" 止损价设置: %.4f", roundedStopPrice)
return nil
}
// SetTakeProfit 设置止盈单
func (t *HyperliquidTrader) SetTakeProfit(symbol string, positionSide string, quantity, takeProfitPrice float64) error {
coin := convertSymbolToHyperliquid(symbol)
isBuy := positionSide == "SHORT" // 空仓止盈=买入,多仓止盈=卖出
// ⚠️ 关键:根据币种精度要求,四舍五入数量
roundedQuantity := t.roundToSzDecimals(coin, quantity)
// ⚠️ 关键价格也需要处理为5位有效数字
roundedTakeProfitPrice := t.roundPriceToSigfigs(takeProfitPrice)
// 创建止盈单Trigger Order
order := hyperliquid.CreateOrderRequest{
Coin: coin,
IsBuy: isBuy,
Size: roundedQuantity, // 使用四舍五入后的数量
Price: roundedTakeProfitPrice, // 使用处理后的价格
OrderType: hyperliquid.OrderType{
Trigger: &hyperliquid.TriggerOrderType{
TriggerPx: roundedTakeProfitPrice,
IsMarket: true,
Tpsl: "tp", // take profit
},
},
ReduceOnly: true,
}
_, err := t.exchange.Order(t.ctx, order, nil)
if err != nil {
return fmt.Errorf("设置止盈失败: %w", err)
}
log.Printf(" 止盈价设置: %.4f", roundedTakeProfitPrice)
return nil
}
// FormatQuantity 格式化数量到正确的精度
func (t *HyperliquidTrader) FormatQuantity(symbol string, quantity float64) (string, error) {
coin := convertSymbolToHyperliquid(symbol)
szDecimals := t.getSzDecimals(coin)
// 使用szDecimals格式化数量
formatStr := fmt.Sprintf("%%.%df", szDecimals)
return fmt.Sprintf(formatStr, quantity), nil
}
// getSzDecimals 获取币种的数量精度
func (t *HyperliquidTrader) getSzDecimals(coin string) int {
if t.meta == nil {
log.Printf("⚠️ meta信息为空使用默认精度4")
return 4 // 默认精度
}
// 在meta.Universe中查找对应的币种
for _, asset := range t.meta.Universe {
if asset.Name == coin {
return asset.SzDecimals
}
}
log.Printf("⚠️ 未找到 %s 的精度信息使用默认精度4", coin)
return 4 // 默认精度
}
// roundToSzDecimals 将数量四舍五入到正确的精度
func (t *HyperliquidTrader) roundToSzDecimals(coin string, quantity float64) float64 {
szDecimals := t.getSzDecimals(coin)
// 计算倍数10^szDecimals
multiplier := 1.0
for i := 0; i < szDecimals; i++ {
multiplier *= 10.0
}
// 四舍五入
return float64(int(quantity*multiplier+0.5)) / multiplier
}
// roundPriceToSigfigs 将价格四舍五入到5位有效数字
// Hyperliquid要求价格使用5位有效数字significant figures
func (t *HyperliquidTrader) roundPriceToSigfigs(price float64) float64 {
if price == 0 {
return 0
}
const sigfigs = 5 // Hyperliquid标准5位有效数字
// 计算价格的数量级
var magnitude float64
if price < 0 {
magnitude = -price
} else {
magnitude = price
}
// 计算需要的倍数
multiplier := 1.0
for magnitude >= 10 {
magnitude /= 10
multiplier /= 10
}
for magnitude < 1 {
magnitude *= 10
multiplier *= 10
}
// 应用有效数字精度
for i := 0; i < sigfigs-1; i++ {
multiplier *= 10
}
// 四舍五入
rounded := float64(int(price*multiplier+0.5)) / multiplier
return rounded
}
// convertSymbolToHyperliquid 将标准symbol转换为Hyperliquid格式
// 例如: "BTCUSDT" -> "BTC"
func convertSymbolToHyperliquid(symbol string) string {
// 去掉USDT后缀
if len(symbol) > 4 && symbol[len(symbol)-4:] == "USDT" {
return symbol[:len(symbol)-4]
}
return symbol
}
// absFloat 返回浮点数的绝对值
func absFloat(x float64) float64 {
if x < 0 {
return -x
}
return x
}