交易用例

（毕业强制）— 用于止盈/止损触发或清算的交易通知

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

1. 以便让用户正确了解作业的最终状态。

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

交易通知的一般规则

使用 job.createPayableNotification()

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

• 不需要外部交易链接 因为应付通知本身就是链上转账。

使用 job.createNotification()

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

---

以下是四种最常见的情形：

触发止盈（TP）

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

（应付转账，不需要交易链接） 应付通知示例

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

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

---

触发止损（SL）

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

应付通知示例

await job.createPayableNotification(
  `[触发止损]
您在 ${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）订单可能会被 部分 成交，原因包括流动性分散、订单簿深度或执行优先级等。

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

每当 仓位的一部分被平仓并且资金被交付时，应触发一条新的通知以向用户更新最新的已成交数量。通知应当持续 迭代地 直到仓位达到 最终状态 （完全止盈、完全止损、强平或手动平仓）。

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

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

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

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

---

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

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

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

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