WEEX API怎么申请？从开户到创建API Key完整教程

如果你准备开始做量化交易、交易机器人或者自动化策略，第一步通常不是马上写代码，而是先把交易所的 API 接口接通。对于准备使用 WEEX API 的用户来说，整个流程并不复杂：完成 WEEX 交易所账号准备后，进入网页端的 API 管理页面，创建 API Key，再根据实际使用场景配置权限即可。

WEEX 官方文档目前使用 V3 API，支持现货和 USDT-M 合约等交易场景。API 本身可以用于获取行情、查询账户信息以及进行程序化交易，REST API 和 WebSocket 也分别覆盖了不同的数据与交易需求。

一、申请 WEEX API 前，需要准备什么？

如果只是想创建 API Key，并不需要先搭建一套完整的量化系统。

首先准备一个正常使用的 WEEX 交易所账户，然后通过网页端进入 API 管理页面。WEEX 官方给出的路径是：登录 WEEX 后，进入「账户」→「API管理」，选择创建 API。官网 API 页面也提供了直接创建 API 的入口。

如果你的目的只是获取行情或者做账户数据监控，那么后面创建 API Key 时可以先使用默认的只读权限；如果需要让程序自动下单，则需要根据实际交易品种开启对应的交易权限。

这里有一个比较容易忽略的地方：API Key不是创建出来就默认拥有所有操作权限。

按照 WEEX V3 API 文档，新创建的 API 默认是只读权限。如果需要通过 API 进行现货交易，需要额外勾选 Spot 权限；不同权限之间是独立配置的。

二、WEEX API Key怎么创建？

准备好账户之后，实际操作可以按照下面的路径进行。

第一步，登录 WEEX 网页端。

进入 WEEX 官网并完成账号登录，然后找到「账户」→「API管理」。

第二步，选择创建 API。

进入 API 管理页面后，按照页面提示创建新的 API Key，并完成相应的安全验证。

WEEX 官方 API 页面给出的操作路径也是「账户」→「API管理」→「创建API」，完成安全验证后即可继续。

第三步，设置 API 权限。

这一步不要为了省事直接把所有权限都打开，而应该根据实际用途来选择。

如果只是做行情获取、余额查询、数据同步等操作，可以保持只读权限。WEEX 官方文档对 Readonly 权限的定义就是只能调用查询类接口，不能进行交易。

如果需要让量化程序自动进行现货交易，则需要开启 Spot 权限。对于 USDT-M 合约等其他交易场景，则应根据对应 API 文档配置相应的交易权限。

第四步，设置 Passphrase，并保存 API 凭证。

创建完成后，需要妥善保存 APIKey、SecretKey 和 Passphrase。

其中，APIKey相当于 API 请求中的身份标识，SecretKey用于请求签名，而 Passphrase 则是创建 API 时由用户自行设置的口令。

这里一定要注意：Passphrase 忘记后无法找回，需要重新创建 API Key。 WEEX 官方文档也明确建议用户妥善保存这些信息，不要向其他人透露。

另外，每个用户目前最多可以创建 10 组 API Key。如果你后面同时运行多个策略、机器人或者数据监控程序，可以根据实际需求分别创建不同的 Key，而不是所有程序共用一套凭证。

三、API权限应该怎么选？

对于第一次接触 WEEX API 的用户来说，最容易产生疑问的其实就是这一部分。

简单理解：

只读权限适合行情分析、账户监控、数据同步等场景；
Spot权限适合需要自动执行现货交易的程序。

例如，你只是想先把 WEEX 的行情数据接入自己的程序，测试一下 K 线、订单簿或者账户数据，那么没有必要一开始就开放交易权限。

如果已经准备运行一个现货量化策略，再开启 Spot 权限即可。

这种权限划分的好处在于，API Key的使用范围可以根据实际需求控制，而不是所有程序都必须拥有完整的交易权限。WEEX 官方文档目前明确支持 Readonly 和 Spot 等独立权限配置。

还有一点值得提前说明：API Key本身并不是提现工具。

按照 WEEX 当前 API 权限设计，Readonly 只能查询数据，Spot 权限用于现货交易操作。API权限的核心用途是让程序访问账户数据和执行相应的交易操作，并不是直接通过 API 把账户资产转走。因此，在配置权限时，更重要的是根据实际程序需要控制授权范围。

四、创建API Key时，IP白名单要不要开？

如果你的量化程序会长期运行在固定服务器上，建议把 IP 白名单一起配置好。

WEEX 官方 API 文档明确建议绑定 IP。没有绑定 IP 的 API Key 存在安全风险，因此如果你的策略运行环境比较固定，例如云服务器或者自己的交易服务器，使用固定 IP 后可以进一步限制 API Key 的使用来源。

如果只是临时测试，也可以根据实际情况配置。但对于准备长期运行的自动化交易程序来说，IP限制属于比较值得提前做好的一项基础安全设置。

同时，APIKey、SecretKey 和 Passphrase 都应该保存在安全的环境中，不要直接发布到代码仓库、聊天群或者其他公开位置。如果发现 API Key 存在泄露风险，应尽快删除对应的 Key。

五、创建完成后，下一步怎么接入？

API Key创建成功，并不意味着量化策略就已经可以直接运行了。

接下来通常是把 API 凭证配置到自己的交易程序中，然后按照 WEEX API 文档完成接口调用。

如果是第一次接入，可以先从市场数据开始。例如先获取实时行情、K线、订单簿等数据，确认接口连接、参数和返回结果都正常，再逐步进入账户查询和交易接口。

WEEX 当前 API 同时提供 REST API 和 WebSocket。官方 API 页面显示，REST API 和 WebSocket分别用于不同的数据和交互场景，其中 WebSocket可以用于实时成交等数据推送。

对于已经有量化程序基础的用户，也可以直接根据官方 V3 API 文档进行开发。官方文档目前提供接口说明、请求参数以及相关示例，可以作为后续开发和排查问题的主要参考。

如果你还没有准备好直接连接真实资金账户，也没必要急着上线策略。先把 API Key 创建好，再从测试和模拟交易环境开始熟悉接口，会更适合第一次接触程序化交易的用户。

如果你想直接开始操作，可以先查看 WEEX 官方 API 接入文档和模拟盘相关入口，先把 API 创建、权限配置和接口调用流程跑通，再考虑正式运行自己的策略。

WEEX API本身只是连接交易账户与程序之间的一座桥。真正决定策略是否值得运行的，还是数据质量、策略逻辑、回测结果以及风险控制。API Key创建完成之后，下一步才是把这些东西真正连接起来。