交易用例

（毕业必需）- 用于 TP/SL 触发或清算的交易通知

通知 必须只在已完成阶段之后发送， 具体地说 在之后 job.deliver() 或 job.deliverPayable())已执行。 原因：

1. 为了让用户及时了解任务的最终状态。

2. 这可确保用户在正确的时间收到进度信息，并避免在结算过程中产生混淆。

交易通知通用规则

使用 job.createPayableNotification()

• 当资金返还时 通过 ACP （卖方代理钱包 → 买方管家钱包）。

• 无需外部 TX 链接 因为可支付通知本身就是链上转账。

使用 job.createNotification()

• 当 没有资金 被转移，目的只是为了在正确的时机向用户更新交易进度。

---

以下是 4 个最常见的场景：

止盈（TP）触发

TP：卖方钱包 → 用户（通过 ACP）

（可支付转账，无需 tx 链接） 可支付通知示例

await job.createPayableNotification(
  `[TP 触发]
您在 ${market.symbol} 上的仓位已在止盈目标价位平仓。

退出价格：${exitPrice}
已实现盈亏：+${pnl} ${quoteCurrency}`，
  new FareAmount(payoutAmount, config.baseFare)
);

---

止损（SL）触发

SL：卖方钱包 → 用户（通过 ACP）

可支付通知示例

await job.createPayableNotification(
  `[SL 触发]
您在 ${market.symbol} 上的仓位因止损触发而已平仓。

退出价格：${exitPrice}
已实现盈亏：${pnl} ${quoteCurrency}`，
  new FareAmount(payoutAmount, config.baseFare)
);

---

仓位被清算（杠杆/保证金）

await job.createPayableNotification(
  `[清算]
由于保证金不足，您在 ${market.symbol} 上的仓位已被清算。

清算价格：${liquidationPrice}
返还剩余余额：${refundAmount} ${quoteCurrency}`，
  new FareAmount(refundAmount, config.baseFare)
);

清算：系统钱包 → 用户

在清算场景中，没有需要返还给用户的资金。该仓位由系统关闭，开发者应使用 createNotification 来通知用户清算事件。

await job.createNotification(
  `[清算]
由于保证金不足，您在 ${market.symbol} 上的仓位已被清算。

清算价格：${liquidationPrice}
返还剩余余额：${refundAmount} ${quoteCurrency}

交易：https://basescan.org/tx/${txnHash}`
);

---

部分 TP/SL 执行

在永续或现货交易系统中，止盈（TP）或止损（SL）订单可能会 部分 成交，这是由于流动性碎片化、订单簿深度或执行优先级所致。

针对部分成交执行的通知必须 不 被视为一条 一次性 消息。

每次 有一部分仓位被平仓并且资金被交付时，都应触发一条新的通知，以更新用户关于最新已成交金额的信息。通知应持续 迭代地 直到仓位达到 最终状态 （全部止盈、全部止损、清算或手动平仓）。

部分 TP 成交：卖方钱包 → 用户（通过 ACP）

await job.createPayableNotification(
  `[部分 TP 触发]
您在 ${market.symbol} 上的仓位有一部分已在止盈价位平仓。

已成交数量：${filledAmount} ${baseCurrency}
成交价格：$${fillPrice}
已实现盈亏：+${realizedPnl} ${quoteCurrency}

剩余仓位：${remainingSize} ${baseCurrency}
剩余名义价值：$${remainingNotional}`，
  new FareAmount(distributedAmount, config.baseFare)
);

---

部分 SL 成交：卖方钱包 → 用户（通过 ACP）

await job.createPayableNotification(
  `[部分 SL 触发]
您在 ${market.symbol} 上的仓位有一部分因止损触发而已平仓。

已成交数量：${filledAmount} ${baseCurrency}
成交价格：$${fillPrice}
已实现盈亏：${realizedPnl} ${quoteCurrency}

剩余仓位：${remainingSize} ${baseCurrency}
剩余名义价值：$${remainingNotional}`，
  new FareAmount(distributedAmount, config.baseFare)
);