Base URL is https://whitebit.com
Endpoint example: https://whitebit.com/api/v4/public/{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 GET
If an endpoint requires parameters you should send them as query string
{
"success": false,
"message": "ERROR MESSAGE",
"params": []
}[GET] /api/v4/public/platform/status
This endpoint retrieves maintenance status
Response:
{
"status": "1" // 1 - system operational, 0 - system maintenance
}[GET] /api/v4/public/markets
This endpoint retrieves all information about available spot and futures markets.
Response is cached for: 1 second
Parameters: NONE
❗ Rate limit 2000 requests/10 sec.
Response:
[
{
"name": "SON_USD", // Market pair name
"stock": "SON", // Ticker of stock currency
"money": "USD", // Ticker of money currency
"stockPrec": "3", // Stock currency precision
"moneyPrec": "2", // Precision of money currency
"feePrec": "4", // Fee precision
"makerFee": "0.001", // Default maker fee ratio
"takerFee": "0.001", // Default taker fee ratio
"minAmount": "0.001", // Minimal amount of stock to trade
"minTotal": "0.001", // Minimal amount of money to trade
"maxTotal": "10000000000", // Maximum total(amount * price) of money to trade
"tradesEnabled": true, // Is trading enabled
"isCollateral": true, // Is margin trading enabled
"type": "spot" // Market type. Possible values: "spot", "futures"
},
{
...
}
][GET] /api/v4/public/ticker
This endpoint retrieves a 24-hour pricing and volume summary for each market pair available on the exchange.
Response is cached for: 1 second
Parameters: NONE
❗ Rate limit 2000 requests/10 sec.
Response:
{
"BTC_USDT": {
"base_id": 1, // CoinmarketCap Id of base currency; 0 - if unknown
"quote_id": 825, // CoinmarketCap Id of quote currency; 0 - if unknown
"last_price": "9164.09", // Last price
"quote_volume": "43341942.90416876", // Volume in quote currency
"base_volume": "4723.286463", // Volume in base currency
"isFrozen": false, // Identifies if trades are closed
"change": "0.57" // Change in percent between open and last prices
},
{...}
}[GET] /api/v4/public/assets
This endpoint retrieves the assets status.
Response is cached for: 1 second
Parameters: NONE
❗ Rate limit 2000 requests/10 sec.
Response:
{
"BTC": {
"name": "Bitcoin", // Full name of cryptocurrency.
"unified_cryptoasset_id": 1, // Unique ID of cryptocurrency assigned by Unified Cryptoasset ID, 0 if unknown
"can_withdraw": true, // Identifies whether withdrawals are enabled or disabled.
"can_deposit": true, // Identifies whether deposits are enabled or disabled.
"min_withdraw": "0.001", // Identifies the single minimum withdrawal amount of a cryptocurrency.
"max_withdraw": "2", // Identifies the single maximum withdrawal amount of a cryptocurrency.
"maker_fee": "0.1", // Maker fee in percentage
"taker_fee": "0.1", // Taker fee in percentage
"min_deposit": "0.0001", // Min deposit amount
"max_deposit": "0", // Max deposit amount, will not be returned if there is no limit, 0 if unlimited
"currency_precision": 18, // Max number of digits to the right of the decimal point
"is_memo": false, // Identifies if currency has memo address
"networks": { // Currency networks. It might be a list of networks for cryptocurrency networks or just a single item list for simple cryptocurrencies or tokens
"deposits": [ // Networks available for depositing
"BTC"
],
"withdraws": [ // Networks available for withdrawing
"BTC"
],
"default": "BTC" // Default network for depositing / withdrawing if available
},
"limits": { // Currency limits by each network
"deposit": { // Deposits limits
"BTC": { // Network
"min": "0.001" // Min deposit amount
},
},
"withdraw": { // Withdraws limits
"BTC": { // Network
"min": "0.002", // Min withdraw amount
},
}
},
"confirmations": { // Deposit confirmations count mapped by network
"BTC": 2
}
},
"ETH": {
"name": "Ethereum",
"unified_cryptoasset_id": 1027,
"can_withdraw": true,
"can_deposit": true,
"min_withdraw": "0.02",
"max_withdraw": "0",
"maker_fee": "0.1",
"taker_fee": "0.1",
"min_deposit": "0.1",
"max_deposit": "0",
"currency_precision": 18,
"is_memo": false,
"networks": { // Currency networks. It might be a list of networks for cryptocurrency networks or just a single item list for simple cryptocurrencies or tokens
"deposits": [ // Networks available for depositing
"ETH"
],
"withdraws": [ // Networks available for withdrawing
"ETH"
],
"default": "ETH" // Default network for depositing / withdrawing if available
},
"limits": { // Currency limits by each network
"deposit": { // Deposits limits
"ETH": { // Network
"min": "0.001" // Max deposit amount
}
},
"withdraw": { // Withdraws limits
"ETH": { // Network
"min": "0.002" // Min withdraw amount
}
}
},
"confirmations": {
"ETH": 20
}
},
"USDT": {
"name": "Tether US",
"unified_cryptoasset_id": 825,
"can_withdraw": true,
"can_deposit": true,
"min_withdraw": "5",
"max_withdraw": "0",
"maker_fee": "0.1",
"taker_fee": "0.1",
"min_deposit": "0",
"max_deposit": "0",
"currency_precision": 6,
"is_memo": false,
"networks": { // Currency networks. It might be a list of networks for cryptocurrency networks or just a single item list for simple cryptocurrencies or tokens
"deposits": [ // Networks available for depositing
"ERC20",
"TRC20",
"OMNI",
"BEP20"
],
"withdraws": [ // Networks available for withdrawing
"ERC20",
"TRC20",
"OMNI",
"BEP20"
],
"default": "ERC20" // Default network for depositing / withdrawing
},
"limits": { // This object will be returned when currency has several networks/providers
"deposit": { // Deposits limits
"ERC20": { // Network
"min": "5", // Min deposit amount
"max": "1000" // Max deposit amount
},
"TRC20": {
"min": "5" // If there is no max limit, it is not returned
},
...
},
"withdraw": { // Withdraws limits
"ERC20": { // Network
"min": "10", // Min withdraw amount
"max": "1000" // Max withdraw amount
},
"TRC20": {
"min": "10" // If there is no max limit, it is not returned
},
...
}
},
"confirmations": {
"ERC20": 20,
"TRC20": 20
}
},
"UAH": {
"name": "Hryvnia",
"unified_cryptoasset_id": 0,
"can_withdraw": true,
"can_deposit": true,
"min_withdraw": "50",
"max_withdraw": "100000",
"maker_fee": "0.1",
"taker_fee": "0.1",
"min_deposit": "50",
"max_deposit": "100000",
"is_memo": false,
"providers": { // Fiat currency providers
"deposits": [ // Providers available for depositing
"VISAMASTER",
"ADVCASH",
"GEOPAY"
],
"withdraws": [ // Providers available for withdrawing
"VISAMASTER",
"GEOPAY"
],
},
"limits": { // This object will be returned when currency has several networks/providers
"deposit": { // Deposits limits
"VISAMASTER": { // Provider
"min": "50", // Min deposit amount
"max": "50000" // Max deposit amount
},
...
},
"withdraw": { // Withdraws limits
"VISAMASTER": { // Provider
"min": "50", // Min withdraw amount
"max": "50000" // Max withdraw amount
},
...
}
}
},
{...}
}[GET] /api/v4/public/orderbook/{market}?limit=100&level=2
This endpoint retrieves the current order book as two arrays (bids / asks) with additional parameters.
Response is cached for: 100 ms
❗ Rate limit 600 requests/10 sec.
Parameters:
| Name | Type | Mandatory | Description |
|---|---|---|---|
| limit | int | No | Orders depth quantity: 0 - 100. Not defined or 0 will return 100 entries. |
| level | int | No | Optional parameter that allows API user to see different level of aggregation. Level 0 – default level, no aggregation. Starting from level 1 (lowest possible aggregation) and up to level 5 - different levels of aggregated orderbook. |
Response:
{
"ticker_id": "BTC_PERP", // Market Name
"timestamp": 1594391413, // Current timestamp
"asks": [ // Array of ask orders
[
"9184.41", // Price of lowest ask
"0.773162" // Amount of lowest ask
],
[ ... ]
],
"bids": [ // Array of bid orders
[
"9181.19", // Price of highest bid
"0.010873" // Amount of highest bid
],
[ ... ]
]
}[GET] /v4/public/orderbook/depth/{market}
This endpoint retrieves depth price levels within ±2% of the market last price.
Response is cached for: 1 sec
❗ Rate limit 2000 requests/10 sec.
Parameters: NONE
Response:
{
"ticker_id": "BTC_PERP", // Market Name
"timestamp": 1594391413, // Current timestamp
"asks": [ // Array of ask orders
[
"9184.41", // Price of lowest ask
"0.773162" // Amount of lowest ask
],
[ ... ]
],
"bids": [ // Array of bid orders
[
"9181.19", // Price of highest bid
"0.010873" // Amount of highest bid
],
[ ... ]
]
}[GET] /api/v4/public/trades/{market}?type=sell
This endpoint retrieves the trades that have been executed recently on the requested market.
Response is cached for: 1 second
❗ Rate limit 2000 requests/10 sec.
Parameters:
| Name | Type | Mandatory | Description |
|---|---|---|---|
| type | String | No | Can be buy or sell |
Response:
[
{
"tradeID": 158056419, // A unique ID associated with the trade for the currency pair transaction Note: Unix timestamp does not qualify as trade_id.
"price": "9186.13", // Transaction price in quote pair volume.
"quote_volume": "0.0021", // Transaction amount in quote pair volume.
"base_volume": "9186.13", // Transaction amount in base pair volume.
"trade_timestamp": 1594391747, // Unix timestamp in milliseconds, identifies when the transaction occurred.
"type": "sell" // Used to determine whether or not the transaction originated as a buy or sell. Buy – Identifies an ask that was removed from the order book. Sell – Identifies a bid that was removed from the order book.
},
{
"tradeID": 158056416,
"price": "9186.13",
"base_volume": "9186.13",
"quote_volume": "0.002751",
"trade_timestamp": 1594391746,
"type": "sell"
},
{...}
}[GET] /api/v4/public/fee
This endpoint retrieves the list of fees and min/max amount for deposits and withdraws
Response is cached for: 1 second
❗ Rate limit 2000 requests/10 sec.
Response:
{
"USDT (ERC20)": {
"ticker": "USDT", // currency ticker
"name": "Tether US", // currency ticker
"providers": [],
"deposit": { // deposit fees
"min_amount": "0.0005", // min deposit amount. 0 if there is no limitation
"max_amount": "0.1", // max deposit amount. 0 if there is no limitation
"fixed": "0.0005", // fixed fee amount which applies for all transaction
"flex": { // flex fee only applies for all transactions but according to min/max fee. Nullable if there is no flex fee
"min_fee": "100", // min fee amount
"max_fee": "1000", // max fee amount
"percent": "10"
}
},
"withdraw": {
"min_amount": "0.001",
"max_amount": "0",
"fixed": null,
"flex": null
},
"is_depositable": true, // true if currency can be depositable
"is_withdrawal": true, // true if currency can be withdrawable
"is_api_withdrawal": true, // true if currency can be withdrawable by api
"is_api_depositable": true // true if currency can be depositable by api
},
"USD": {
"ticker": "USD", // currency ticker
"name": "United States Dollar", // currency ticker
"providers": [ // the list of providers. It is uses for fiat currencies. Provider is a payment system with own fees, which process payment operation
"USD_ADVCASH",
"USD_CAPITALIST",
"USD_EPAY_COM",
"USD_PERFECT_MONEY",
"USD_VISAMASTER_INTERKASSA"
],
"deposit": { // for currencies with payment providers fee and amounts shows for each provider directly
"USD_VISAMASTER_INTERKASSA": {
"min_amount": "10",
"max_amount": "1500",
"fixed": null,
"flex": null,
"is_depositable": false,
"is_api_depositable": true,
"name": "USD Visa/MasterCard Interkassa", // provider name
"ticker": "USD_VISAMASTER_INTERKASSA" // provider ticker
}
},
"withdraw": {
"USD_VISAMASTER_INTERKASSA": {
"min_amount": "20",
"max_amount": "1500",
"fixed": null,
"flex": null,
"is_withdrawal": false,
"is_api_withdrawal": true,
"name": "USD Visa/MasterCard Interkassa",
"ticker": "USD_VISAMASTER_INTERKASSA"
}
}
}
}[GET] /api/v4/public/time
This endpoint retrieves the current server time.
Response is cached for: 1 second
❗ Rate limit 2000 requests/10 sec.
Response:
{
"time": 1631451591
}[GET] /api/v4/public/ping
This endpoint retrieves the current API life-state.
❗ Rate limit 2000 requests/10 sec.
Response is cached for: 1 second
Response:
["pong"][GET] /api/v4/public/collateral/markets
This endpoint returns the list of markets that available for collateral trading
❗ Rate limit 2000 requests/10 sec.
Response is cached for: 1 second
Response:
[
"ADA_USDT",
"BCH_USDT",
"BTC_USDT",
"DOGE_USDT",
"EOS_USDT",
"ETH_BTC",
"ETH_USDT",
"LINK_USDT",
"LTC_USDT",
"SHIB_USDT",
"SOL_USDT",
"TRX_USDT",
"USDC_USDT",
"XLM_USDT",
"XRP_USDT"
][GET] /api/v4/public/futures
This endpoint returns the list of available futures markets.
❗ Rate limit 2000 requests/10 sec.
Response is cached for: 1 second
Response:
{
"success": true,
"message": null,
"result": [
{
"ticker_id": "BTC_PERP", // Identifier of a ticker with delimiter to separate base/target
"stock_currency": "BTC", // Symbol/currency code of base pair
"money_currency": "USDT", // Symbol/currency code of target pair
"last_price": "24005.5", // Last transacted price of base currency based on given target currency
"stock_volume": "196965.591", // 24 hour trading volume in base pair volume
"money_volume": "4737879075.7817", // 24 hour trading volume in target pair volume
"bid": "24005.4", // Current highest bid price
"ask": "24005.6", // Current lowest ask price
"high": "24295.1", // Rolling 24-hours highest transaction price
"low": "23765.3", // Rolling 24-hours lowest transaction price
"product_type": "Perpetual", // What product is this? Futures, Perpetual, Options?
"open_interest": "6000", // The open interest in the last 24 hours in contracts.
"index_price": "24019.25", // Underlying index price
"index_name": "Bitcoin", // Name of the underlying index if any
"index_currency": "BTC", // Underlying currency for index
"funding_rate": "0.000044889033693137", // The current funding rate, which may fluctuate due to market conditions.
"next_funding_rate_timestamp": "1660665600000", // Timestamp of the next funding rate change
"brackets": { // Brackets
"1": 0,
"2": 0,
"3": 0,
"5": 0,
"10": 0,
"20": 0,
"50": 20,
"100": 50
},
"max_leverage": 100 // Max Leverage
}
]
}[GET] /api/v4/public/mining-pool
This endpoint returns an overall information about the current mining pool state.
HashRate info represents in the H units.
❗ Rate limit 1000 requests/10 sec.
Response is cached for: NONE
Parameters: NONE
Request BODY raw: NONE
Response:
Available statuses:
Status 200
{
"data": [
{
"connectionLinks": ["stratum+tcp://1.1.1.1:80", "stratum+tcp://1.1.1.2:80"],
"location": "global",
"assets": ["BTC"],
"rewardSchemes": ["FPPS"],
"workers": 1846,
"currentHashRate": "39353570.8006319183174839",
"last7daysHashRate": [
{
"timestamp": 1732579200,
"hashrate": "184425100325925.9259259259259259",
}
],
"blocks": [
{
"blockFoundAt": 1715339355,
"blockHeight": 18329
},
{
"blockFoundAt": 1715329275,
"blockHeight": 18325
}
]
}
]
}