Public HTTP API V2

Error messages V2 format

Example how to use: https://whitebit.com/api/v2/public/{endpoint}

All endpoints return time in Unix-time format.

All endpoints return either a JSON object array.

For receiving responses from API calls please use http method GET

If endpoint required parameters you will need to send them as query string

Error messages V2 format

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

Market Info

[GET] /api/v2/public/markets

This endpoint retrieves all information about available markets.

Response is cached for: 1 second

Parameters: NONE

Response:

{
  "success": true,
  "message": null,
  "result": [
    {
      "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.1",         // Default maker fee percent
      "takerFee": "0.1",         // Default taker fee percent
      "minAmount": "0.001",      // Minimal amount of stock to trade
      "minTotal": "0.001",       // Minimal amount of money to trade
      "tradesEnabled": true      // Is trading enabled
    },
    {
      ...
    }
  ]
}

Market activity

[GET] /api/v2/public/ticker

This endpoint retrieves information on recent trading activity on all markets.

Response is cached for: 1 second

Parameters: NONE

Response:

{
  "success": true,
  "message": null,
  "result": [
    {
      "lastUpdateTimestamp": "2020-07-10T13:37:27.000Z",     // ISO 8601 time format of last update
      "tradingPairs": "ETH_BTC",                             // Name of market pair
      "lastPrice": "0.026014",                               // Last deal price
      "lowestAsk": "0.026027",                               // Lowest ask price
      "highestBid": "0.026001",                              // Highest bid price
      "baseVolume24h": "13445.988",                          // Volume in stock currency
      "quoteVolume24h": "350.113082102",                     // Volume in money currency
      "tradesEnabled": true                                  // Is trading enabled on exchange
    },
    {
      ...
    }
  ]
}

Recent Trades

[GET] /api/v2/public/trades/{market}

This endpoint retrieves the trades that have been executed recently on the requested market

Response is cached for: 1 second

Parameters: NONE

Response:

{
  "success": true,
  "message": null,
  "result": [
    {
      "tradeId": 157257950,                 // A unique ID associated with the trade for the currency pair transaction Note: Unix timestamp does not qualify as trade_id.
      "price": "9371.69",                   // Price.
      "volume": "0.145642",                 // Amount.
      "time": "2020-07-09T14:13:01.000Z",   // Time.
      "isBuyerMaker": true                  // Sell order is taker: true, Buy order is taker: false
    },
    {
      ...
    }
  }
}

Fee

[GET] /api/v2/public/fee

This endpoint retrieves the trading fee.

Response is cached for: 1 second

Parameters: NONE

Response:

{
  "success": true,
  "message": null,
  "result": {
    "makerFee": "0.1", // Default maker fee (percent of trading amount in money currency)
    "takerFee": "0.1" // Default taker fee (percent of trading amount in money currency)
  }
}

Asset Status List

[GET] /api/v2/public/assets

This endpoint retrieves the assets status.

Response is cached for: 1 second

Parameters: NONE

Response:

{
  "success": true,
  "message": null,
  "result": {
    "BTC": {
      "id": "4f37bc79-f612-4a63-9a81-d37f7f9ff622",         // Asset id
      "lastUpdateTimestamp": "2020-07-10T13:20:07.000Z",    // ISO 8601 time format of last update
      "name": "Bitcoin",                                    // Name of currency
      "canWithdraw": true,                                  // Is currency withdrawable
      "canDeposit": true,                                   // Is currency depositable
      "minWithdrawal": "0.001",                             // Minimal amount to withdraw
      "maxWithdrawal": "0",                                 // Maximum amount to withdraw
      "makerFee": "0.1",                                    // Maker fee for currency
      "takerFee": "0.1"                                     // Taker fee for currency
    },
    {...}
  }
}

Orderbook

[GET] /api/v2/public/depth/{market}

This endpoint retrieves the current order book as two arrays (bids / asks).

Response is cached for: 100 ms

Parameters: NONE

Response:

{
  "success": true,
  "message": null,
  "result": {
      "lastUpdateTimestamp": "2020-07-09T14:49:12.000Z", // Timestamp of last update
      "asks": [
        [
          "9431.9",                                      // Price of lowest ask
          "0.705088"                                     // Amount of lowest ask
        ],
        [
          "9433.67",                                     // Price of the next ask
          "0.324509"                                     // Amount of the next ask
        ],
        [...]
      ],
      "bids": [
        [
          "9427.65",                                     // Price of highest bid
          "0.547909"                                     // Amount of highest bid
        ],
        [
          "9427.3",                                      // Price of next bid
          "0.669249"                                     // Amount of next bid
        ],
      ],
      [...]
  },
}