閃兌接入指南
信息
- 所有接口都需要進行鑒權
- API key的權限要求: "兌換"
流程
Step1 查詢兌換幣種列表
- 查詢不同錢包內的支持的兌入兌出幣種列表
- 當查詢兌出幣種列表時, 會有幣種餘額返回
Step2 申請報價
- 選擇兌出幣種, 兌入幣種, 錢包類型, 設定號兌出幣種的數量來獲取報價
- 該階段會核驗餘額
Step3 確認報價
- 在有效時間內確認報價 (15秒). 一旦確認, 系統會處理交易
- 該操作環節是異步的, 所以當餘額被劃轉出去後, 最終兌換可能會失敗
Step4 查詢報價單狀態
在確認報價後, 通過該接口查詢最終報價單的處理狀態
錯誤碼
| 錯誤碼 | 消息 | 備註 |
|---|---|---|
| 790000 | system error, please try again later | 系統繁忙 |
| 700000 | parameter error | 參數錯誤 |
| 700001 | quote fail: no deler can be used | |
| 700002 | quote fial: not support quote type | 在提交報價時, requestCoin=兌入幣種, 會返回該錯誤 |
| 700003 | order status not allowed | |
| 700004 | order does not exit | 1. 檢查quoteTxId是否正確; 2. 檢查quoteTxId和accountType是否匹配 |
| 700005 | Your available balance is insufficient or wallet does not exist | |
| 700006 | Low amount limit | 請求的數量小於minFromCoinLimit |
| 700007 | Large amount limit | 請求的數量大於maxFromCoinLimit |
| 700008 | quote fail: price time out | 1. 報價單已經失效; 2.傳入quoteTxId不正確 |
| 700009 | quoteTxId has already been used | 在報價單有效期內, 同一個quoteTxId多次請求確認接口 |
| 700010 | INS loan user cannot perform conversion | |
| 700011 | illegal operation | 當提交報價的是用戶A, 確認報價的是用戶B |
API頻率
| 方法 | 路徑 | 頻率 | 是否可提升 |
|---|---|---|---|
| GET | /v5/asset/exchange/query-coin-list | 100 req/s | N |
| POST | /v5/asset/exchange/quote-apply | 50 req/s | N |
| POST | /v5/asset/exchange/convert-execute | 50 req/s | N |
| GET | /v5/asset/exchange/convert-result-query | 100 req/s | N |
| GET | /v5/asset/exchange/query-convert-history | 100 req/s | N |