WEEX API 现已支持划转与提现

功能亮点

• 新增独立权限管理： API Key 新增划转和提现权限，可根据实际需要灵活开启。
• 便捷的账户划转： 支持同一 UID 下资金账户、现货账户与合约账户之间的资产划转。
• 安全的链上提现： 支持通过 API 发起链上提现，并通过 IP 白名单、地址管理簿及 24 小时安全冻结机制保护资产。
• 支持 Travel Rule 合规要求： 当用户所属国家、地区或 WEEX 法律实体需要执行 Travel Rule 时，需在提现请求中同步提交收款人及目标钱包信息。
• 权限变更即时生效： API Key 被删除、禁用，或对应权限被关闭后，相关划转或提现能力将立即失效。

适用对象

本次更新适用于需要通过程序自动管理资金的专业交易者、量化团队、机构用户和 API 开发者，包括：

• 需要在不同 WEEX 账户之间自动调配资产的用户；
• 需要通过 API 执行链上提现的用户；
• 需要将资金管理流程接入内部系统或自动化策略的团队。

如何使用 API 划转与提现功能

1. 开启 API 权限

登录 WEEX 官网并进入 API 管理页面。创建新的 API Key，或编辑已有 API Key，然后根据需要开启：

• 允许划转： 在同一 UID 的资金账户、现货账户和合约账户之间划转资产。
• 允许提现： 通过 API 发起链上提现。

存量 API Key 不会自动获得以上权限。如需使用，请手动编辑 API Key 并开启对应权限。

开启“允许提现”权限时必须绑定 IP 地址。如果未绑定 IP 地址，将无法保存该权限设置。

2. 使用账户划转

开启“允许划转”权限后，调用资金划转接口，即可在同一 UID 下的受支持账户之间划转资产。

如果 API Key 未持有划转权限，请求将因权限不足而失败。

3. 使用链上提现

开启“允许提现”权限后，调用链上提现接口发起提现。

通过 API 提现时，请注意以下安全要求：

• 提现地址、币种、网络及 memo/tag 组合必须已存在于 WEEX 地址管理簿中；
• 每次创建带有提现权限的 API Key，该API Key的提现能力将在 24 小时后生效；
• 为已有 API Key 新增提现权限后，该API Key的提现能力将在 24 小时后生效；
• 首次绑定 IP 或修改 IP 地址后，该 API Key 的提现能力将冻结 24 小时，交易和划转等其他权限不受影响；
• 在地址管理簿新增地址后，该地址的 API 提现能力将在 24 小时后生效；
• 同一提现地址信息删除后重新添加，也将重新进入 24 小时冻结期；
• 同一提现地址、币种及网络组合，每 10 秒最多提交一次提现请求；失败或取消的请求同样计入频率限制。

以上地址冻结规则仅适用于 API 提现，不影响用户通过 WEEX 官网手动发起提现。

4. 提交 Travel Rule 信息

部分国家、地区或 WEEX 法律实体需要执行 Travel Rule。发起提现前，可按以下流程处理：

1. 调用Travel Rule状态查询接口，查询当前 KYC 国家或地区是否需要填写 Travel Rule 信息。
2. 根据实际收款方及目标钱包类型准备相关信息。如提现至其他交易所平台，可调用查询提现支持的平台列表接口, 找到对应平台名称，并按接口返回的格式填写 vaspName。
3. 调用链上提现接口发起链上提现；当系统判定需要执行 Travel Rule 时，请在请求参数中同时提交 Travel Rule 问卷。

注意：

• 填写Travel Rule信息时，请根据实际提现场景选择收款人为本人或他人，以及目标地址为私人钱包或交易所地址。如向他人提现，需要提供相应的收款人信息；如提现至交易所地址，还需要填写收款平台名称。
• 如果当前用户无需执行 Travel Rule，可不提交问卷；即使提交，也不会改变服务端的合规判断。
• 如果当前用户需要执行 Travel Rule，但未提交问卷，或提交的信息不完整、不符合要求，提现请求将被拒绝，且不会创建提现订单。

立即体验

WEEX API 划转与链上提现功能现已上线。登录 WEEX 官网，前往 API 管理页面创建或编辑 API Key，开启所需权限，即可开始使用。

使用提现功能前，请确保该API Key已完成 IP 地址绑定、提现地址管理及必要的 Travel Rule 信息准备。有关调用方式和最新要求，请参阅WEEX API 文档。

常见问题解答

Q: 哪些账户类型支持通过 API 划转资产？

用户可以在同一 UID 下的资金账户、现货账户和合约账户之间划转资产。不同 UID 之间暂不支持通过该功能划转。

Q: 使用划转和提现功能需要开启哪些权限？

使用账户划转功能，需要为 API Key 开启 TRANSFER（划转）权限；使用链上提现功能，需要开启 WITHDRAW（提现）权限。

如果 API Key 未持有对应权限，相关请求将因权限不足而失败，不会进入资金操作流程。

Q: 已有的 API Key 会自动获得划转和提现权限吗？

不会。存量 API Key 默认不会自动开启划转或提现权限。用户需要进入 API 管理页面，手动编辑 API Key 并开启所需权限。

Q: 开启提现权限必须绑定 IP 地址吗？

是。开启提现权限的 API Key 必须绑定 IP 地址。如果用户未绑定 IP 地址并尝试保存，系统将提示并要求绑定IP地址。

划转权限不受此项强制要求影响。

Q: 为什么开启提现权限后不能立即通过 API 提现？

为保障资产安全，以下情况会触发 24 小时 API 提现冻结期：

• 创建带有提现权限的新 API Key；
• 编辑已有 API Key并开启提现权限；
• API Key 首次绑定 IP 地址；
• 修改 API Key 已绑定的 IP 地址；
• 在地址管理簿中新增提现地址（仅对于往该地址API提现的能力）；

冻结期间，该API Key的提现功能暂不可用，但交易和划转等其他已授权功能不受影响。

Q:修改 IP 地址后，其他 API 功能还能使用吗？

可以。修改 IP 地址后，仅该 API Key 的提现功能进入 24 小时冻结期。交易、查询和划转等其他已开启的权限仍可正常使用。

Q: API 可以提现至任意链上地址吗？

不可以。通过 API 提现时，目标地址必须已存在于 WEEX 地址管理簿中，并且提现地址、币种、网络及 memo/tag 信息必须完全匹配。

新添加的地址需要等待 24 小时后，才能用于 API 提现。该限制不影响用户通过 WEEX 官网手动提现。

Q: 删除提现地址后重新添加，还需要等待 24 小时吗？

需要。即使重新添加的是相同提现地址、币种、网络及 memo/tag 组合，也会重新触发 24 小时冻结期。

Q: API 提现有哪些频率限制？

同一提现地址、币种及网络组合，每 10 秒最多创建一笔提现请求。失败或取消的请求同样计入防滥用频率限制。

Q: 什么情况下需要提交 Travel Rule 信息？

当用户所属国家、地区或 WEEX 法律实体需要执行 Travel Rule 时，调用方必须在提现请求中提交收款人及目标钱包信息。

发起提现前，可先调用 Travel Rule 国家或地区查询接口确认是否在调用链上提现接口需要填写；

Q: 如果当前用户不需要执行 Travel Rule，是否还要提交问卷？

不需要。travelRuleQuestionnaire 可以不传。

即使调用方提交了问卷，也不能覆盖 WEEX 服务端作出的合规判断。

Q: 需要执行 Travel Rule，但未提交或错误提交问卷会怎样？

如果未提交问卷，或提交的内容、格式不符合 Travel Rule 要求，提现请求将被拒绝，并且不会创建提现订单。

Q: API Key 被禁用或删除后，划转和提现功能是否仍然有效？

不会。API Key 被删除、禁用，或相应的划转或提现权限被关闭后，相关能力将立即失效。

Q: 应调用哪些接口？

根据需要调用以下接口：

• 账户间划转：调用资金划转接口；
• 提现查询是否需要填写 Travel Rule信息：调用 查询Travel Rule状态接口；
• 查询收款平台名字：调用查询提现支持的平台列表接口；
• 发起链上提现：调用链上提现接口。

具体调用方式请参阅 WEEX API 文档。