概述
欢迎来到 Sparky 永续合约 API 参考。Sparky 的开发者 API 与 Binance USDT-M Futures 兼容：请求格式、响应字段与 HMAC 签名规则均与 Binance /fapi 一致，已有的 Binance SDK 只需替换 Base URL 即可接入。本节结构与 Binance USDT-M 侧边栏一一对应，缺口一眼可见。
两套 HTTP 接口
| 接口 | 路径前缀 | 适用对象 | 鉴权 |
|---|---|---|---|
| 原生 API | /api/v1/* | Web 前端、充提、推荐返佣、积分、理财 | Authorization: Bearer <JWT>，来自 EIP-712 登录 |
| FAPI | /fapi/v1/*、/fapi/v2/*、/futures/data/* | 机器人、做市商、SDK | X-MBX-APIKEY 请求头 + HMAC-SHA256 signature |
两套接口共享同一撮合引擎、持仓与余额。/fapi 与 Binance 一样直接挂在域名根路 径（https://api-avax.<sparky-domain>/fapi/v1/order），没有 /api/v1 前缀。
Base URL
每条链一套部署；账户、余额与 API Key 不跨部署共享。域名分配前以下主机名均为占位符。
| 链 | Chain ID | REST Base URL | WebSocket |
|---|---|---|---|
| Avalanche C-Chain | 43114 | https://api-avax.<sparky-domain> | wss://api-avax.<sparky-domain>/ws |
| Arbitrum One | 42161 | https://api-arb.<sparky-domain> | wss://api-arb.<sparky-domain>/ws |
| BNB Chain | 56 | https://api-bnb.<sparky-domain> | wss://api-bnb.<sparky-domain>/ws |
| Avalanche Fuji（测试网） | 43113 | https://api-fuji.<sparky-domain> | wss://api-fuji.<sparky-domain>/ws |
| Arbitrum Sepolia（测试网） | 421614 | https://api-arb-sepolia.<sparky-domain> | wss://api-arb-sepolia.<sparky-domain>/ws |
怎么读这一节
每个端点页面都标有状态：
- 已实现 — Sparky 当前提供此端点；页面给出请求、响应，以及与 Binance 的全部差异。
- 空缺（暂未实现） — Sparky 尚未提供该 Binance 端点。页面记录 Binance 的方法/路径，若有 Sparky 替代方案也一并给出。这些占位页是为了让 SDK 开发者一眼看出差距。
Sparky 在 Binance 之外额外提供的端点（滑点报告、algo 订单、listenKey、API Key 管理、健康检查）见 Sparky 扩展接口。