Capabilities
- 6 order types — Market, Limit, Stop-Limit, Stop-Market, Stock-Market, Bulk-Limit (details)
- Bulk orders — Place up to 20 limit orders in a single API call (endpoint)
- Kill-switch — Emergency mechanism to cancel all active orders after a configurable timeout (sync timer, status)
- Order modification — Modify existing orders in-place without canceling and recreating (endpoint)
- Client Order ID — Attach custom identifiers for order tracking and reconciliation
- Self-Trade Prevention — Prevent accidental self-crossing when quoting both sides (details)
Who Uses This
- Trading firms — Automated execution across hundreds of pairs with bulk-limit orders, the kill-switch, and in-place order modification
- Fintechs — Embedded spot trading in consumer or business applications via the REST API
- Brokers — WhiteBIT liquidity offered to end users via the Broker Program (40% of the trading fee generated by referred users)
- Market makers — Liquidity provision through the Market-Making Program (maker rebates up to -0.012% for qualifying volume above $100M/30 days)
Common Integration Patterns
Trading automation — Combine the REST API for order placement with WebSocket for real-time price data. Set the kill-switch timer so all active orders cancel automatically if the bot stops sending heartbeats. Existing integrations include Bitsgap and TradingView. Market making — Use bulk limit orders (up to 20 per call) alongside the real-time orderbook depth WebSocket channel. The Market-Making Program offers maker fee rebates up to -0.012% for qualifying volume ($100M+/30 days). Pair with colocation for low-latency execution (3–5 ms) and sub-accounts to run market-making and directional strategies on independent balances with separate API keys. Enable Self-Trade Prevention to avoid accidental self-crossing. Multi-exchange arbitrage — Subscribe to thelastprice WebSocket channel for real-time price monitoring across pairs. Use colocation (3–5 ms latency) for execution speed. Market orders provide immediate fills at best available price.
Fee Structure
Full fee schedule with all VIP tier breakpoints: trading fees page and VIP program. Query current fees per market via the market fee endpoint.
Technical Overview
Endpoint categories:
- Account — Trade balance query (1 endpoint)
- Order management — Create, modify, cancel orders; bulk operations (9 endpoints)
- Order queries — Active orders, executed history, execution deals, order history (4 endpoints)
- Market fees — Default maker/taker rates plus custom per-market overrides (1 endpoint)
- Kill-switch — Sync timer, status (2 endpoints)
What’s Next
Spot Quickstart
Place a first trade in 5 minutes.
API Reference
All 17 spot trading endpoints with parameters, signing, error codes, and rate limits.
Trading Bot Guide
Build a Python trading bot with signed REST orders, WebSocket fills, kill-switch heartbeat, and a grid-bot example.