Skip to main content
WhiteBIT organizes trading around market pairs — combinations of a base asset and a quote asset, written as BASE_QUOTE (for example, BTC_USDT). The base asset (left side) is what gets bought or sold. The quote asset (right side) is what gets paid with.

​
Market types

WhiteBIT supports four market types, each using different account balances and leverage settings. Spot — Direct buy/sell. Orders execute against the spot orderbook. Funds held in the Trade balance. Margin — Leveraged trading on spot pairs with up to 10× leverage. Pair names are identical to spot (e.g., BTC_USDT). Funds held in the Collateral balance. Isolated margin mode available. Futures — Perpetual contracts with up to 100× leverage. Pairs use the _PERP suffix (e.g., BTC_PERP). Funds held in the Collateral balance. Hedge Mode allows simultaneous long and short positions. TradFi Futures — Futures markets on traditional-finance assets such as equities (e.g., AAPL_USD). Identified in the markets response by type: tradfiFutures and isTradFiFutures: true. Availability is region-gated — markets not available in a given region are omitted from GET /api/v4/public/markets entirely.
API naming convention: WhiteBIT’s API uses “collateral” endpoints for both Margin and Futures trading. The market pair determines the product: spot pairs (e.g., BTC_USDT) for Margin, perpetual pairs (e.g., BTC_PERP) for Futures. All endpoints under /api/v4/order/collateral/ and /api/v4/collateral-account/ serve both products.

​
How to fetch market info

Public endpoints — no authentication required:
  • Spot, Margin + TradFi futures markets: GET /api/v4/public/markets — API Reference
  • Perpetual futures markets: GET /api/v4/public/futures — API Reference

​
Key market fields

Each market returned by GET /api/v4/public/markets includes:

​
Market statuses

The tradesEnabled field indicates whether a market is actively accepting orders. Markets can be temporarily disabled by the platform without prior notice. For platform-wide maintenance status, call GET /api/v4/public/platform/status — API Reference.

​
What’s Next

Order Types

Learn about the 7 order types available on WhiteBIT.

Balances & Transfers

Understand Main, Trade, and Collateral account types.

Market Data Quickstart

Fetch live prices and orderbooks — no auth required.