跳到主要内容

错误码说明

本节介绍了 CoinW API 中最常见的错误码，包括其含义、可能原因及推荐的解决步骤。

常见错误代码​

500 服务器内部错误（合约）​

{'code': 500, 'msg': 'Internal server error'}

该错误通常出现在请求的接口地址不正确或请求了一个不存在的接口。

排查建议：

  1. 请仔细检查请求的 API 接口地址是否正确。
  2. 重新测试该请求。
  3. 若错误仍然存在，请联系客户支持。

6003 权限不足（合约）​

{'code': 6003, 'message': 'require more permission', 'retry': False, 'success': False}

该错误表示当前使用的 API Key 没有启用所需权限。

排查建议：

​ 1.确认 API Key 是否正确、已激活，并启用了必要的权限。

​ 2.登录 CoinW 用户后台，进入【API 管理】页面。

alt text

​ 3.编辑当前 API Key，启用相应权限（如合约交易、只读、提币等）。

alt text

​ 4.保存更改并重新测试请求。

alt text

​ 5.若问题依旧，请联系客户支持。

402 缺少参数（合约）​

{"code":402, "msg":"param required"}

该错误说明接口请求中缺失了必要参数。

排查建议：

  1. 请查阅所请求接口的 API 文档，确保所有必填字段都已正确填写。
  2. 检查接口地址并重试请求。
  3. 若问题依旧，请联系客户支持。

29001 请求频率过高（合约和现货）​

{ code: 29001, msg: 'API access frequently' }

请求频率超过接口或全局的限制阈值。

排查建议：

  1. 请参考 CoinW 的频率限制说明，适当降低请求频率。
  2. 频率限制文档地址：跳转

-103 用户API出错（现货）​

{code: "-103",data: null, msg: "用户api出错",success: false, failed: true}

可能因为参数非法或签名错误引发该错误。

排查建议：

  1. 校验所有参数名及其取值。
  2. 确认 API Key 和 Secret Key 正确有效。
  3. 检查请求头及签名逻辑。
  4. 如仍有问题，请参考 API 文档中的示例，并联系 CoinW 支持团队。

6001 签名错误（合约）​

{'code': 6001, 'message': 'sign error', 'retry': False, 'success': False}

签名校验失败，通常由于签名算法或参数拼接格式不正确。

排查建议：

  1. 请参考官方 API 文档中签名示例代码。
  2. 确保签名格式符合 CoinW 后台要求。
  3. 若问题依旧，请联系 CoinW 支持团队。

1004 会话无效（合约）​

{""result"":false,""errorCode"":1004, ""errorMsg"":""Invalid session""}

WebSocket 会话过期或无效。

排查建议：

  1. 请重新建立连接或重新进行认证操作。
  2. 如仍有问题，请联系 CoinW 支持团队。

-3 API访问错误，请联系官方（现货）​

{'code': '-3', 'data': None, 'msg': 'API access error, please contact us', 'success': False, 'failed': True}

一个通用的 API 接口访问错误。

排查建议：

  1. 检查请求结构与参数是否符合文档规范并重新尝试。
  2. 若问题持续，请联系 CoinW 支持。

1 系统错误（合约）​

{ "code":1, "msg":"System error" }

平台级别的一般性错误。

排查建议：

  1. 可能由于传入参数与接口文档不一致引起。
  2. 也可能是系统维护导致，请稍后重试。
  3. 若多次尝试无效，请联系 CoinW 支持。

9012 仓位不存在或已平仓（合约）​

{'code': 9012, 'msg': '仓位不存在或已平仓'}

请求操作的仓位不存在或已被平仓。

排查建议：

  1. 请确认传入的仓位 ID 是否正确，若仓位已被平仓，或仓位从未存在，都会返回此错误。
  2. 如您通过 OpenAPI 接口进行操作，请确认该仓位是否为用户自主下单产生，通过跟单系统生成的仓位，无法通过 OpenAPI 接口进行操作，尝试操作将返回此错误。

9111 交易暂停（合约）​

{'code': 9111, 'msg': '暂停交易'}

合约或交易品种暂时关闭，无法交易。

排查建议：

  1. 请关注 CoinW 官方公告，确认是否有维护或下架通知。
  2. 避免对该交易品种继续下单。
  3. 如有必要，可撤销订单并平仓。

429 请求过多（合约和现货）​

{'code': 429, 'message': 'Too Many Requests', 'retry': False, 'success': False}

该错误通常由网关触发，未必由用户请求频率过高导致。

排查建议：

  1. 若遇此错误，请暂停请求并稍后重试。
  2. 建议遵守接口与全局频率限制规则。
  3. 若问题频繁出现，请联系 CoinW 支持。

6000 API 错误（合约和现货）​

{'code': 6000, 'message': 'api error', 'retry': False, 'success': False}

该错误表明 API Key 使用不当或认证失败。

排查建议：

  1. 常见原因为未对私有接口进行签名认证。
  2. 请参考 CoinW API 文档中的认证示例，确保正确实现签名流程。
  3. 确保 API Key 未被禁用或删除。若失效，请重新创建 Key。
  4. 若问题仍然存在，请联系 CoinW 支持团队。

-200 业务异常（现货）​

{'code': '-200', 'data': None, 'msg': '业务异常', 'success': False, 'failed': True}

业务逻辑异常，常出现在系统更新期间。 排查建议：

  1. 请稍后再次尝试。
  2. 若长时间持续报错，请联系客户支持。

排查建议：

9031 您当前下单的金额加上您的持仓已经超过您能买这种合约的最大限制（仅合约）​

{'code': 9031, 'msg': '您当前下单的金额加上您的持仓已经超过您能买这种合约的最大限制'}
  1. 请确认下单数量未超过该合约的最大可持仓限额。
  2. 可通过 “获取所有交易品种保证金要求” 接口查询指定合约的持仓限额。
  3. 在网页端的 “交易规则” 栏目中查看最大持仓限额。

步骤 1： alt text 步骤 2： alt text

如需进一步协助：​

如果以上步骤未能解决您的问题，请联系 CoinW API 支持团队，并提供以下信息，以加快处理速度：

字段描述
现货/合约
API 接口地址
完整的请求命令
请求方法
用户 ID
完整的CoinW回报
时间戳
IP
客户对问题的描述
屏幕截图或日志(如果有)