Trade 流程

本流程描述了用户通过平台进行法币与加密资产交易的完整过程,重点说明与交易所通过 Webhook 进行实时交互的核心环节。


一、核心 Webhook 交互概览

交易流程中,平台与交易所通过以下 Webhook 实现实时同步:

  • /trade-notify:交易发起时通知交易所
  • /trade-execute:交易执行后返回结果
  • /balances:实时查询用户在交易所的资产余额

二、交易流程与 Webhook 调用节点

1. 交易发起阶段

用户选择交易类型(买入/卖出)并确认报价后,平台调用 /trade-notify 通知交易所交易已发起。

2. 买入(Buy Crypto)流程

  • 平台校验用户法币余额
  • 余额充足时,调用 /trade-notify 通知交易开始,获得用户钱包地址。
  • 交易执行后,通过 /trade-execute 接收交易结果

3. 卖出(Sell)流程

  • 平台调用 /balances 查询用户在交易所的加密资产余额
  • 余额充足时,交易所冻结对应资产
  • 调用 /trade-notify 发起卖出交易
  • 交易完成后,通过 /trade-execute 接收结果:
    • 若成功:资产从用户钱包转入平台托管钱包
    • 若失败:资产解冻,交易终止

三、交易状态

所有交易最终均进入明确状态:

  • succeeded:交易成功
  • failed:交易失败
  • canceled:交易取消
  • in_progress:进行中

每个状态变更均通过对应 Webhook 确保双方系统实时同步。