要让币安 U 本位合约的未成交挂单按时失效，API 用户应使用 timeInForce=GTD 并同时传入 goodTillDate 参数。这是币安 U 本位合约原生支持的定时过期机制，不需要自己写定时任务去撤单。关键约束有三条：goodTillDate 必须大于当前时间加 600 秒，必须小于 253402300799000，且传入的时间戳只保留秒级精度、毫秒部分会被忽略。如果你需要挂单"只做 Maker 且定时过期"，GTD 与 post-only 不能同时使用，必须二选一。
先确认你的订单类型支持 GTD
GTD 是 timeInForce 的一个取值，作用于限价单。币安 U 本位合约的有效方式枚举中，GTD 的定义是"在特定时间之前有效，到期自动撤销"。相比之下，GTC 虽然也是挂单，但它的有效期是下单后一年，一年后才自动取消。对于"让未成交挂单按时失效"这个目标，GTD 是直接匹配的参数；用 GTC 再自己轮询撤单，等于在 API 之外多维护一套逻辑，没有必要。
注意 IOC 和 FOK 不适合这个场景：IOC 是未立即成交的部分立刻撤销，FOK 是无法全部立即成交就整单撤销，它们解决的是"要不要等"的问题，不是"等到某个时刻再失效"。
下单时具体要传什么
在 U 本位合约下单接口中，把 timeInForce 设为 GTD，并在 goodTillDate 字段填入你希望订单自动取消的时间戳。官方文档写明的规则是：timeInForce 为 GTD 时，goodTillDate 为必传参数；时间戳需大于当前时间加 600 秒，且小于 253402300799000；传入的时间戳仅保留秒级精度，毫秒级部分会被自动忽略。
举个例子：假设你希望某张 BTCUSDT 限价单在 UTC 时间 2026 年 10 月 27 日 12:00:00 失效，对应的时间戳需要是那个时刻的 Unix 毫秒值。如果你的代码生成的时间戳带有毫秒尾数，比如 ...448，币安会忽略 448，实际过期时间落在整秒上。这在绝大多数场景下没有影响，但如果你对失效时刻有秒级以下的精确要求，需要知道这个截断是平台行为，不是你代码的问题。
600 秒的最小提前量是一个容易踩的坑。如果你的策略在行情快速变化时才临时计算一个"一分钟后过期"的时间戳，接口会直接拒绝。更稳妥的做法是在下单逻辑里就校验 goodTillDate 是否满足 now + 600s 的下限，不满足就改用 GTC 并配合本地撤单逻辑，或者把过期时间设得更远一些。
还有一个限制值得注意：GTD 与 post-only（仅做 Maker）不能组合。如果你的策略要求订单必须成为挂单方，同时又需要定时过期，币安原生 GTD 无法同时满足。此时的选择是：要么放弃 post-only，用 GTD 换取原生过期；要么保留 post-only，用 GTC 下单并在自己的系统里维护一个撤单调度。前者更省事，后者对 Maker 策略的执行质量更可控，取决于你的策略更在意哪一端。
下单后怎么确认这笔挂单真的会过期
提交 GTD 订单后，不要只看下单接口返回了订单 ID 就认为设置已生效。通过查询订单接口获取该订单的详情，检查返回中的 timeInForce 是否为 GTD、goodTillDate 是否与你传入的值一致。如果 timeInForce 显示为 GTC，说明你的参数没有生效——常见原因是代码层面把 timeInForce 硬编码成了 GTC，或者使用的 SDK/库不支持透传 GTD。部分第三方库对 goodTillDate 的序列化存在历史问题，曾出现把毫秒时间戳按秒发送导致被拒的案例。如果你使用的是封装库而非直接调用 REST API，先检查它是否原样传递了这个字段。
订单到期后，状态会变为 EXPIRED（根据 timeInForce 参数规则过期），而不是 CANCELED（用户主动撤销）。在订单历史或查询接口中看到 EXPIRED，说明 GTD 机制按预期工作了。如果你的策略需要区分"我主动撤的"和"到期自动失效的"，这个状态差异就是判断依据。
如果你的挂单没有按时失效
首先查订单状态。如果状态仍是 NEW，说明 GTD 没有被正确应用。回头检查下单请求的原始参数：timeInForce 是否确实是 GTD，goodTillDate 是否满足下限和上限，时间戳单位是否被你的代码误处理。其次，官方文档提到"极端行情时，timeInForce 为 GTD 的订单自动取消可能有一定延迟"。也就是说，到点后状态短暂未变不一定是你的配置错误，但如果过了合理时间仍未变，就需要按参数问题排查。如果订单状态显示 EXPIRED 但时间与你预期不符，检查时间戳是否被截断到整秒，或者你的服务器时间与币安服务器时间存在偏差。
参考资料
- Binance·UM下单(TRADE)，2026-10-26
- Binance·通用枚举定义（U本位合约），2026-10-26
- Binance·Public Endpoints Info，2026-10-26
- Binance·公开API参数，2026-10-26
- Binance.Net相关序列化问题说明
