Skip to main content
WhiteBIT supports 800+ trading pairs across 410+ crypto assets. The Spot Trading API provides programmatic access to WhiteBIT spot markets with 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.

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
  • Embedded Trading — WhiteBIT liquidity offered to end users via Embedded Trading (up to 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; from September 2, 2026 (global platform only), orders can also be placed over the WebSocket order methods. 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 the lastprice 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 via the market fee endpoint, or the effective fee for one market via the single-market fee endpoint.

Technical Overview

Endpoint categories:
  • Account — Trade balance query (1 endpoint)
  • Order management — Create, modify, cancel orders; bulk operations (10 endpoints)
  • Order queries — Active orders, executed history, execution deals, order history, delisting orders (5 endpoints)
  • Market fees — Default maker/taker rates, custom per-market overrides, and the effective fee for a single market (2 endpoints)
  • Kill-switch — Sync timer, status (2 endpoints)
For full endpoint documentation, see the Spot Trading API Reference. For Go and PHP examples, see SDKs.

What’s Next

Spot Quickstart

Place a first trade in 5 minutes.

API Reference

All 20 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.