币安现货 API 的挂钩订单,偏移量按价格还是档位算?

 / 
2

币安现货 API 的挂钩订单偏移量,按价格档位(price level) 算,不是按价格数值算。请求里唯一可用的偏移类型是 PRICE_LEVEL,偏移值 pegOffsetValue 代表从基准价往订单簿深处数几个档位,上限为 100。

Binance币安
全球交易量最大的加密货币交易所,安全性与流动性行业领先
新手福利:注册立享20%手续费折扣优惠!

关键参数的实际含义

挂钩订单本质上是限价单,价格不写死,而是从订单簿实时推导。发单时涉及偏移的参数只有两个:

pegOffsetType:只支持 PRICE_LEVEL。这不是让你选"价格"还是"档位",而是币安只提供了这一种偏移方式,没有按固定价差(比如固定偏移 1 USDT)偏移的选项。

pegOffsetValue:整数,最大 100。它表示在基准价的基础上,往订单簿更深处移动的档位数量。比如基准价是最佳买价,偏移值为 2,订单价格就会放在买侧第二档的价格水平上,而不是"最佳买价减 2 USDT"。

先确认基准价是哪一边

偏移发生在基准价确定之后。pegPriceType 决定基准:

  • PRIMARY_PEG:取同方向最优价。买单取最佳买价,卖单取最佳卖价。这是最常用的挂单模式,LIMIT 配合 GTC 或 LIMIT_MAKER 时都只允许用这个类型。

  • MARKET_PEG:取反方向最优价。买单取最佳卖价,卖单取最佳买价,偏向于尽快成交。

偏移的方向始终是"深入订单簿"。买单的基准价越低越靠后,卖单的基准价越高越靠后。pegOffsetValue 让订单在那个方向上退开若干档,而不是用固定价差计算。

下单前要检查的条件

不是所有交易对都能用挂钩订单。在 GET /api/v3/exchangeInfo 返回结果里找到对应交易对,检查 pegInstructionsAllowed 字段是否为 true。如果为 false 或没有这个字段,请求会被拒绝。

另外,挂钩订单最终选中的价格仍然要通过该交易对的过滤器,包括 PRICE_FILTER、PERCENT_PRICE 等。档位偏移算出来的价格如果越界或不符合精度要求,单子不会成立。

怎么看实际选中了什么价格

下单响应里有两个价格字段要分开看:

  • price:你请求里传的原始价格。挂钩订单通常不传 price,所以返回 "0.00000000"。

  • peggedPrice:币安根据当时的订单簿和偏移量实际选中的价格。

要核验偏移是否按预期生效,看 peggedPrice 是否落在你想要的档位水平上,而不是看 price。行情快速变化时,基准价会变,最终选中的价格也会跟着变。如果对成交价格有硬约束,普通限价单比挂钩订单更可控。

常见问题

Q:pegOffsetValue 能填小数吗?

A:不能。官方定义它是整数,代表档位数量,最大 100。想实现"偏移 0.5 个价位"或"偏移 2 USDT"这类效果,挂钩订单的档位偏移参数做不到,应该改用普通限价单,由你的程序自己读订单簿算好价格再传 price。

Q:为什么我的挂钩订单被拒绝了?

A:先查两处。第一,exchangeInfo 里该交易对的 pegInstructionsAllowed 是否为 true。第二,检查 pegPriceType 和订单类型的组合是否合法,比如 LIMIT 用 PRIMARY_PEG 时 timeInForce 只允许 GTC,LIMIT_MAKER 只允许 PRIMARY_PEG。如果这两项都合规,再看返回的错误码,可能是偏移后选中的价格触发了 PRICE_FILTER 或 PERCENT_PRICE 的限制。

Q:挂了挂钩单之后,基准价变了,我的订单价格会自动跟吗?

A:会。挂钩订单的价格来自订单簿,基准价变动后,订单在簿上的价格会重新计算。peggedPrice 反映的是下单那一刻选中的价格,之后的变化需要靠查询订单或用户数据流来跟踪。如果你的策略依赖价格固定在某个位置,挂钩订单的这种动态特性是需要考虑的因素。

Binance币安
全球交易量最大的加密货币交易所,安全性与流动性行业领先
新手福利:注册立享20%手续费折扣优惠!

参考资料

  1. Binance·挂钩订单(Pegged orders),日期:2026-11-19
  2. Binance·交易接口(Trading endpoints),日期:2026-11-19
  3. Binance·Pegged Orders,日期:2026-11-19
  4. Binance Connector JS·NewOrderRequest 接口定义,日期:2026-11-19