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). Once available, they will be identified in the markets response by type: tradfiFutures and isTradFiFutures: true, and availability will be region-gated — markets not available in a given region are omitted from GET /api/v4/public/markets entirely.
Coming soon: TradFi futures are not yet returned by GET /api/v4/public/markets.
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:
  • All markets (spot, margin, perpetual; TradFi futures coming soon): 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. The /api/v4/public/markets response only includes markets enabled for trading, so a disabled market disappears from the list rather than appearing with tradesEnabled: false. Markets can be temporarily disabled by the platform without prior notice. The platform announces a permanent removal in advance instead. The market carries the announced delisting date in delistedAt — a Unix timestamp in seconds, null when no delisting is announced. The market keeps trading until the delisting runs, then the platform cancels the active orders and drops the market from the response. An announcement can be rescheduled or canceled, so re-read delistedAt on each poll. 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.