API Reference

​

Base URL

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.

​

Quickstart

​

Prerequisites

• A WhiteBIT account (Sign up)
• An API key with appropriate permissions (API Settings)
• A programming language or HTTP client (cURL, Python, JavaScript, or similar)

​

Step 1: First public API call

curl -X GET "https://whitebit.com/api/v4/public/ping"

import requests

response = requests.get("https://whitebit.com/api/v4/public/ping")
print(response.json())

const response = await fetch("https://whitebit.com/api/v4/public/ping");
const data = await response.json();
console.log(data);

["pong"]

​

Step 2: Authentication setup

​

Step 3: First authenticated API call

{
  "request": "/api/v4/main-account/balance",
  "nonce": "1594297865000"
}

curl -X POST "https://whitebit.com/api/v4/main-account/balance" \
  -H "Content-type: application/json" \
  -H "X-TXC-APIKEY: YOUR_API_KEY" \
  -H "X-TXC-PAYLOAD: BASE64_ENCODED_PAYLOAD" \
  -H "X-TXC-SIGNATURE: YOUR_SIGNATURE" \
  -d '{"request":"/api/v4/main-account/balance","nonce":"1594297865000"}'

# Use the API Quick Start Helper: https://github.com/whitebit-exchange/api-quickstart
from whitebit import Whitebit

wb = Whitebit(api_key="YOUR_API_KEY", api_secret="YOUR_API_SECRET")
balance = wb.main_account_balance()
print(balance)

{
  "BTC": { "main_balance": "0" },
  "USDT": { "main_balance": "100.50" }
}

​

Rate Limits

​

Error Format

{
  "success": false,
  "message": "ERROR MESSAGE",
  "params": []
}

{
  "code": 0,
  "message": "MESSAGE",
  "errors": {
    "PARAM1": ["MESSAGE"],
    "PARAM2": ["MESSAGE"]
  }
}

​

Endpoint Groups

​

What’s next

• Authentication — Full signing process and common errors
• Rate Limits & Error Codes — Per-endpoint limits, error formats, and troubleshooting
• Market Data — Public endpoints for orderbook, trades, and market info
• Spot Trading — Place and manage orders
• WebSocket API — Real-time market data and account streams
• API Quick Start Helper — Multi-language SDK for authentication and requests