Skip to main content
即刻安装 Cobo WaaS Skill，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀
本文介绍了在使用 Cobo WaaS 2.0 API 时可能遇到的常见错误码和 HTTP 状态码，以及如何解决这些错误。

​
错误码

错误码描述解决方案
1000内部服务器错误。此错误可能由多个问题引起，包括Org Access Tokens过期。检查您的服务器配置设置，包括 Org Access Tokens 是否已过期，然后稍后重试。
1003, 2003请求中缺少一个或多个必填参数。提供所有必填参数。
1006, 2006一个或多个参数格式无效或包含不支持的值。以预期格式提供有效参数。
12002Cobo 不支持指定的代币。选择支持的代币。调用 List supported tokens 接口获取完整的支持代币列表。
12007, 30012余额不足，无法执行请求的操作。确保源地址有足够的余额支付转账金额。
12009, 30001重复的请求 ID。使用唯一的请求 ID。
12025在 included_utxos 或 excluded_utxos 中指定的 UTXO 无效。验证 included_utxos 或 excluded_utxos 中指定的 UTXO。
2000处理过程中发生内部错误。请稍后重试。
2021请求处理程序缺失或未实现。为请求提供有效的处理程序。
2024API Key 认证失败。
  • 请使用与当前环境对应的 API Key（例如开发环境使用开发 API Key，生产环境使用生产 API Key），避免混用不同环境的 API Key。
  • 请确保 API Key 已在 Cobo Portal 创建并状态为活跃中（如提示 “Api key is not activated”，请先完成 API Key 创建与通过审批）。
  • 如果您的 API Key 是永久的，请确保请求来自白名单 IP 地址（如有配置 IP 限制）。
详情请参见注册 API 密钥。
2025, 4001禁止访问请求的资源。
  • 检查与您的 API Key 关联的权限（API 权限、钱包范围、可操作资源范围）。您可以参考权限和钱包范围获取详细信息。
  • 如果报错与“角色”相关（例如创建提币、发起交易等），请确认操作用户具备对应角色（例如提币通常需要 Spender 或 Admin）。
  • 如果错误信息包含 “Resource out of organization (4001)”，通常表示您请求的资源（例如 wallet_id）属于另一个组织，不属于当前 API Key 所在组织。
  • 如果权限已授予仍报错，请检查是否混用不同环境（Dev/Prod）的 API Key 或调用了错误环境的 API 域名。
  • 对于全托管钱包相关接口，请确认已在“全托管钱包设置”的上一级范围正确授予权限（部分接口需要在上级范围勾选权限）。
  • 如果是新开通/特定能力接口（例如地址簿等），请确认对应能力已启用或已完成必要的白名单/开关配置。
  • 如果涉及链/资产权限（例如添加某条公链后仍提示权限不足），请确认已在套餐/配置中启用对应公链或能力。
2026请求过多。请稍后重试。
2028未找到请求的资源。检查请求 URL。
2029提供的状态属性无效。为状态属性提供有效值。
2050, 2052无可用的套餐，或已超出使用限制。购买套餐或升级现有套餐。更多信息，请参见账单和付款介绍。
2051当前套餐已过期。续订您的套餐以继续使用服务。更多信息，请参见账单和付款介绍。
30007金额无效。该值不是有效数字或不符合所需格式或范围。提供符合预期格式和范围的有效金额。
30008绝对金额无效。金额的绝对值太小、太大，或在需要非零值时为零。确保金额的绝对值满足所需条件。
30010提供的金额低于尘埃阈值。金额太小，无法处理或转账。增加金额以超过尘埃阈值。
30011提供的金额低于最低充币阈值。增加充币金额以满足最低阈值。
30013余额不足以支付所需的交易费用。确保源地址有足够的余额支付交易费用。
30014目标地址无效。提供有效的目标地址。
30023（此错误仅适用于交易所钱包）交易账户类型无效。提供有效的交易账户类型。
30032（此错误仅适用于 MPC 钱包）无效的私钥分片持有者组。检查是否已配置有效的主控组或签名组。
60010指定的代币尚未为此团队启用。为您的团队启用该代币。

​
HTTP 状态码

状态码描述解决方案
200成功。不适用
400错误请求。检查请求参数。
401未经授权。检查 API Key 是否属于当前环境（Dev/Prod）、API 签名是否正确、timestamp 是否有效且与签名参与字段一致。
403禁止访问。
  • 优先查看响应体中的业务错误码（例如 2025/4001）并按对应错误码的解决方案排查权限、角色、资源范围与组织归属。
  • 如通过反向代理/网关访问 API，请检查代理侧策略、出口公网 IP、WAF/防火墙规则以及是否对请求头/路径做了拦截或重写（例如 Cloudflare/Nginx）。
  • 如某些接口需要能力开通/白名单，请确认对应能力在目标环境已启用。
  • 如与交易风控相关（例如自动审核/策略导致操作被拒绝），请检查风控规则与策略配置是否允许该类 API 操作。
404未找到。检查请求 URL。
405方法不允许。使用支持的 HTTP 方法。
406不可接受。确保请求内容格式为 JSON。
429请求过多。降低请求频率并稍后重试。
500内部服务器错误。此错误可能由多个问题引起，包括 Org Access Tokens 过期。检查您的服务器配置设置，包括 Org Access Tokens 是否已过期，然后稍后重试。
502错误网关。检查连接并稍后重试。
503服务不可用。稍后重试。