Futures API
New here? Set up authentication first.
All authenticated Futures endpoints require Read, Trading, or Transfer permission. Read the Authentication Guide before making your first call.
Environmentβ
| 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 |
The OSS (Order Stream Service) endpoint is used exclusively for Orderbook incremental update streams.
Rate Limitsβ
| Category | Per API | Per User |
|---|---|---|
| Query | 15 req/s | 30 req/s |
| Orders | 75 req/s | 75 req/s |
Rate limit violations trigger a tiered block: 1 second β 5 minutes β 15 minutes. A Retry-After header is included in 429 responses. See Authentication β Rate Limits.
Spam Order Policyβ
Orders with a notional value below 5 USDT are marked as spam orders:
- Spam orders are hidden and always pay taker fee.
- Post-Only API spam orders are rejected.
- Accounts placing β₯ 4 resting orders with total size < 20 USDT risk being flagged.
- Flagged accounts may face rate limits, position limits, or disabled API access.
Symbol Naming (v2.3)β
| Format | Example | When used |
|---|---|---|
| New | BTC-PERP | Default in v2.3 REST |
| Old | BTCPFC | FIX API legacy β use ApplyNewSymbolName: Y in Logon to use new names |
Error Codesβ
See the shared Error Codes reference for HTTP status codes and API status enums.