post
https://exchange.com/api/trade-notify
交易通知，交易发生时，Legendtrading通知交易所。
Legendtrading发起一笔交易时，将通过此接口通知合作平台。平台需根据交易方向（买入/卖出）执行相应操作。
买卖操作流程详细点击这里
如果用户买币，交易所需要返回用户拥有的该币种的钱包地址。例如用户买入1 BTC，交易所返回该用户的BTC钱包地址；
如果用户卖币，交易所冻结用户的币，并等待交易结果，以决定下一步操作。
处理逻辑
| 交易类型 | 平台需执行的操作 | 关键动作 |
|---|---|---|
| 买入 (Buy) | 返回指定资产的充值地址 | 提供用户对应的钱包地址，用于接收来自 Legendtrading的加密货币。 |
| 卖出 (Sell) | 冻结用户相应的卖出资产 | 锁定用户账户中的对应资产，等待交易最终执行结果的通知。 |
请求参数说明
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
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 | 否 | 自定义参考信息，将原样返回，自动转换的交易auto_trade，reference字段为空 | - |
trade_source | string | 否 | 交易来源：auto_trade（自动转换交易），null或空表示普通交易 | auto_trade |
| payment_source | string | 否 | card 信用卡/借记卡,balance 余额，card_google 谷歌Pay，card_apple 苹果Pay |
说明：
- 所有时间字段均采用 UTC 时区的 ISO 8601 标准格式
- 金额与数量字段均以字符串类型传递，确保数值精度
trade_status在交易启动通知中固定为started- 自动转换交易（Auto Trade）说明
当账户余额在 Legend 平台持续存在超过一定时间时，系统会触发自动处理机制：
- 第 23 天：系统会向用户发送提醒通知
- 第 30 天：若账户仍有余额，将自动按市价转换为加密货币 转换规则如下：
- 欧盟用户：转换为 USDC
- 其他地区用户：转换为 USDT 需要注意：
- 自动转换流程与普通交易流程一致
- 若交易执行过程中交易所未能正常响应，交易可能无法完成
- 该功能支持配置为关闭（即不进行自动转换）
Auto Trade 示例流程
以 2026-01-01 充值为例：
- 2026-01-01：资金到账，开始计时
- 2026-01-25（第 24 天）：触发提醒通知
- 2026-02-01（第 30 天）：触发自动转换交易并完成处理 如需关闭自动转换功能或调整规则，请联系平台支持团队。
推送数据示例
{
"created": "2026-01-02T15:52:57.978727Z",
"network": "SOL",
"pair": "USDTUSD",
"payment_source": "card",
"price": "1.04993",
"quantity": "87.0816",
"reference": "cf1396f0c****8b6d488ec0647",
"side": "buy",
"size": "91.43000000",
"trade_id": "553abf****f8f0fe929",
"trade_status": "started",
"uid": "KGkUGvK*****hn4kzroFd7CNAY"
}响应格式
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!"
}注意：此接口是实现双方交易流程联调的核心，请确保其稳定性和响应准确性。