合约交易系统设计

1. 合约交易总览

2. 保证金模型

保证金计算公式

// === 初始保证金 (开仓时需要) ===
initialMargin = notionalValue / leverage
notionalValue = quantity * entryPrice           // USDT-M
notionalValue = quantity * contractSize / entryPrice  // COIN-M

// 例: BTC 价格 42000, 买入 1 BTC, 10x 杠杆
// initialMargin = (1 * 42000) / 10 = 4,200 USDT

// === 维持保证金 (低于此值触发强平) ===
maintenanceMargin = notionalValue * maintenanceMarginRate
// maintenanceMarginRate 按档位递增:
//   < 50,000 USDT:   0.4%
//   < 250,000 USDT:  0.5%
//   < 1,000,000 USDT: 1.0%
//   ...

// === 保证金率 ===
marginRatio = (margin + unrealizedPnL) / maintenanceMargin
// marginRatio < 100% → 触发强平

// === 开仓冻结 ===
frozenAmount = initialMargin + openFee + closeFeeReserve
// 预留平仓手续费，确保有足够资金平仓

// === 逐仓 vs 全仓 ===
// 逐仓: margin 固定，只看单个仓位
// 全仓: margin = accountBalance - 其他仓位initialMargin + 所有unrealizedPnL

保证金计算器

调整杠杆、价格和数量，实时查看保证金需求和强平价格:

3. 仓位管理

仓位操作逻辑

// === 开仓 ===
function openPosition(userId, symbol, side, qty, price, leverage):
  margin = (qty * price) / leverage
  freeze(userId, margin + fees)
  position = {
    userId, symbol, side,
    quantity: qty,
    entryPrice: price,
    margin,
    leverage,
    liquidationPrice: calcLiquidationPrice(side, price, leverage)
  }

// === 加仓 (同方向) ===
function addToPosition(position, addQty, addPrice):
  newQty = position.quantity + addQty
  // 更新加权平均入场价
  position.entryPrice = (position.quantity * position.entryPrice
                         + addQty * addPrice) / newQty
  position.quantity = newQty
  position.margin += (addQty * addPrice) / position.leverage
  position.liquidationPrice = recalcLiquidationPrice(position)

// === 减仓 / 平仓 ===
function reducePosition(position, closeQty, closePrice):
  // 已实现盈亏
  if position.side == 'LONG':
    pnl = (closePrice - position.entryPrice) * closeQty
  else:
    pnl = (position.entryPrice - closePrice) * closeQty

  // 释放保证金
  releasedMargin = position.margin * (closeQty / position.quantity)
  returnToUser(releasedMargin + pnl - closeFee)

  position.quantity -= closeQty
  position.margin -= releasedMargin
  if position.quantity == 0:
    deletePosition(position)

// === 强平价格计算 ===
// LONG: liqPrice = entryPrice * (1 - 1/leverage + mmr)
// SHORT: liqPrice = entryPrice * (1 + 1/leverage - mmr)
// mmr = maintenanceMarginRate (维持保证金率)

4. 标记价格与指数价格

5. 资金费率

// === 资金费率计算 ===
premiumIndex = (contractPrice - indexPrice) / indexPrice
interestRate = 0.01%  // 固定利率（可配置）

// clamp 限制在 [-0.05%, 0.05%] 范围内
fundingRate = premiumIndex + clamp(interestRate - premiumIndex, -0.0005, 0.0005)

// 最终 fundingRate 限制在 [-0.75%, 0.75%]
fundingRate = clamp(fundingRate, -0.0075, 0.0075)

// === 结算 ===
// 例: 持仓 10 BTC, MarkPrice = 42000, fundingRate = 0.01%
// payment = 10 * 42000 * 0.0001 = 42 USDT
// 如果 fundingRate > 0: 多头支付 42 USDT, 空头收到 42 USDT
// 如果 fundingRate < 0: 空头支付, 多头收到

// === 结算时机 ===
// 只对结算时刻有持仓的用户收/付
// 结算前 15 秒冻结开仓（防止套利）
// 结算后立即解冻

资金费率计算器

调整合约价格与指数价格的差值，观察资金费率如何变化:

6. 强平引擎

强平流程详解

// === 强平检测（每次 markPrice 更新） ===
function checkLiquidation(position, markPrice):
  notional = position.quantity * markPrice
  unrealizedPnL = calcUnrealizedPnL(position, markPrice)
  maintenanceMargin = notional * getMMRate(notional)

  // 逐仓
  if position.marginType == 'ISOLATED':
    marginRatio = (position.margin + unrealizedPnL) / maintenanceMargin
    if marginRatio < 1.0:
      triggerLiquidation(position)

  // 全仓
  else:
    accountEquity = getAccountBalance(position.userId)
                  + getAllUnrealizedPnL(position.userId)
    totalMM = getAllMaintenanceMargin(position.userId)
    if accountEquity < totalMM:
      triggerLiquidation(position)  // 按亏损最大的仓位优先

// === 强平订单 ===
function triggerLiquidation(position):
  liquidationOrder = {
    userId: SYSTEM,
    side: opposite(position.side),
    quantity: position.quantity,
    type: 'MARKET',
    isLiquidation: true,
    priority: MAX,  // 最高优先级
    bankruptcyPrice: calcBankruptcyPrice(position)
  }
  submitToMatchingEngine(liquidationOrder)

// === 破产价格 ===
// LONG: bankruptcyPrice = entryPrice * (1 - 1/leverage)
// SHORT: bankruptcyPrice = entryPrice * (1 + 1/leverage)
// 实际成交价优于破产价 → 余额归保险基金
// 实际成交价差于破产价 → 保险基金补差额

7. 自动减仓 (ADL)

当保险基金不足以覆盖强平损失时，系统自动减仓（Auto-Deleveraging）盈利最多的对手方仓位。

8. 保险基金

9. 风控系统

10. 现货 vs 合约差异

┌──────────────┬────────────────────┬────────────────────────┐
│     维度      │      现货交易       │       合约交易          │
├──────────────┼────────────────────┼────────────────────────┤
│ 资产          │ 实际持有币种         │ 合约(虚拟资产)          │
│ 方向          │ 只能买入/卖出        │ 做多/做空              │
│ 杠杆          │ 1x (无杠杆)         │ 1x-125x              │
│ 保证金        │ 全额支付            │ 按杠杆缴纳保证金        │
│ 到期日        │ N/A                │ 永续无到期/交割有到期    │
│ 资金费率      │ 无                  │ 每 8 小时结算          │
│ 强平          │ 无                  │ 保证金率低于阈值触发    │
│ 盈亏          │ 卖出时结算           │ 实时未实现 + 已实现     │
│ 账户          │ 现货账户            │ 合约账户(独立)          │
│ 手续费        │ Maker/Taker         │ Maker/Taker + 资金费率 │
│ 冻结          │ 买冻USDT/卖冻BTC    │ 冻保证金 + 预留费用     │
│ 结算          │ 即时交割            │ PnL + 保证金释放       │
│ 风控          │ 余额校验            │ 保证金率 + 强平 + ADL   │
└──────────────┴────────────────────┴────────────────────────┘

11. 合约订单完整流程