如何创建 WEEX API 密钥:只读权限还是交易权限
如何创建 WEEX API 密钥:只读权限还是交易权限
登录 WEEX 网页端,前往账户 → API 管理创建 API 密钥。新密钥默认设置为只读。如果应用需要进行交易,请选择相应的现货或期货/合约权限。
创建密钥前,请先确定要使用该密钥的应用。余额监控脚本和自动交易策略需要不同的访问权限。根据具体用途选择权限,可让集成更易于管理和排查问题。
应该选择哪种权限?
| 你想执行的操作 | 从哪里开始 |
|---|---|
| 读取公开行情、订单簿或交易所配置 | 公开端点无需账户身份验证,因此你可以不使用密钥直接开始。 |
| 查询余额或私人订单信息 | 创建只读密钥,并确认目标端点的权限要求。 |
| 通过应用执行现货交易 | 配置现货权限。 |
| 通过应用执行合约交易 | 配置期货/合约权限。 |
只读密钥无法下单或撤单。请分别检查现货和合约交易权限;启用其中一项并不代表另一项也可用。现货接入准备指南和期货接入准备指南介绍了相关访问权限。
创建 API 密钥
1. 打开 API 管理。登录后,访问API 管理,或在WEEX API 页面选择创建 API。
2. 填写详细信息并选择权限。按照当前页面的字段提示操作。查询账户信息时保留只读权限;需要交易时,选择相应的市场权限。
3. 设置口令和 IP 绑定。API 口令是你为此密钥设置的访问口令。官方常见问题建议使用字母和数字,不要使用特殊字符。请按照页面要求配置 IP 绑定。
4. 完成安全验证并保存凭证。妥善保存 APIKey、SecretKey 和 Passphrase,然后使用具有相应权限的只读请求验证集成。
字段顺序可能会有所变化,请按照账户中显示的提示操作。如果要连接第三方工具,请在输入凭证前确认该工具申请的权限与你计划使用的功能相符。
APIKey、SecretKey 和 Passphrase 有什么用途?
APIKey 用于标识 API 请求,SecretKey 用于生成请求签名,而 Passphrase 是创建密钥时设置的访问口令。三者用途各不相同。API 口令也不同于账户登录密码。
如果某个工具要求填写“API Password”,请查看该字段的定义。例如,CCXT 的 password 字段应填写 WEEX API 口令。即使 APIKey 和 SecretKey 正确,填写错误也可能导致私人请求无法通过身份验证。
官方文档指出,遗失的口令无法找回;你需要创建新的 API 密钥。创建密钥时,请将凭证保存在受控的服务器环境或密钥管理器中,不要依赖聊天消息、截图或代码中的明文常量。
绑定应用实际使用的 IP
如果应用部署在服务器上,请绑定该服务器发送请求时使用的出站公网 IP。代理、NAT 或云服务可能会改变外部地址,因此服务器的私有 IP 可能与 WEEX 看到的源地址不同。
迁移服务器或更改出站网络时,请重新检查 IP 绑定。普通账户应按照 API 管理页面的要求操作。经纪商终端用户 API 有单独的规则,不应将其 IP 条目数量限制或强制条件套用于所有账户。
两份接入准备指南均指出,每位用户最多可创建 10 组 API 密钥。按应用用途分别创建密钥组,例如一组用于账户监控,另一组用于交易,这样日后更容易替换或停用某个集成。
为什么密钥创建后仍可能无法使用?
请从故障发生的位置着手排查,而不是反复创建替代密钥:
| 现象 | 首先检查 |
|---|---|
| 账户查询正常,但订单操作失败 | 目标市场的交易权限。权限不匹配是出现 -1052 的可能原因之一。 |
| 私人请求身份验证失败 | API 口令、签名、时间戳以及实际使用的出站 IP。 |
| 新创建或修改的密钥暂时无法使用 | 当前常见问题页面给出的典型生效时间约为 15 分钟,但这并非保证期限。 |
| API Restricted 状态持续存在 | 请联系官方客服咨询账户限制,不要反复发送无效请求。 |
如需进一步帮助,请通过官方 API 常见问题页面中的支持链接寻求帮助,并提供发生时间、端点和错误代码。请在日志中隐藏凭证、签名和敏感账户数据。
如果怀疑密钥已泄露,请停止相关集成、删除泄露的密钥、检查账户和订单记录,并创建具有所需权限的替代密钥。