订单生命周期与状态机

1. 订单状态机

每个订单在其生命周期中经历以下状态。所有状态变更通过事件驱动，保证可审计与可重放。

状态说明

动手试试状态转换

点击下方按钮，模拟订单从创建到终态的完整生命周期:

2. 订单数据模型

订单对象是整个交易系统的核心实体，贯穿从接入到撮合再到结算的全流程。

interface Order {
  // === 标识 ===
  orderId: string;          // 系统分配的全局唯一 ID（Snowflake）
  clientOrderId: string;    // 客户端幂等 ID
  userId: number;           // 用户 ID
  accountId: number;        // 账户 ID（支持子账户）

  // === 交易对 ===
  symbol: string;           // 如 "BTCUSDT"
  baseAsset: string;        // 基础资产 "BTC"
  quoteAsset: string;       // 计价资产 "USDT"

  // === 订单参数 ===
  side: "BUY" | "SELL";
  type: "LIMIT" | "MARKET" | "STOP_LIMIT" | "STOP_MARKET";
  timeInForce: "GTC" | "IOC" | "FOK" | "GTT";
  price: string;            // 限价价格（decimal string 防精度丢失）
  stopPrice: string;        // 止损触发价
  quantity: string;         // 原始委托量
  quoteOrderQty: string;    // 市价按金额下单时使用

  // === 标志位 ===
  postOnly: boolean;        // 只做 Maker
  reduceOnly: boolean;      // 只减仓
  isLiquidation: boolean;   // 强平订单标志

  // === 成交状态 ===
  status: OrderStatus;
  executedQty: string;      // 累计成交量
  cummulativeQuoteQty: string; // 累计成交额
  avgPrice: string;         // 平均成交价
  remainingQty: string;     // 剩余未成交量

  // === 手续费 ===
  totalFee: string;         // 累计手续费
  feeAsset: string;         // 手续费币种
  feeRole: "MAKER" | "TAKER";

  // === 杠杆（保证金交易） ===
  leverage: number;         // 杠杆倍数
  marginType: "CROSS" | "ISOLATED";
  frozenMargin: string;     // 冻结保证金

  // === 时间 ===
  createdAt: number;        // 创建时间戳 ms
  updatedAt: number;        // 最后更新时间戳 ms
  expireAt: number;         // GTT 过期时间

  // === 版本控制 ===
  version: number;          // 乐观锁版本号
}

Trade（成交记录）数据模型

interface Trade {
  tradeId: string;          // 全局唯一成交 ID
  symbol: string;
  price: string;            // 成交价格
  quantity: string;         // 成交数量
  quoteQty: string;         // 成交额 = price * quantity

  // === 买卖双方 ===
  buyOrderId: string;
  buyUserId: number;
  sellOrderId: string;
  sellUserId: number;

  // === 角色 ===
  buyerIsMaker: boolean;    // true = 买方是 Maker

  // === 手续费 ===
  buyFee: string;
  buyFeeAsset: string;
  sellFee: string;
  sellFeeAsset: string;

  // === 时间 ===
  tradeTime: number;        // 成交时间戳 ms
  sequenceId: number;       // 撮合引擎内部序列号
}

3. 限价单完整流程

限价单（Limit Order）是最核心的订单类型：指定价格和数量，只在等于或优于指定价格时成交。

关键细节

4. 市价单完整流程

市价单（Market Order）不指定价格，以当前最优价格立即成交，不会进入订单簿。

市价单 vs 限价单

5. 止损单触发流程

止损单不立即进入撮合，而是在市场价到达触发价时被激活为普通限价单或市价单。

6. IOC / FOK / Post-Only

时间有效性策略（Time in Force）决定未成交部分的处理方式。

撮合引擎中的实现

function matchOrder(order):
  // FOK: 先检查流动性
  if order.timeInForce == "FOK":
    if !hasEnoughLiquidity(order): return reject(order)

  // Post-Only: 检查是否会 Taker
  if order.postOnly:
    if wouldMatchImmediately(order): return reject(order)
    return addToBook(order)  // 直接挂单

  // 正常撮合
  trades = executeMatching(order)

  // IOC: 撤销剩余
  if order.timeInForce == "IOC" and order.remainingQty > 0:
    cancelRemaining(order)
    return

  // GTC: 挂入订单簿
  if order.remainingQty > 0:
    addToBook(order)

7. 大单拆解成交

大额订单在撮合引擎中会逐价位消耗对手盘，产生多笔成交记录。这不是预先拆分子单，而是在撮合过程中自然拆解。

成交明细

// 大单拆解过程（10 BTC 市价买入）

Trade #1: price=42000, qty=3, amount=126,000  → 累计 3/10
Trade #2: price=42050, qty=2, amount= 84,100  → 累计 5/10
Trade #3: price=42100, qty=4, amount=168,400  → 累计 9/10
Trade #4: price=42200, qty=1, amount= 42,200  → 累计 10/10

总成交额: 420,700 USDT
平均成交价: 42,070 USDT
滑点: (42,070 - 42,000) / 42,000 = 0.167%

// 订单状态变化:
NEW → PARTIALLY_FILLED (trade#1)
    → PARTIALLY_FILLED (trade#2)
    → PARTIALLY_FILLED (trade#3)
    → FILLED           (trade#4)

大单拆解模拟

拖动滑块调整订单大小，观察大单如何逐价位消耗卖盘:

8. 撤单完整流程

9. 平仓流程

平仓是杠杆/合约交易中关闭持仓的操作。现货中等价于反向卖出持有的资产。

10. 订单 ID 生成策略

11. 并发与幂等保障

附: 手续费计算器

输入成交金额、选择角色和 VIP 等级，实时计算手续费: