API 与速率限制

REST 与 WebSocket 网关：基础 URL、身份验证以及速率限制模型。

Nexus Exchange 以 API 为先。交易者能做的一切都可以通过 REST 和 WebSocket 完成：为账户充值、下单和撤单、查询仓位、订阅订单簿数据流。网页前端是只读视图，程序化访问才是主要接口。

基础 URL

https://api.testnet.nexus.xyz/v1

这是公共测试网的基础地址。它取代了 https://exchange.nexus.xyz/api/exchange，后者在2026-09-28检查时对 API 路径返回 HTTP 500。主网计划使用 https://api.nexus.xyz/v1，该主机目前尚无法解析。机器可读的 OpenAPI 规范在 /openapi.json 提供，并在 nexus-xyz/nexus-exchange-api 中进行版本管理；版本发布记录在 GitHub Releases。

身份验证模型

凭证分为两种类型：

会话令牌（Bearer）。通过使用您的以太坊钱包对一条固定消息签名（EIP-191）生成。仅用于创建和管理 API 密钥，绝不用于交易。24小时后过期。
API 密钥（HMAC）。一对 key_id + secret。每个交易和账户请求都使用 HMAC-SHA256 对规范请求字符串进行签名。secret 仅在创建时显示一次，之后无法再次获取。

1. POST /auth/login   (wallet signature)        → session Bearer token
2. POST /keys         (Bearer)                   → API key_id + secret
3. sign each request  (HMAC over canonical str)  → trade

完整流程及可运行的 cURL 示例请参阅快速入门。

CCXT

兼容 CCXT 和 CCXT-Pro 是交易所 API 的既定目标，目前仍在构建和测试中。在 OpenAPI 规范中，每个对应 CCXT 统一方法的操作（包括下单）都带有 x-ccxt-method 注解。

参考

快速入门：您的第一笔交易
REST API 参考
WebSocket API 参考
速率与连接限制
API 版本管理

状态：测试网预览版。凭证、会话和速率限制状态在网关重启后尚不能持久保留，因此请将 API 密钥视为可重新创建的。生产环境加固工作正在进行中。

上一页参数变更

下一页交易所 REST

最后更新于 9天前