合约 API
新手？请先设置身份验证。
所有经过身份验证的合约端点需要 Read、Trading 或 Transfer 权限。在进行第一次调用之前，请阅读身份验证指南。
API 版本
当前合约 API 为 v3。本节所有端点均通过以下地址提供：
https://api.btse.com/futures/api/v3/
旧版 v2.3
先前的 v2.3 合约 API 仍可供现有集成使用。可在交互式 合约（旧版 v2.3）API 浏览器 中查看，其 OpenAPI 规范可从 /specs/futures-rest.openapi.yaml 下载。新集成请使用 v3。
环境
| Product | Production | Testnet |
|---|---|---|
| Futures REST | https://api.btse.com/futures | https://testapi.btse.io/futures |
| Futures WebSocket | wss://ws.btse.com/ws/futures | wss://testws.btse.io/ws/futures |
| Futures OSS | wss://ws.btse.com/ws/oss/futures | wss://testws.btse.io/ws/oss/futures |
OSS（Order Stream Service）端点专用于订单簿增量更新流。
频率限制
| 类别 | 每个 API | 每个用户 |
|---|---|---|
| 查询 | 15 req/s | 30 req/s |
| 订单 | 75 req/s | 75 req/s |
超出频率限制会触发分级封禁：1 秒 → 5 分钟 → 15 分钟。429 响应中包含 Retry-After 标头。详见 Authentication → Rate Limits。
垃圾订单策略
名义价值低于 5 USDT 的订单将被标记为垃圾订单：
- 垃圾订单将被隐藏，且始终支付 taker 手续费。
- Post-Only API 的垃圾订单将被拒绝。
- 持有 4 个或以上总价值低于 20 USDT 的挂单账户可能被标记。
- 被标记的账户可能面临频率限制、持仓限制或 API 访问被禁用。
交易对命名 (v3)
| 格式 | 示例 | 使用场景 |
|---|---|---|
| 新版 | BTC-PERP | v3 REST 默认格式 |
| 旧版 | BTCPFC | FIX API 旧版 — 在 Logon 中使用 ApplyNewSymbolName: Y 以启用新名称 |
错误码
请参阅通用的错误码参考，了解 HTTP 状态码和 API 状态枚举。