基本信息
本页汇总 Rocky 永续合约所有端点都适用的基础约定。
Base URL
| 环境 | Base URL |
|---|---|
| Devnet | https://demo.rocky.exchange |
| Mainnet | https://api.rocky.exchange |
Content-Type
- 请求体：
application/json - Query string：标准 URL-encoded
- 响应：
application/json（/healthz、/readyz返回text/plain）
版本管理
路径版本化。破坏性变更走新版本号（/v1 → /v2），旧版本保留到下一个 major 发布。
限流
Devnet 当前未启用限流。生产将参照标准的 X-MBX-USED-WEIGHT-1M 按 key 限频。建议自行控速：
- 公开行情：≤ 5 req/sec/IP
- 签名接口：≤ 10 req/sec/key
鉴权
| 接口 | 方式 |
|---|---|
/v1/* | Session / JWT（MVP：user_id query） |
/fapi/v1/*、/fapi/v2/* | X-MBX-APIKEY header + HMAC-SHA256 签名 |
签名细节见 FAPI 下单流程。
时间同步
- 所有
timestamp单位都是 Unix 毫秒。 - 签名请求需满足
|now − timestamp| ≤ recvWindow；默认recvWindow = 5000，上限60000。