反手单为什么变成 0 张:只减仓(reduce-only)的四种情形与五个自检

程序化下单的人大多踩过这个坑:账户里明显有仓位,脚本发出去的平仓单却返回成功,成交量是 0。日志里看不出错误,因为订单确实被接受了——只是它的可成交数量被算成了零。原因通常只有一个:下单参数里带了「只减仓」。

reduce-only 不是「平仓单」的同义词,它是「不许增加敞口」这个约束。这个约束在四种情形下会给出四种不同结果,而且不同交易所在「超出部分怎么处理」上并不一致。下面把四种情形列清楚,再给五个上线前的自检。

一、reduce-only 管的是「敞口」,不是「方向」

普通限价单的语义是「按这个价格成交多少数量」。reduce-only 在此基础上加了一条:如果这笔单成交后会让持仓绝对值变大,就不允许成交。它不区分你下的是买单还是卖单,只判断成交后仓位是变大还是变小。

所以「卖出 = 平仓」这个直觉只在多头仓位上成立。空头仓位里,卖出是加仓,买入才是减仓。这也是脚本里最容易写反的一行:用同一个 side 做「开」和「平」,再挂一个 reduce-only 就以为安全了。

二、四种情形,四种结果

假设当前持有 5 张多单。下表按「下单方向 × 数量」列出 reduce-only 的实际行为:

情形 当前仓位 下单 reduce-only 结果 说明
① 正常减仓 5 张多 卖出 3 张 成交 3 张,剩 2 张 敞口变小,符合约束
② 超出仓位 5 张多 卖出 8 张 只成交 5 张,余量被裁剪或整单拒绝 不同平台处理不同:有的裁到持仓量,有的直接拒单
③ 同向加仓 5 张多 买入 2 张 拒单,成交量 0 会让敞口变大,直接不允许
④ 无仓位 0 卖出 1 张 拒单,成交量 0 没有可减的敞口,约束无法满足

情形 ③ 就是「反手单变成 0 张」的来源:脚本想先平掉多单再开空,于是发了一笔卖出 reduce-only,数量取了目标空单的规模——如果这笔数量超过当前多单,超出部分在有些平台被裁掉(结果是仓位归零、空单没开成),在另一些平台整单拒绝。无论哪种,你都不会得到「反手」的结果,只会得到「平掉」或「什么都没发生」。

情形 ④ 更隐蔽:仓位刚被止损单平掉,队列里排着的 reduce-only 平仓单到执行时已经没有仓位,于是全部返回「成功但 0 成交」。日志里全是 200,账上什么都没变。

三、双向持仓模式下的参数陷阱

这是最容易踩的一层。主流平台提供两种持仓模式:单向(净持仓)与双向(多空分开)。在双向模式下,「减仓」由持仓方向字段决定,而不是由 reduce-only 决定:

  • Binance 合约 API。下单接口的 reduceOnly 字段在双向持仓模式(Hedge Mode)下不允许发送,需要改用 positionSide 指定 LONG 或 SHORT。文档里这句限制写在字段说明中,很容易被忽略。
  • OKX v5 API。reduceOnly 只在单向持仓模式下生效;双向模式用 posSide(long / short)区分,语义是「这笔单属于哪条腿」。
  • 传统期货(如 CME)。没有 reduce-only 字段,减仓就是下反向单,靠「买/卖方向 + 持仓」自然抵扣。

换句话说:同一个参数名,在 A 平台是「约束」,在 B 平台的某种模式下是「被忽略的字段」。如果你的策略在测试网跑通、上了主网却反手失败,先查账户的持仓模式,再查参数有没有被静默丢掉。

四、五个上线前自检

  1. 确认账户持仓模式。单向还是双向,直接决定你该用 reduceOnly 还是 positionSide。切换模式前先清空仓位,否则平台可能拒绝切换或强平。
  2. 平仓数量取「当前持仓」而非「目标仓位」。用查询接口返回的持仓量做上限,别用策略内部的目标值——两者在部分成交后会分叉。
  3. 处理「超出部分」的两种返回。裁剪与拒单都要写进重试逻辑:裁剪后要重新读持仓,拒单要看错误码而不是只看 HTTP 状态。
  4. 给 0 成交单独告警。返回成功但成交量 0 是最危险的状态,它会让「已平仓」的判断成立而实际敞口还在。
  5. 反手写成两步并做幂等。先平(reduce-only 或平仓接口),确认持仓归零,再开反向仓;中间失败要能停在「空仓」这个安全状态,而不是带仓重试。

五、常见问题

问:reduce-only 单会触发强平吗?

不会因为它本身被强平,但它不能代替止损。如果仓位先被强平,挂着的 reduce-only 单会因无仓可减而失效;反过来,如果 reduce-only 单只部分成交,剩余敞口仍然暴露在强平风险下。

问:为什么我的 reduce-only 限价单一直不成交?

可能有两个原因:价格没有触及;或者挂单期间仓位被其他单子减掉,可减数量变小,系统把订单的可成交数量收到 0。检查持仓变化历史,比看订单状态更有效。

问:市价 reduce-only 和限价 reduce-only 有区别吗?

约束相同,执行不同。市价单立即按盘口成交,滑点大但确定减仓;限价单可能挂着不动,在快速行情里反而减不掉。急跌时用限价平仓,是「价格保护」与「减仓确定性」之间的取舍。

风险提示:本文讨论的是下单语义,不涉及任何方向判断。合约交易带杠杆,价格不利变动会导致保证金亏损甚至全部损失,仓位在强平价被强制平掉时无法选择成交价;程序化下单还会叠加参数错误、网络中断与部分成交的风险。任何策略上线前都应在小额环境验证「平仓是否真的平掉」。
来源:Binance Futures API 文档「New Order」接口字段说明(reduceOnly 在 Hedge Mode 下不可发送,binance-docs.github.io,访问日期 2026-11-02);OKX v5 交易 API 文档关于 reduceOnly 与 posSide 的适用模式说明(okx.com,访问日期 2026-11-02);Binance 帮助中心「什么是只减仓委托」条目(binance.com,访问日期 2026-11-02)。四种情形的结果差异为本站按各家文档整理,超出仓位的处理方式请以你所使用平台的接口文档为准。

相关阅读

安装 App