Skip to main content
Base URL is https://whitebit.com Endpoint example: https://whitebit.com/api/v4/{endpoint} All endpoints return time in Unix-time format. All endpoints return either a JSON object or array. For receiving responses from API calls please use http method POST

​
Error messages V4 format

All API V4 endpoints return errors in the following format: 
{
  "code": 0,
  "message": "MESSAGE",
  "errors": {
    "PARAM1": ["MESSAGE"],
    "PARAM2": ["MESSAGE"]
  }
}

​
Market Fee

Endpoints for querying market fees:

Query Market Fee

Retrieve maker and taker fees for a specific market

Query All Market Fees

Retrieve maker and taker fees for all markets

​
Spot Trading

Endpoints for spot trading operations:

​
Account & Balance

Trading Balance

Get trade balance by currency ticker or all balances

​
Order Management

Create Limit Order

Create a limit trading order

Bulk Limit Order

Create multiple limit orders (1-20 orders)

Create Market Order

Create a market trading order

Create Buy Stock Market Order

Create buy stock market trading order

Create Stop-Limit Order

Create a stop-limit trading order

Create Stop-Market Order

Create a stop-market trading order

Modify Order

Modify an existing order

Cancel Order

Cancel a specific order

Cancel All Orders

Cancel all orders in a market

​
Order Queries

Query Unexecuted Orders

Get active/unexecuted orders

Query Executed Order History

Get executed order history

Query Executed Order Deals

Get executed order deals

Query Executed Orders

Get all executed orders

​
Kill Switch

Sync Kill-Switch Timer

Synchronize kill-switch timer

Status Kill-Switch Timer

Get kill-switch timer status

​
Collateral Trading

Endpoints for collateral (margin) trading operations:

​
Account & Balance

Collateral Account Balance

Get collateral account balance

Collateral Account Balance Summary

Get collateral account balance summary

Collateral Account Summary

Get complete collateral account summary

Change Collateral Account Leverage

Change account leverage

Collateral Account Hedge Mode

Get hedge mode status

Update Collateral Account Hedge Mode

Update hedge mode settings

​
Order Management

Collateral Limit Order

Create a collateral limit order

Collateral Bulk Limit Order

Create multiple collateral limit orders

Collateral Market Order

Create a collateral market order

Collateral Stop-Limit Order

Create a collateral stop-limit order

Collateral Trigger Market Order

Create a collateral trigger market order

Create Collateral OCO Order

Create OCO (One-Cancels-Other) order

Cancel OCO Order

Cancel an OCO order

Cancel Conditional Order

Cancel a conditional order

Cancel OTO Order

Cancel an OTO (One-Triggers-Other) order

​
Order Queries

Query Unexecuted Conditional Orders

Get active conditional orders

Query Unexecuted OCO Orders

Get active OCO orders

​
Position Management

Open Positions

Get all open positions

Close Position

Close a specific position

Positions History

Get positions history

Funding History

Get funding history

​
Convert

Endpoints for currency conversion operations:

Convert Estimate

Get conversion estimate quote

Convert Confirm

Confirm and execute conversion

Convert History

Get conversion history