Programmatic access to 750+ trading pairs across 360+ crypto assets. The Spot Trading API supports 6 order types, bulk-limit orders (up to 20 orders per call), and a kill-switch that cancels all active orders after a configurable timeout.Documentation Index
Fetch the complete documentation index at: https://docs.whitebit.com/llms.txt
Use this file to discover all available pages before exploring further.
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
| Maker | Taker | |
|---|---|---|
| Base rate | 0.1% | 0.1% |
| VIP (best tier) | -0.001% | 0.03% |
| Market-Making Program (best tier) | -0.012% | 0.020% |
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 — Per-market and all-market fee queries (2 endpoints)
- Kill-switch — Sync timer, status (2 endpoints)
What’s Next
Spot Quickstart
Place a first trade in 5 minutes.
API Reference
All 18 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.