导语:下单 1 BTC,撤单那一刻返回「撤单成功」,成交明细里却多出一笔 0.4 BTC 的成交。程序以为没成交、按 0 记账,账就歪了。这不是接口出错,而是撤单与撮合本来就是两个并发事件——撤单只保证「剩余部分不再成交」,不保证「之前没成交过」。把状态机的语义搞清楚,这类对账错误能一次消掉八成。
一、现场还原:一个撤单竞态
时间顺序通常是这样的(毫秒级):
- t0 你提交 1 BTC 限价买单,状态
NEW,成交 0。 - t1 盘口打过来,成交 0.4,状态变为
PARTIALLY_FILLED,剩余 0.6 继续挂。 - t2 你发出撤单请求。
- t3 撮合引擎处理撤单,取消剩余 0.6,状态终态。
如果你的程序在 t2 之后按「撤单成功 = 未成交」记账,就会漏掉 t1 那 0.4。仓位差 0.4 BTC,手续费差一笔,后面的对账全部错位。正确做法只有一条:以成交明细(fills / trades)为准,订单状态只用来判断「还有没有剩余」。
二、状态机:五条到终态的路径
不管哪家交易所,订单走到终点只有五条路,认这五条比认枚举名更稳:
1. 全成交:NEW → PARTIALLY_FILLED → FILLED
2. 未成交被撤:NEW → CANCELED
3. 部分成交后被撤:NEW → PARTIALLY_FILLED → CANCELED(成交量要单独取)
4. 被拒:REJECTED(资金不足、精度不符、风控、价格带)
5. 过期/失效:EXPIRED 或类似的停用状态(IOC/FOK 未立即成交、条件单未触发后失效)
第 3 条是错的源头。同一家交易所里,它可能被写成「CANCELED」而不是「PARTIALLY_FILLED_CANCELED」,于是「CANCELED」这个状态同时代表「一笔没成交」和「成交了一半」——靠状态名判断成交量,必然出错。
三、三家交易所的枚举对照
下表按公开 API 文档的字段归类,只对齐语义:
| 语义 | Binance 现货 | OKX v5 | Bybit v5 |
|---|---|---|---|
| 已挂单,未成交 | NEW | live | New |
| 部分成交,仍有剩余 | PARTIALLY_FILLED | partially_filled | PartiallyFilled |
| 全部成交 | FILLED | filled | Filled |
| 未成交即被撤 | CANCELED | canceled | Cancelled |
| 部分成交后被撤 | CANCELED(另查成交量) | canceled | PartiallyFilledCanceled |
| 撤单处理中 | PENDING_CANCEL | 无对应值 | 无对应值 |
| 被拒单 | REJECTED | 无对应值 | Rejected |
| 过期失效 | EXPIRED | 无对应值 | Deactivated(部分场景) |
| 条件单未触发 | 无对应值 | 无对应值 | Untriggered |
| 做市保护撤单 | 无对应值 | mmp_canceled | 无对应值 |
只有 Bybit 把「部分成交后被撤」单独列了一个终态,另外两家要靠 executedQty / accFillSz 这类成交量字段区分。这就是为什么跨所对账不能写一套映射表了事:语义层要统一,字段层必须逐所适配。
四、五种对账口径,各自能证明什么
对账时最常被混用的五个数字:
- 订单状态:只证明「还有没有剩余」,不证明成交量。
- 累计成交量(executedQty / accFillSz):证明成交了多少,但可能滞后于成交明细。
- 成交明细(fills / trades):最细粒度,一条一条可核对,是对账的唯一基准。
- 手续费流水:独立计提,可能按笔、可能按日汇总,与成交明细不是一对一。
- 账户权益变动:包含手续费、资金费、借贷利息,差价通常来自后两项,拆法见盈亏与权益的三本账。
把五个数字混成一个「订单结果」,就会出现「明明撤单了怎么还有手续费」这类问题。它们本来就是五个账本。
五、算例:0.4 BTC 到底怎么记
下单 1 BTC @ 60,000,taker 费率 0.05%。
成交 0.4 BTC,成交额
0.4 × 60,000 = 24,000 USDT,手续费 24,000 × 0.05% = 12 USDT。撤单后剩余 0.6 取消,不产生费用。
正确记账:成交量 0.4、成交额 24,000、手续费 12、终态「部分成交后撤」。
错误记账(按 CANCELED 当零成交):成交量 0、手续费 0 —— 仓位差 0.4 BTC,一天几十笔就是系统性偏差。
如果这单是挂单成交(maker),费率可能是 0.02% 甚至负数(返佣),手续费变成 4.8 USDT 或反向入账。所以对账前必须先确认这笔是 maker 还是 taker,字段通常是 isMaker / execType 之类,别用价格猜。
六、四步对账流程
- 拉全量成交明细:按时间窗口翻页,不要只取最近 100 条;用订单 ID 反查该单所有 fills。
- 按订单聚合:
sum(fill.qty)与executedQty对比,差一个最小单位内属正常舍入。 - 判定终态:成交量 = 0 且状态为撤单/过期 → 未成交;成交量 > 0 且小于原始数量 → 部分成交后撤。
- 对齐手续费:按笔核对,差额落在「返佣」「抵扣券」「平台币折扣」三处之一,机制见手续费扣币与舍入。
程序侧还有一条硬规则:撤单请求返回「订单不存在」不等于失败,很可能是撤单与成交撞车,该单已终态。此时应当回读一次订单,而不是重试撤单,重试语义见幂等键与重复订单。
七、三个误区
- 撤单成功就代表没成交:只代表剩余部分取消了。历史成交永远在 fills 里。
- 状态名可以跨所直接映射:语义能对齐,字段不能。同名状态在不同所的「剩余量」字段含义可能不同。
- 断线重连后状态会自己同步:私有 WebSocket 会补发增量,但重连窗口内的成交可能要靠 REST 补拉,见序号缺口导致的账本错位。
问:撤单返回「未知订单」是什么意思?
通常是该订单已经终态(成交完或被撤),也可能订单号写错。先按订单 ID 回读,再决定是否重试,不要盲目重发撤单。
问:为什么成交明细里有,订单查询里没有?
两者的写入路径不同,成交明细通常更实时。以成交明细为准,订单查询用于确认剩余量与终态。
问:部分成交后撤单,手续费按整单算还是按成交算?
按实际成交量算。未成交部分不收费,这也是「撤单后手续费比预期低」的正常原因。
问:怎么避免程序把部分成交当零成交?
三条:以 fills 聚合为唯一成交量来源;状态机里把「部分成交后撤」单独建模;每笔订单落库时同时写入成交量与终态,而不是只写终态。
问:跨所统一状态机要怎么写?
先定五个内部终态(全成交、未成交撤、部分成交撤、拒单、失效),再为每所写一层适配器,把原始字段映射到这五个,不要让业务代码直接读原始枚举。
资料来源与访问日期
· Binance 现货与合约 API 文档「订单状态(status)」字段说明,访问日期 2026-10-31;
· OKX v5 交易 API 文档「订单状态(state)」字段说明,访问日期 2026-10-31;
· Bybit v5 交易 API 文档「orderStatus」枚举说明,访问日期 2026-10-31;
· 文中费率、价格与数量均为示例参数,仅用于演示记账差异,不代表任何平台的实际费率。
最后更新:2026-10-31