/trade-notify

Legendtrading发起一笔交易时，将通过此接口通知合作平台。平台需根据交易方向（买入/卖出）执行相应操作。

买卖操作流程详细点击这里

如果用户买币，交易所需要返回用户拥有的该币种的钱包地址。例如用户买入1 BTC，交易所返回该用户的BTC钱包地址；

如果用户卖币，交易所冻结用户的币，并等待交易结果，以决定下一步操作。

处理逻辑

交易类型	平台需执行的操作	关键动作
买入 (Buy)	返回指定资产的充值地址	提供用户对应的钱包地址，用于接收来自 Legendtrading的加密货币。
卖出 (Sell)	冻结用户相应的卖出资产	锁定用户账户中的对应资产，等待交易最终执行结果的通知。

响应格式

1. 买入交易 - 成功响应
平台需返回接收资产的存款地址。

{
  "message": "success",
  "data": {
    "message": "Notification received.",
    "uid": "d58e3582afa99040e27b92b13c8f2280",
    "asset": "BTC",
    "deposit_address": "1CK6KHY6MHgYvmRQ4PAafKYDrg1ejbH1cE"
  }
}

2. 卖出交易 - 成功响应
平台需确认资产已被锁定。

{
  "message": "success",
  "data": {
    "message": "Notification received and assets locked."
  }
}

3. 错误响应
当卖出交易无法成功冻结资产时返回。

{
  "error": "Failed to lock assets!"
}

注意：此接口是实现双方交易流程联调的核心，请确保其稳定性和响应准确性。

请求参数说明

参数名	类型	必填	说明	示例值
`uid`	string	是	用户在交易所的唯一标识符	d58e3582afa
`trade_id`	string	是	交易唯一标识符（UUID格式）	987ddf77-a9ad
`trade_status`	string	是	交易状态，必须为 'started'（已发起）	started
`pair`	string	是	交易对	BTCUSD
`side`	string	是	交易方向：`buy`（买入）或 `sell`（卖出）	sell
`quantity`	string	是	数字货币数量（例如：pair为BTCUSD，值1代表1 BTC）	1
`price`	string	是	成交价格	6000
`created`	string	是	交易发起时间（ISO 8601格式）	2020-03-16T11:27:13.675962Z
`size`	string	是	法币金额（例如：pair为BTCUSD，值50代表50 USD）	50
`reference`	string	否	自定义参考信息，将原样返回	-
`trade_source`	string	否	交易来源：`auto_trade`（字段转换交易），`null`或空表示普通交易	auto_trade

说明：

所有时间字段均采用 UTC 时区的 ISO 8601 标准格式
金额与数量字段均以字符串类型传递，确保数值精度
trade_status 在交易启动通知中固定为 started

处理逻辑

响应格式

请求参数说明

200200

400400