Overview - 中文

交易流程图

1828

交易所或者钱包等合作机构需要提供系列webhook API,给LG调用。

交易所服务器需要设置IP地址白名单,确保这些内部API不会被未授权服务调用。

1. 用户余额查询API - /balances

提供一个API给LG,LG可以通过该API查询某个用户的某资产的余额,以决定用户是否有充足余额进行OTC交易。

如果用户在LG买币,币的余额会增加(例如10 BTC),但我们不允许其出售。我们只出售用户在交易所钱包中的币。LG会尽快把用户买到的币打到交易所,并将其在LG中的余额清零。

2. 用户交易发起通知API - /trade-notify

用户发起一笔OTC交易后,LG会调用本API,通知交易所,提交用户UID以及交易细节。

交易所收到通知后,判断用户是否卖币。

如果是卖币,需要立即锁定用户的数字货币,并返回API请求结果。

如果锁定成功,LG执行交易。

提示:如果用户出售数字货币,交易前必须锁定用户的币,否则用户可能会卖币给LG,同时在交易所通过市价单再卖出一次(双花风险)。交易所需要确保锁币机制有效。

3. 用户交易结果通知API - /trade-execute

LG执行交易后,

  • 如果交易成功,LG通知交易所。交易所划转用户的币到Legend在交易所的钱包中(站内划转,实时完成)。

  • 如果交易失败,LG通知交易所。交易所解锁用户的币。

4. 用户KYC状态通知API - /kys-status

当用户的KYC身份验证状态改变时,LG会发送通知。

此API为可选,非必需。