一、高频问题
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，以免造成不必要的损失。