程序化下单的人大多踩过这个坑:账户里明显有仓位,脚本发出去的平仓单却返回成功,成交量是 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 平台的某种模式下是「被忽略的字段」。如果你的策略在测试网跑通、上了主网却反手失败,先查账户的持仓模式,再查参数有没有被静默丢掉。
四、五个上线前自检
- 确认账户持仓模式。单向还是双向,直接决定你该用 reduceOnly 还是 positionSide。切换模式前先清空仓位,否则平台可能拒绝切换或强平。
- 平仓数量取「当前持仓」而非「目标仓位」。用查询接口返回的持仓量做上限,别用策略内部的目标值——两者在部分成交后会分叉。
- 处理「超出部分」的两种返回。裁剪与拒单都要写进重试逻辑:裁剪后要重新读持仓,拒单要看错误码而不是只看 HTTP 状态。
- 给 0 成交单独告警。返回成功但成交量 0 是最危险的状态,它会让「已平仓」的判断成立而实际敞口还在。
- 反手写成两步并做幂等。先平(reduce-only 或平仓接口),确认持仓归零,再开反向仓;中间失败要能停在「空仓」这个安全状态,而不是带仓重试。
五、常见问题
不会因为它本身被强平,但它不能代替止损。如果仓位先被强平,挂着的 reduce-only 单会因无仓可减而失效;反过来,如果 reduce-only 单只部分成交,剩余敞口仍然暴露在强平风险下。
可能有两个原因:价格没有触及;或者挂单期间仓位被其他单子减掉,可减数量变小,系统把订单的可成交数量收到 0。检查持仓变化历史,比看订单状态更有效。
约束相同,执行不同。市价单立即按盘口成交,滑点大但确定减仓;限价单可能挂着不动,在快速行情里反而减不掉。急跌时用限价平仓,是「价格保护」与「减仓确定性」之间的取舍。