一、高頻問題
Q1：添加了提現地址到白名單仍無法提現
問題原因：
（1）提現頁面白名單與API提現白名單是獨立的
（2）在【提現頁面】>【提現地址管理】添加的地址，不適用於API提現
解決方案：
（1）訪問 API提現白名單管理頁面：https://www.coinex.com/apikey
（2）將提現地址添加到API專用白名單
Q2：access_id not exist 報錯處理
常見原因：
（1）新建的API key需要10分鐘左右生效，生成後立刻調用有可能會觸發報錯
（2）錯誤的access_id
（3）錯誤的簽名驗證
（4）Request header有誤
解決方案：
（1）可點擊前往CoinEx API使用說明文檔了解如何構建http認證請求
（2）demo：
Q3：3008/4001 service unavailable 報錯處理
常見原因：服務器高負載時，撤銷訂單可能會出現3008報錯。
解決方案：
（1）優先撤銷重要訂單
（2）等待1-2秒後重試
（3）若返回code 0，但訂單未撤銷：：
- 記錄完整請求響應
- 聯繫客服並提供主/子賬戶信息進行排查
Q4：Invalid Parameter 報錯處理
常見原因：一般由於上傳的參數和文檔中規定的參數類型不符導致。
解決方案：以POST/spot/cancel-order接口舉例，
（1）嚴格對照API文檔的參數名和類型
（2）特別注意數字/字符串類型差異
Q5：限頻規則是什麼？
根據用戶維度，限頻機制分為短週期限頻和長週期限頻，可通過Response Header進行區分：
1、短週期限頻：如X-RateLimit-Limit返回值大於0，表示未觸發短週期限頻。
短週期限頻基於分組的令牌桶機制，主賬戶和子賬戶分別獨立限頻。
- 觸發後常見報錯：code: 213, 4213
- 錯誤信息：Please don't try too frequently
2、長週期限頻：如返回X-RateLimit-LongPeriod-{period}-Remaining，則說明已觸發長週期限頻。
系統會基於用戶的請求和請求質量進行評估，決定是否對其在較長週期內的請求總量進行限制，觸發後，除撤單相關接口外，其他接口的請求速率將被限制為1次/秒。
- 觸發後常見報錯：code: 213, 4213，但需要根據Response Header返回值進一步判斷。
- 錯誤信息：Please don't try too frequently
二、其他常見問題
Q1：如何降低API請求延遲？
服務器部署在AWS Tokyo，服務已設置跨區域負載平衡，可以選擇靠近的區域實現低延遲。
Available zones
ap-northeast-1a
ap-northeast-1c
ap-northeast-1d
Q2：API提現是否需要2FA驗證？
出於安全因素考慮，使用API提現前，必須在登錄狀態下使用2FA授權並添加提現地址到【提現白名單】，添加成功後，可直接發起API提現，無需2FA做二次驗證。
Q3：是否可以通過API添加提現白名單地址？
目前不支持通過API添加提現白名單地址，請前往【API管理】>【提現白名單】手動添加或批量添加。
Q4：Signature incorrect 報錯如何處理？
（1）檢查access_id和secret_key配置是否正確；
（2）檢查請求體與簽名的參數是否不同，對請求參數進行字符串預處理，校驗處理前、後參數是否一致；
（3）檢查是否使用第三方庫進行簽名，如有，確保庫已正確配置。
Q5：遇到"Tonce check error, correct tonce should be within one minute of the current time" 的報錯，應該如何排查？
（1）確認所有API請求的時間戳單位是否為毫秒級；
例：
（2）確認是否已開啟電腦的自動同步時間的設置。
Q6：如何獲取合約賬戶的實際可用餘額與賬戶淨值？
（1）/assets/futures/balance接口中的available字段是當前合約賬戶的可用餘額；
（2）API接口暫不支持返回賬戶淨值，合約賬戶淨值是已實現與未實現盈虧的總和；
（3）未實現盈虧非固定值，會根據倉位變化浮動，需要手動計算獲取精準數值；
（4）計算公式請參考《正向合約賬戶權益和盈虧計算》。
Q7：如何處理Websocket接口返回的數據？
Websocket接口，返回的數據是壓縮過的json string data，必須解壓後使用（如gzip模塊）。
常見報錯：utf-8' codec can't decode byte 0x8b in position 1: invalid start byte
Q8：第三方報稅平台提示報錯該怎麼辦？
目前v1的服務已於2024年9月25日下線，可能是對應平台沒有更新他們的代碼至v2。
如有更多問題，請聯繫相關報稅平台諮詢。
Q9：使用Websocket，如何知道是否成功連接？
當成功訂閱時，首先會收到訂閱結果響應，隨後收到訂閱的消息推送。
Websocket正常響應的統一結構示例：
Q10：Websocket連接為何自動斷開？ 如何保持連接狀態？
（1）Websocket連接斷開一般是網絡原因，請排查網絡連接是否正常；
（2）保持Websocket連接，需要調用server.ping設置保活；
（3）若1分鐘內未與服務器通信，Websocket連接將自動斷開，建議通過ping接口設置60秒內的發信間隔，以維持連接活躍。
如果遇到其他API報錯，請點擊這裡聯繫客服，並提供以下信息以供核實問題：
（1）請求的主賬戶郵箱/子賬戶名
（2）完整的請求、響應
注意：請勿發送報錯信息中的access_id和secret_key，以免造成不必要的損失。