合约 API
新手？请先设置身份验证。
所有经过身份验证的合约端点需要 Read、Trading 或 Transfer 权限。在进行第一次调用之前，请阅读身份验证指南。
环境
| 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 访问被禁用。
交易对命名 (v2.3)
| 格式 | 示例 | 使用场景 |
|---|---|---|
| 新版 | BTC-PERP | v2.3 REST 默认格式 |
| 旧版 | BTCPFC | FIX API 旧版 — 在 Logon 中使用 ApplyNewSymbolName: Y 以启用新名称 |
错误码
请参阅通用的错误码参考，了解 HTTP 状态码和 API 状态枚举。