Skip to main content

Public HTTP API V4

Public endpoints V4

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

Error messages V4 format:


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

Terminology

Pair:

Stock - currency that you want to buy or sell

Money - currency that you are using to buy or sell something

Maker - person who puts an order and waiting till this order will be finished

Taker - person who finishes existing order

Precision - is the number of digits to the right of the decimal point

Bid - buy order

Ask - sell order


Market Info

[GET] /api/v4/public/markets

This endpoint retrieves all information about available spot and futures markets.

Response is cached for: 1 second

Parameters: NONE

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
"tradesEnabled": true, // Is trading enabled
"isCollateral": true, // Is margin trading enabled
"type": "spot" // Market type. Possible values: "spot", "futures"
},
{
...
}
]

Market activity

[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

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
},
{...}
}

Asset status list

[GET] /api/v4/public/assets

This endpoint retrieves the assets status.

Response is cached for: 1 second

Parameters: NONE

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
},
...
}
}
},
{...}
}

Orderbook

[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: 1 second

Parameters:

NameTypeMandatoryDescription
limitintNoOrders depth quantity: 0 - 100. Not defined or 0 will return 100 entries.
levelintNoOptional 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:

{
"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
],
[ ... ]
]
}

Recent Trades

[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

Parameters:

NameTypeMandatoryDescription
typeStringNoCan 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"
},
{...}
}

Fee

[GET] /api/v4/public/fee

This endpoint retrieves the list of fees and min/max amount for deposits and withdraws


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": {
"min_fee": "100", // min fee amount
"max_fee": "1000", // max fee amount
"percent": "10"
}, // flex fee only applies for all transactions but according to min/max fee. Nullable if there is no flex fee
},
"withdraw": {
"min_amount": "0.001",
"max_amount": "0",
"fixed": null,
"flex": null
},
"is_depositable": true, //true if currency can be deposit
"is_withdrawal": true //true if currency can be withdraw
},
"USD": {
"ticker": "USD", // currency ticker
"name": "United States Dollar", // currency ticker
"providers": [
"USD_ADVCASH",
"USD_CAPITALIST",
"USD_EPAY_COM",
"USD_PERFECT_MONEY",
"USD_VISAMASTER_INTERKASSA"
], // the list of providers. It is uses for fiat currencies. Provider is a payment system with own fees, which process payment operation
"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,
"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,
"name": "USD Visa/MasterCard Interkassa",
"ticker": "USD_VISAMASTER_INTERKASSA"
}
}
},
}

Server Time

[GET] /api/v4/public/time

This endpoint retrieves the current server time.

Response:

{
"time": 1631451591
}

Server Status

[GET] /api/v4/public/ping

This endpoint retrieves the current API life-state.

Response is cached for: 1 second

Response:

[
"pong"
]

Collateral Markets List

[GET] /api/v4/public/collateral/markets

This endpoint returns the list of markets that available for collateral trading

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"
]

Available Futures Markets List

[GET] /api/v4/public/futures

This endpoint returns the list of available futures markets.

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", //Current funding rate
"next_funding_rate_timestamp": "1660665600000" //Timestamp of the next funding rate change
}
]
}