> ## Documentation Index > Fetch the complete documentation index at: https://cobo.com/developers/llms.txt > Use this file to discover all available pages before exploring further. # 错误码与状态码 > WaaS 2.0 API 的错误码和状态码列表，包含故障排除建议。 即刻安装 [Cobo WaaS Skill](/developers/v2_cn/guides/overview/cobo-waas-skill)，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀 本文介绍了在使用 Cobo WaaS 2.0 API 时可能遇到的常见错误码和 HTTP 状态码，以及如何解决这些错误。 ### 错误码 #### 通用错误 | 错误码 | 描述 | 解决方案 | | ---------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 1000 | 内部服务器错误。此错误可能由多个问题引起，包括 [Org Access Tokens](/developers/v2/apps/org-access-tokens) 过期。 | 检查您的服务器配置设置，包括 Org Access Tokens 是否已过期，然后稍后重试。 | | 1003, 2003 | 请求中缺少一个或多个必填参数。 | `error_message` 字段会指出具体缺失的参数。请找到该参数，在所调用接口的 API 参考中确认哪些参数为必填，补充后重试。 | | 1006, 2006 | 一个或多个参数格式无效或包含不支持的值。 | `error_message` 字段会指出未通过校验的参数。请在所调用接口的 API 参考中确认该参数的预期类型、格式和允许值，修正后重试。 | | 2000 | 处理过程中发生内部错误。 | 此为 Cobo 侧的临时错误。请稍后重试。如果错误持续出现，请联系 Cobo 支持团队（[help@cobo.com](mailto:help@cobo.com)），并提供响应中的 `error_id` 以便排查问题。 | | 2021 | 请求的 API 接口未实现或当前不可用。 | 请对照 API 参考确认请求路径和 HTTP 方法与目标接口完全一致（多余的斜杠或错误的方法也会返回此错误）。如果均正确，则该接口可能暂时不可用，请采用指数退避策略在短暂延迟后重试。 | | 2024 | API key 认证失败。 | 详情请参见[注册 API 密钥](https://manuals.cobo.com/cn/portal/developer-console/create-api-key)。 | | 2025, 4001 | 禁止访问请求的资源。 | | | 2026 | 请求过多。 | 请降低请求频率并在短暂延迟后重试。对于轮询或批量场景，请实现指数退避策略，例如从 1 秒延迟开始，每次重试翻倍（1 秒、2 秒、4 秒……），直至达到上限。 | | 2028 | 未找到请求的资源。 | 请求中的资源 ID 在您的团队中不存在，或在其他环境中创建。请先列出相关资源以确认正确的 ID（例如，针对 `transaction_id` 调用 [List transactions](/developers/v2/api-references/transactions/list-transactions)），然后使用有效的 ID 重试。同时请确认您调用的环境（开发环境或正式环境）与创建该资源的环境一致。 | | 2029 | 请求中 `status` 参数的值不在允许范围内。 | `status` 参数的允许值取决于具体接口（例如交易状态与筛查状态不同）。请在 API 参考中打开您所调用的接口，提供其请求参数中列出的 `status` 枚举值之一。 | | 10000 | 该团队在 Cobo Portal 中仅有只读权限。 | 您的团队当前为只读访问权限，因此写操作会被拒绝。需由团队管理员登录 Cobo Portal，在团队设置中查看团队的访问状态；只有团队管理员才能更改访问级别。非管理员成员无法更改此设置。 | #### 套餐与计费错误 | 错误码 | 描述 | 解决方案 | | ---- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | 2050 | 该团队没有生效的套餐，计费类 API 操作因此被阻止。 | 请激活套餐：登录 Cobo Portal，打开 **Bills & Payments**，然后选择一个套餐。更多信息，请参见[账单和付款介绍](https://manuals.cobo.com/cn/portal/bills-and-payments/introduction)。 | | 2051 | 该团队的套餐已过期，在续订前计费类操作将被阻止。 | 请续订套餐：在 Cobo Portal 中打开 **Bills & Payments**，续订或选择套餐。更多信息，请参见[账单和付款介绍](https://manuals.cobo.com/cn/portal/bills-and-payments/introduction)。 | | 2052 | 该团队已超出当前套餐包含的用量配额。 | 请等待下一个计费周期重置配额，或在 Cobo Portal 的 **Bills & Payments** 中升级到更高级别的套餐。更多信息，请参见[账单和付款介绍](https://manuals.cobo.com/cn/portal/bills-and-payments/introduction)。 | | 2053 | 当前套餐不包含此操作所需的权益。 | 请在 Cobo Portal 的 **Bills & Payments** 中升级到包含此功能的套餐。更多信息，请参见[账单和付款介绍](https://manuals.cobo.com/cn/portal/bills-and-payments/introduction)。 | | 2054 | 当前套餐的付款已逾期（团队处于欠费状态），套餐因此被暂停。 | 请在 Cobo Portal 的 **Bills & Payments** 中结清欠款以恢复服务。更多信息，请参见[账单和付款介绍](https://manuals.cobo.com/cn/portal/bills-and-payments/introduction)。 | #### 钱包配置错误 | 错误码 | 描述 | 解决方案 | | ---- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 2101 | 钱包名称超过了允许的最大字符长度。 | 钱包名称最多可包含 100 个字符。智能合约钱包的上限为 50 个字符。`error_message` 会指出适用于当前请求的具体上限。请将钱包名称缩短至该上限或以内，然后重试。 | | 2102 | 钱包名称包含无效字符。 | Cobo API 会拒绝包含以下任一字符的钱包名称：`+`、`-`、`=`、`@`。请从钱包名称中移除这些字符后重试。 | | 2103 | 该团队中已存在同名钱包。 | 钱包名称在同一团队内必须唯一。请选择一个未被其他钱包使用的名称后重试。可先列出现有钱包以查看已使用的名称。 | | 2104 | 指定链未在此团队的套餐中启用。 | 如需查看已启用的链，请调用 [List enabled chains](/developers/v2/api-references/wallets/list-enabled-chains) 接口。如需在 Cobo Portal 中启用或禁用链，请参阅[启用或禁用公链](https://manuals.cobo.com/cn/portal/enable-or-disable-chains)。然后使用已在团队中启用的链重试。 | | 2105 | 对于基于 UTXO 的代币（例如 BTC），当前所有可用的 UTXO 已被一笔待处理交易或待 KYT 筛查的交易锁定，新的转账无法进行，直至这些 UTXO 被释放。 | 请调用 [List transactions](/developers/v2/api-references/transactions/list-transactions) 接口（按该钱包筛选）查找正在占用这些 UTXO 的待处理交易。只有当这些交易进入终态（例如已完成或失败）后，UTXO 才会被释放。请在占用交易进入终态后再重试转账。 | #### 转账错误 以下错误码由转账和提币操作返回。 | 错误码 | 描述 | 解决方案 | | ------------ | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 30000 | 未经授权。您没有执行此转账的权限。 | 请检查您的 API Key 关联的权限和钱包范围。详情参见[权限和钱包范围](/developers/v2/guides/overview/permissions-and-scopes)。 | | 30001, 12009 | 该 `request_id` 已被使用。 | 每笔新交易请使用唯一的 `request_id`。重复的 `request_id` 将被拒绝，以防止重复交易。 | | 30002 | 指定的代币不支持此操作或不适用于该团队。 | 请验证 `token_id` 是否正确。调用 [List supported tokens](/developers/v2/api-references/wallets/list-supported-tokens) 接口获取支持的代币完整列表。 | | 30003 | 该钱包类型不支持此转账操作。 | 请使用与所请求转账类型兼容的钱包类型。 | | 30004 | 来源钱包 ID 无效或钱包不存在。 | 请验证 `from_wallet_id` 值是否正确，以及该钱包是否属于您的团队。 | | 30005 | 来源地址格式无效或与该代币不兼容。 | 请提供与该代币类型兼容的有效来源地址。 | | 30006 | 来源地址的编码格式不受支持。 | 请为该代币使用受支持的地址编码格式。 | | 30007 | 金额无效。该值不是有效数字或不符合所需格式或范围。 | 请提供一个正数金额。调用 [Get token information](/developers/v2/api-references/wallets/get-token-information) 接口查询该代币的 `decimal` 精度，并确保金额的小数位数不超过该精度。 | | 30008 | `abs_amount` 的值必须大于 0。 | 请为 `abs_amount` 提供一个大于 0 的正数值。 | | 30009 | 金额不能小于零。 | 请提供非负金额。 | | 30010 | 提币金额低于该代币的最低提币阈值，无法处理。 | 请增加提币金额。调用 [Get token information](/developers/v2/api-references/wallets/get-token-information) 接口获取该代币的 `dust_threshold` 值。 | | 30011 | 充币金额低于该代币的最低充币阈值。 | 请增加充币金额。调用 [Get token information](/developers/v2/api-references/wallets/get-token-information) 接口获取该代币的 `minimum_deposit_threshold` 值。 | | 30012, 12007 | 转账金额超过钱包的可用余额。 | 请检查钱包的可用余额（总余额减去待处理和预留金额）。调用 [Get wallet balance](/developers/v2/api-references/wallets/get-wallet-balance) 接口查询当前余额。 | | 30013 | 手续费代币余额不足，无法支付交易费用。 | 请确保钱包或 Fee Station 中有足够的手续费代币余额（例如 EVM 链上的 ETH）来支付交易费用。 | | 30014 | 目标地址无效或与该代币不兼容。 | 请提供与该代币类型兼容的有效目标地址。 | | 30015 | 目标钱包 ID 无效或钱包不存在。 | 请验证 `to_wallet_id` 值是否正确，以及该钱包是否属于您的团队。 | | 30016 | 交易类别数量超过最大值 5 个。 | 请将 `category_names` 字段中的类别数量减少至 5 个或以下。 | | 30017 | 类别名称超过 30 个字符的最大限制。 | 请将类别名称缩短至 30 个字符或以下。 | | 30018 | 描述超过 100 个字符的最大限制。 | 请将 `description` 字段缩短至 100 个字符或以下。 | | 30019 | 转账被智能合约钱包的链上交易风控规则拒绝。 | 请在 Cobo Portal 中进入 **钱包** > **智能合约钱包** > 目标钱包。在 **链上交易风控** 区域查看 **当前** 中生效的规则；如果您有待生效修改，也请检查 **队列**。确认是否是目标地址、代币或方法被规则拦截，修改对应规则后提交变更，完成所需审批，再重试。 | | 30020 | 该代币不在您的智能合约钱包的链上白名单中。 | 请在 Cobo Portal 中进入 **钱包** > **智能合约钱包** > 目标钱包，在 **链上交易风控** 中编辑控制代币转账的规则，将所需代币加入该规则使用的允许列表或条件。提交规则变更并完成审批后，再重试转账。 | | 30021 | 目标地址不在您的智能合约钱包的链上转账白名单中。 | 请在 Cobo Portal 中进入 **钱包** > **智能合约钱包** > 目标钱包，在 **链上交易风控** 中编辑控制转账的规则，将目标地址加入允许的地址条件。如果该规则引用地址列表，请先进入 **交易风控** > **地址列表** 添加该地址，再返回钱包规则提交变更，完成审批后重试。 | | 30022 | 交易所钱包的转账来源中指定了无效的交易账户类型。 | 请提供有效的交易账户类型作为转账来源。 | | 30023 | 交易所钱包的转账目标中指定了无效的交易账户类型。 | 请提供有效的交易账户类型作为转账目标。 | | 30024 | `to_wallet_id` 和 `to_address` 均未提供。 | 请提供 `to_wallet_id` 或 `to_address` 中的一个作为转账目标。 | | 30025 | 该钱包或代币的提币功能当前不可用。 | 请先在 Cobo Portal 中打开目标钱包，在该钱包的代币或资产列表中找到目标代币，并检查该代币所在行是否提供 **提币** 操作。如果没有 **提币**，则表示当前钱包与代币组合不支持提币。若代币未显示在列表中，请先将代币添加到钱包；若添加过程中提示该代币所属链未启用，请参阅[启用或禁用公链](https://manuals.cobo.com/cn/portal/enable-or-disable-chains)。 | | 30026 | 该钱包的转账功能当前不可用。 | 请在 Cobo Portal 中进入 **钱包** > 与本次请求对应的钱包类型 > 目标钱包，并在钱包详情页确认该钱包当前允许转账。若钱包状态、审批设置或策略配置限制了转账，请先调整对应配置后再重试。 | | 30027 | 目标钱包当前不支持充币。 | 请先确认目标代币已添加到目标钱包，且该代币所属的链已在团队中启用。如需启用或禁用链，请参阅[启用或禁用公链](https://manuals.cobo.com/cn/portal/enable-or-disable-chains)。如果该代币或钱包仍不支持充币，请改用支持充币的目标钱包。 | | 30028 | `request_id` 参数缺失或无效。 | 请在请求中提供有效的非空 `request_id`。 | | 30029 | 交易账户子钱包不能在交易所钱包中发起提币交易。 | 请使用交易所钱包的主账户发起提币，而非交易账户子钱包。 | | 30030 | 无法执行充币或提币操作，因为 Cobo 已临时暂停该代币的充币或提币处理。在暂停解除之前，平台将拒绝相关操作。 | 您无法自行解除该暂停，该状态由 Cobo 侧控制。如需在代币被暂停时收到通知，请在注册 Webhook Endpoint 时订阅 `token.suspended.deposit` 和 `token.suspended.withdraw` 事件：可在 Cobo Portal 注册（参见 [Register a webhook endpoint](https://manuals.cobo.com/cn/portal/developer-console/webhooks-create)，在注册时选择要订阅的事件类型），或调用 [Register webhook endpoint](/developers/v2/api-references/developers--webhooks/register-webhook-endpoint) 操作（`POST /webhooks/endpoints`），并将 `subscribed_events` 设为 `["token.suspended.deposit", "token.suspended.withdraw"]`。暂停解除后，请重试该操作。 | | 30031 | 指定代币尚未在该团队中启用。 | 请先调用 [List enabled tokens](/developers/v2/api-references/wallets/list-enabled-tokens) 接口确认该代币尚未启用。然后在目标钱包中添加该代币；如果添加过程中提示该代币所属链尚未启用，请参阅[启用或禁用公链](https://manuals.cobo.com/cn/portal/enable-or-disable-chains)。完成后再重试。 | | 30032 | 该 MPC 钱包没有可用于签名的私钥分片持有者组。 | 请在 Cobo Portal 中进入 **钱包** > **MPC 钱包** > 目标 Vault > **私钥分片管理**，确认该 Vault 下存在可用于签名的 **主控组** 或 **签名组**。如果两者都不存在，或现有分组不可用，请先在 **私钥分片管理** 中创建或恢复所需分组，再重试交易。 | | 30033 | 收款地址不属于 Cobo，或这些钱包已禁用 Cobo Loop。 | 请确认收款地址是 Cobo 地址，且两个钱包均已启用 Cobo Loop。如需向非 Cobo 地址转账，请使用普通提币方式。 | | 30034 | 交易被智能合约钱包的链上交易风控规则拒绝。 | 请在 Cobo Portal 中进入 **钱包** > **智能合约钱包** > 目标钱包，在 **链上交易风控** 区域检查与该交易类型对应的规则；若规则已在待处理队列中，也请检查 **队列**。调整阻止该交易的具体规则后，提交变更并完成审批，再重试交易。 | | 30035 | 该交易所钱包处于 Observation 模式，仅支持查看余额，不支持提币。 | 请切换到处于 Normal 模式的交易所钱包，或使用其他具备提币权限的钱包。 | | 30036 | Fee Station 余额不足，需要充值后才能继续进行交易。 | 请在 Cobo Portal 中进入 **Fee Station**。您可以在 **美元/美元稳定币** 标签页点击 **充币**，为 Fee Station 充值美元稳定币；也可以切换到 **Gas Token** 标签页，为目标链充值所需的原生 Gas Token。余额到账后再重试交易。 | | 30037 | 来源钱包和目标钱包不符合 Cobo Loop 交易条件。 | 请确认两个钱包均支持 Cobo Loop。不符合条件的钱包请使用普通转账。 | | 30038 | Fee Station 的代币余额不足以支付交易费用。 | 请在 Cobo Portal 中进入 **Fee Station** > **Gas Token**，为本次交易所在网络充值所需的准确原生 Gas Token。待该代币余额充足后再重试交易。 | | 30039 | Cobo 的 Fee Station 余额不足以代付 Gas 费用。 | 此错误由 Cobo 侧临时状况引起，请稍后重试。 | #### 代币与余额错误 | 错误码 | 描述 | 解决方案 | | ----- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | 12002 | Cobo 不支持指定的代币。 | 请选择支持的代币。调用 [List supported tokens](/developers/v2/api-references/wallets/list-supported-tokens) 接口获取完整的支持代币列表。 | | 12025 | 在 `included_utxos` 或 `excluded_utxos` 中指定的 UTXO 无效。 | 请验证 `included_utxos` 或 `excluded_utxos` 中指定的 UTXO。 | | 60010 | 指定的代币尚未在该团队中启用。 | 请在 Cobo Portal 中为您的团队启用该代币。调用 [List enabled tokens](/developers/v2/api-references/wallets/list-enabled-tokens) 接口查看当前已启用的所有代币。 | | 60020 | 指定地址在对应代币和钱包组合下未启用。 | 请确认该地址与您的团队中正确的钱包和代币关联。 | #### 交易管理错误 | 错误码 | 描述 | 解决方案 | | ----- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | | 60001 | 未找到指定的团队。 | 请确认您的 API Key 属于正确的团队，并检查调用的环境是否正确。 | | 60002 | 交易类型无效。 | 请提供以下支持的交易类型之一：`Transfer`、`ContractCall` 或 `MessageSign`。 | | 60003 | 无法估算交易费用。 | 请稍后重试费用估算。如果错误持续出现，请确认该代币受支持，且该链当前已在您的团队中启用。如需在 Cobo Portal 中查看或调整已启用的链，请参阅[启用或禁用公链](https://manuals.cobo.com/cn/portal/enable-or-disable-chains)。 | | 60004 | 未找到待操作的交易记录。 | 请验证 `transaction_id` 值是否正确，并确认该交易存在于您的团队中。 | | 60005 | 交易当前状态不允许取消。 | 请检查当前交易状态。只有处于特定状态（例如 `Pending`）的交易才可以取消。 | | 60006 | 该交易无法被丢弃。 | 该交易处于不允许丢弃的状态，请在重试前检查交易状态。 | | 60007 | 该交易无法加速。 | 该交易处于不允许加速的状态。当交易已确认或处于终态时可能出现此错误。 | #### MPC 钱包错误 | 错误码 | 描述 | 解决方案 | | ----- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | 50000 | MPC Vault 的主控组私钥分片尚未备份。 | 请在 Cobo Portal 中进入 **钱包** > **MPC 钱包** > 目标 Vault > **私钥分片管理**，打开 **主控组**，检查备份状态，并完成所有持有者待完成的私钥分片备份。只有当 **主控组** 显示已完成备份后，才能重试该操作。 | #### 智能合约与 EVM 错误 以下错误码由智能合约钱包和 EVM 合约调用操作返回。 **注意：** 错误码 40001–40003 也会由交易类别操作返回，但含义不同。请根据您调用的接口和 `error_message` 判断适用的含义。 | 错误码 | 描述 | 解决方案 | | ----- | ----------------------- | -------------------------------------------------------------------------------------------------------------- | | 5001 | 合约 ABI 无效或无法解析。 | 请确认 ABI JSON 格式正确且完整。 | | 5002 | 传递给 EVM 操作的一个或多个参数无效。 | 请根据合约 ABI 定义检查参数类型和值。 | | 5003 | 交易 calldata 无效或编码不正确。 | 请确认 calldata 已针对目标函数正确进行 ABI 编码。 | | 5004 | 未找到请求的 EVM 资源。 | 请检查请求中的合约地址和链 ID。 | | 40001 | 外部数据源（例如区块浏览器）的速率限制已达到。 | 请稍后重试。此为上游速率限制导致的临时状况。 | | 40002 | 合约源代码未在区块浏览器上验证。 | 在进行 ABI 相关操作前，请先在相关区块浏览器（例如 Etherscan）上验证合约源代码。 | | 40003 | 指定链不支持该 EVM 操作。 | 请使用受支持的链。如需在 Cobo Portal 中查看团队已启用的链，请参阅[启用或禁用公链](https://manuals.cobo.com/cn/portal/enable-or-disable-chains)。 | #### MFA 错误 以下错误码在 Cobo Guard 多重身份验证（MFA）需要验证或验证失败时返回。 | 错误码 | 描述 | 解决方案 | | ----- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 40201 | 提供的 Cobo Guard 密钥无效或已过期。 | 请在 Cobo Portal 中点击右上角头像，进入 **我的账号** > **安全**。在 **Cobo Guard** 区域，您可以点击 **查看 PubKey 和 TSS Node ID** 核对当前生效的密钥，或点击 **重置** / **设置** 重新绑定新的 Cobo Guard 密钥。更新完成后，请使用新的有效密钥重试。 | | 40202 | Cobo Guard 请求仍在等待处理，尚未完成。 | 请等待 Guard 请求被审批或拒绝后再继续操作。 | | 40203 | Cobo Guard 请求尚无审批或拒绝结果。 | 请检查待处理的 Guard 请求状态，并在重试前完成审批。 | | 40204 | 执行此操作的用户必须与发起 Guard 请求的用户相同。 | 请确保同一用户账号用于发起和完成 Cobo Guard MFA 请求。 | #### 交易类别错误 以下错误码由交易类别管理操作返回。 **注意：** 错误码 40001–40003 也会由 EVM 操作返回，但含义不同。请根据您调用的接口和 `error_message` 判断适用的含义。 | 错误码 | 描述 | 解决方案 | | ----- | -------------- | ---------------------------- | | 40000 | 类别名称超过 30 个字符。 | 请将类别名称缩短至 30 个字符或以下。 | | 40001 | 未找到指定的团队。 | 请确认您的团队 ID 和 API Key 环境正确无误。 | | 40002 | 交易类别数量已达到最大限制。 | 请在创建新类别前删除不需要的类别。 | | 40003 | 团队中已存在同名类别。 | 请使用唯一的类别名称。 | | 40004 | 类别名称包含无效字符。 | 请仅使用允许的字符命名类别。 | #### 合规与 KYT 错误 以下错误码由合规和交易了解（KYT）操作返回。 | 错误码 | 描述 | 解决方案 | | ----- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 40101 | 未找到指定 `transaction_id` 的合规请求。 | 请确认 `transaction_id` 正确，且已针对该交易发起合规检查。 | | 40102 | 合规请求不处于失败状态，无法重试。 | 重试前请检查合规请求的当前状态。只有处于 `Failed` 状态的请求才能重试。 | | 40103 | 该交易不支持此操作（非 EOA/Web3 交易或缺少链上交易 ID）。 | 请确认您提交的请求类型受合规 API 支持。 | | 40104 | 提供的 KYT 处置类型无效。 | 请为 KYT 操作提供有效的处置类型。 | | 40105 | 未找到指定的 KYT 请求。 | 请确认 KYT 请求 ID 是否正确。 | | 40106 | 该 KYT 筛查已存在处置请求。 | 创建新处置请求前，请先检查是否存在已有的处置请求。 | | 40107 | 该 KYT 处置已存在提币请求。 | 创建新提币请求前，请先检查是否存在已有的提币请求。 | | 40108 | 查询 KYT 审计列表时提供的 `status` 过滤值无效。 | 查询 KYT 审计列表时，请使用该接口支持的 `status` 取值。 | | 40109 | 未找到指定 `transaction_id` 的 KYT 筛查请求。 | 请验证 `transaction_id`，并确认已针对该交易发起 KYT 筛查。 | | 40110 | 未找到指定 `screening_request_id` 的 KYT 筛查请求。 | 请确认 `screening_request_id` 值是否正确。 | | 40111 | 该交易的当前状态不允许执行处置操作。 | 发起处置前，请检查该交易的当前状态。 | | 40112 | 为该交易提供的处置参数无效。 | 请核对处置参数，确保与该交易的筛查结果一致。 | | 40113 | 该 KYT 请求已处于处置中或已完成处置，无法重复发起。 | 请勿对同一请求重复发起处置。请先确认该请求当前的处置状态，再决定是否需要后续操作。 | | 40114 | 该交易的当前状态不允许执行解冻操作。 | 尝试解冻前，请检查该交易的当前状态。 | | 40115 | KYT 请求的处置费用无效。 | 请在 KYT 处置请求中同时提供 `estimated_fee_type` 和 `estimated_fee_detail`。当 `estimated_fee_type` 为空，或 `estimated_fee_detail` 为空或无法解析为有效的交易费用对象时，会出现此错误。请参考处置接口的 API 参考确认 `estimated_fee_detail` 的预期结构，然后重试。 | | 40116 | 筛查请求的处置费用无效。 | 请在筛查处置请求中提供非空的 `estimate_transaction_fee` 值。当该字段缺失或为空时，会出现此错误。 | | 40117 | KYT 处置的费用支付方式无效。 | 请将 `fee_payment_method` 设置为以下允许值之一：`CUSTOMER_FEE_STATION`、`CUSTOMER_CURRENT_ADDRESS` 或 `COBO_FEE_STATION`。空值或缺失同样会被拒绝。 | | 40118 | KYT 处置的目标地址无效。 | `to_address` 必须是被筛查交易的原始发送地址之一，或该交易所在链上的有效地址。请提供满足上述条件之一的地址，然后重试。 | | 40119 | KYT 处置过程中发生错误。 | 请确认请求参数正确，然后重试。如果错误持续出现，请在 Cobo Portal 中进入 **审批** > **我发起的** 或 **所有审批**，打开该 KYT 处置请求对应的审批记录，查看其最新状态和失败详情后再决定是否重新提交。 | | 40120 | 筛查请求的处置金额无效。 | 请验证筛查处置请求中的处置金额。 | | 40121 | KYT 请求的处置金额无效。 | 请验证 KYT 处置请求中的处置金额。 | | 40122 | 钱包余额不足以支付处置操作的预估交易费用。 | 请在 Cobo Portal 中进入 **钱包** > 持有该风险资金的钱包类型 > 目标钱包，确认钱包中有足够的原生 Gas 代币支付处置手续费。如果本次处置使用 Fee Station 支付手续费，还需进入 **Fee Station** 确认对应手续费代币余额充足，然后再重试。 | | 40123 | 无法发起处置操作，因为该交易当前未被冻结。 | KYT 处置只能应用于已冻结的交易，请在继续操作前确认交易的当前状态。 | | 40124 | 未找到指定交易哈希对应的合规请求。 | 请确认交易哈希是否正确。 | | 40125 | 未找到指定 `transaction_id` 的 app check 请求。 | 请确认 `transaction_id`，并确认已针对该交易发起合规 app check。 | | 40126 | KYT 筛查完成结果无效或格式错误。 | 请检查 KYT 提供商返回的结果格式。 | #### Travel Rule 错误 以下错误码由 Travel Rule 合规操作返回。 | 错误码 | 描述 | 解决方案 | | ----- | ------------------------- | ----------------------------------- | | 70001 | 发生了通用 Travel Rule 错误。 | 请查看错误信息了解详情，并检查您的 Travel Rule 请求参数。 | | 70002 | 汇款方的 KYC 信息无效或不完整。 | 请提供完整有效的汇款方 KYC 信息。 | | 70003 | Travel Rule 供应商代码无效。 | 请提供有效的供应商代码。 | | 70004 | 汇款方的自然人实体信息缺失或不完整。 | 请补充完整汇款方的所有必填自然人实体信息。 | | 70005 | 汇款方的法人实体信息缺失或不完整。 | 请补充完整汇款方的所有必填法人实体信息。 | | 70006 | 汇款方信息缺失或不完整。 | 请提供所有必填的汇款方信息。 | | 70007 | 填写汇款人信息时发生错误。 | 请查看错误信息了解详情，并核实汇款人信息各字段。 | | 70008 | 该 Travel Rule 操作不支持自托管钱包。 | 此 Travel Rule 操作请使用 Cobo 托管钱包。 | | 70009 | 该记录的汇款方信息已提交。 | 每条记录的汇款方信息只能提交一次，如需更新请查看现有记录。 | | 70010 | 自托管钱包签名验证失败。 | 请确认已针对自托管钱包地址正确生成签名。 | | 70011 | 法人实体信息不完整，存在缺失的必填字段。 | 请提供法人实体的所有必填字段。 | | 70012 | 自然人实体信息不完整，存在缺失的必填字段。 | 请提供自然人实体的所有必填字段。 | | 70013 | 该地址已完成验证。 | 无需进一步操作。地址验证为一次性操作。 | ### HTTP 状态码 | 状态码 | 描述 | 解决方案 | | --- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 200 | 成功。 | 不适用 | | 400 | 错误请求。 | 检查请求参数。 | | 401 | 未经授权。 | 检查 API Key 是否属于当前环境（Dev/Prod）、API 签名是否正确、`timestamp` 是否有效且与签名参与字段一致。 | | 403 | 禁止访问。 | | | 404 | 未找到。 | 检查请求 URL。 | | 405 | 方法不允许。 | 使用支持的 HTTP 方法。 | | 406 | 不可接受。 | 确保请求内容格式为 JSON。 | | 429 | 请求过多。 | 降低请求频率并稍后重试。 | | 500 | 内部服务器错误。此错误可能由多个问题引起，包括 [Org Access Tokens](/developers/v2/apps/org-access-tokens) 过期。 | 检查您的服务器配置设置，包括 Org Access Tokens 是否已过期，然后稍后重试。 | | 502 | 错误网关。 | 检查连接并稍后重试。 | | 503 | 服务不可用。 | 稍后重试。 |