Binance Demo Environment
Binance provides a Demo Mode for testing API integrations with realistic market data. Launched in November 2025, demo mode is a unified spot + futures testing environment that replaces the legacy separate testnets and offers a more production-like experience. A single API key created at demo.binance.com works for both spot and USDT-M futures.
Supported Account Types
Only spot and USDT-M futures trading are available in the demo environment.
| Account Type | Demo Support | Notes |
|---|---|---|
| Spot | ✓ | Full spot trading functionality |
| USDT-M Futures | ✓ | Full USDT-margined futures functionality |
| Margin | ✗ | Not available in demo |
| Isolated Margin | ✗ | Not available in demo |
| COIN-M Futures | ✗ | Uses legacy testnet instead (see below) |
Margin accounts are not available in demo mode. Only spot and USDT-M futures accounts can be discovered and tested in the demo environment.
COIN-M Futures Testnet
COIN-M futures are not part of the unified demo environment. They remain on the legacy testnet with separate API keys.
| Service | Production | Legacy Testnet |
|---|---|---|
| REST API | https://dapi.binance.com | https://testnet.binancefuture.com |
| WebSocket Streams | wss://dstream.binance.com | wss://dstream.binancefuture.com |
Base URLs
Replace the production endpoints with demo-specific URLs. All other request/response formats remain identical.
Spot
| Service | Production | Demo |
|---|---|---|
| REST API | https://api.binance.com/api | https://demo-api.binance.com/api |
| WebSocket API | wss://ws-api.binance.com/ws-api/v3 | wss://demo-ws-api.binance.com/ws-api/v3 |
| WebSocket Streams | wss://stream.binance.com/ws | wss://demo-stream.binance.com/ws |
| WebSocket Streams (alt) | wss://stream.binance.com:9443/ws | wss://demo-stream.binance.com:9443/ws |
USDT-M Futures
| Service | Production | Demo |
|---|---|---|
| REST API | https://fapi.binance.com | https://demo-fapi.binance.com |
API Key Setup
Demo mode requires a separate API key created from the demo portal.
- Log in to Binance Demo Trading
- Navigate to API Key Management
- Create a new API key
- Configure permissions (same options as production: Reading, Spot & Margin Trading, Futures)
Demo API keys are separate from production keys. You cannot use production API keys with demo endpoints or vice versa.
Demo vs. Legacy Testnets
| Demo Mode | Spot Testnet (legacy) | Futures Testnet (legacy) | |
|---|---|---|---|
| Portal | demo.binance.com | testnet.binance.vision | testnet.binancefuture.com |
| Spot | ✓ | ✓ | ✗ |
| USDT-M Futures | ✓ | ✗ | ✓ |
| COIN-M Futures | ✗ | ✗ | ✓ |
| Unified API Key | ✓ (spot + futures) | Spot only | Futures only |
| Market Data | Realistic (mirrors live) | Independent (synthetic) | Independent (synthetic) |
| Balances | Resettable via UI | Monthly auto-reset | Monthly auto-reset |
| Rate Limits / Filters | Matches production exactly | Generally similar | Generally similar |
| Features | Matches production | May include unreleased | May include unreleased |
Realistic market data is not identical to real market data. Do not assume trading strategies that work in demo mode will work on the live exchange.
Limitations
- No margin trading — margin and isolated margin accounts are not supported
- No COIN-M futures — COIN-M remains on the legacy testnet at
testnet.binancefuture.com - Maintenance windows — order placement and cancellation are unavailable during scheduled maintenance (announced via Binance changelog)
- Balance reset — balances can be reset at any time via the demo UI, which may affect ongoing testing