Skip to main content

​
Base URL

All REST API endpoints are available at: 
https://whitebit.com/api/v4/{endpoint}
  • Public endpoints use the GET method and accept parameters as query strings.
  • Private endpoints use the POST method and accept parameters as JSON in the request body.
  • All endpoints return time in Unix-time format and respond with JSON.

​
Authentication

Private endpoints require API key authentication with HMAC-SHA512 signed requests. See the Authentication Guide for setup instructions, header requirements, and code examples.

​
Rate Limits

ScopeLimit
Public REST endpoints2000 requests / 10 sec
Private REST endpointsVaries per endpoint (see individual docs)

​
Error Format

All V4 endpoints return errors as JSON. The format differs slightly between public and private APIs: Public endpoints: 
{
  "success": false,
  "message": "ERROR MESSAGE",
  "params": []
}
Private endpoints: 
{
  "code": 0,
  "message": "MESSAGE",
  "errors": {
    "PARAM1": ["MESSAGE"],
    "PARAM2": ["MESSAGE"]
  }
}
For full details, see the Market Data overview and Spot Trading overview.

​
Endpoint Groups

Market Data

Public market info, orderbook, trades, fees, server status, and more. No authentication required.

Spot Trading

Place and manage spot orders, query execution history, and control kill-switch timers.

Collateral Trading

Manage collateral positions, leverage, hedge mode, and collateral order types (limit, market, OCO, OTO).

Convert

Estimate, confirm, and review currency conversion operations.

Account & Wallet

Main balance, deposits, withdrawals, transfers, codes, crypto lending, fees, and mining pool.

Sub-Accounts

Create and manage sub-accounts, balances, transfers, and API keys.

OAuth

Third-party authorization: token exchange, refresh, and account endpoints.