交易流程图

交易所或者钱包等合作机构需要提供系列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为可选,非必需。
