Skip to content
Public Rest API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md

README.md

Bitcoinbing Public Rest API

General API Information

  1. Base API Endpoint: https://publicapi.bitcoinbing.io
  2. All public api will return either JSON or Array object.
  3. Data is returned in descending order. Newest first, oldest last.
  4. All time and timestamp related fields are in seconds.

Public API

  1. MARKET STATUS

    GET /api/public/market-status Live link

    "Market Status" will give your an overview of markets and assets. This is helpful when you want to track the configuration of our markets, track fees or status of withdrawal deposit, market configuration and more. This response is not recommended for price polling because accurate realtime price is not guaranteed as there could be some delays. We recommend using price ticker API for all price tracking activity.

    Response object will have 2 keys Markets(all market related configs will be in this key) and Assets(all assets related configs will be here).

    Response:

    {
        "Markets": [
            {
              "coin": "BTC",
              "pair": "USDT",
              "fee": 0.25,
              "basePrecision": 0,
              "quotePrecision": 8,
              "minBuyAmount": 5.0,
              "minSellAmount": 5.0,
              "tradingStatus": "enable",
              "low": 9776.53700514,
              "high": 10957.42273101,
              "close": 10844.70389819,
              "open": 10648.15092657,
              "volumefrom": "272,755.19589541",
              "volumeto": "534,223.16923906",             
              "timestamp": 1562146720
            },
            ...
        ],
        "Assets": [
            {
                "coin": "BTC",
                "name": "Bitcoin",
                "deposit": "enable",
                "withdrawal": "enable",
                "minWithdrawalAmount": "0.002",
                "withdrawalFee": "0.001"                
            },
            ...
        ]
    }
    
    1. Markets key has multiple market related configuration, and description of every field in market is as below:

      1. coin: Coin name.
      2. pair: Pair name.
      3. fee: Fee consists of buy and sell order's fee percentage.
      4. basePrecision: Maximum precision of base asset, this the decimal point.
      5. quotePrecision: Maximum precision of quote asset.
      6. minBuyAmount: Minimum buy amount of base asset.
      7. minSellAmount: Minumum sell amount of base asset.
      8. tradingStatus:Trading Status.
      9. low: 24 hrs lowest price of base coin & pair.
      10. high: 24 hrs highest price of base coin & pair.
      11. close: Last traded price in current market.
      12. open: Market Open price 24hrs ago.
      13. volumefrom: Previous 24hrs traded volume.
      14. volumeto: Current traded volume.
      15. timestamp: Timestamp when information is fetched.
    2. Assets key have multiple asset related configuration as described below:

      1. coin: Coin name.
      2. name: Display name of asset.
      3. deposit: Denotes whether deposit is enabled or disabled.
      4. withdrawal: Denotes whether withdrawal is enabled or disabled.
      5. minWithdrawAmount: Minimum withdrawal amount in a single transaction.
      6. withdrawFee: Withdrawal fee of asset.
  2. MARKET TICKER

    GET /api/public/market-ticker Live link

    Get the latest market heart-beat for all the markets for the last 24hrs.

    Returns JSON response which has active market data with all ticker related values.

    Response:

    {
        "btcusdt": {
          "coin": "BTC",
          "pair": "USDT",
          "name": "BTC/USDT",
          "buy": 11106.69555345,
          "sell": 11139.17860952,
          "low": 9776.53700514,
          "high": 10957.42273101,
          "close": 10844.70389819,
          "open": 10648.15092657,
          "volume": "534,223.16923906",
          "timestamp": 1562148430
        },
        ...
    }
    

    Response has multiple key which denotes market data, this is in JSON. Find all the fields below:

    1. coin: Coin name
    2. pair: Pair name
    3. name: Display text.
    4. buy: Last buy order price
    5. sell: Last sell order price
    6. low: 24 hrs lowest price of base asset
    7. high: 24 hrs highest price of base asset
    8. close: Last traded price in current market
    9. open: Market Open price 24hrs ago
    10. volume: Last 24hrs traded volume
    11. timestamp: Timestamp when ticker information is fetched
  3. MARKET DEPTH

    GET /api/public/market-depth Live link

    Get last 25 orders for any market

    Returns JSON response which has order book of a perticular market

    Response:

    {
    "buy":[
                [
                  "11,389.20344241",
                  "0.00263210"
                ],
                ...
           ],
    "sell":[
               [
                 "11,394.37373348",
                 "0.00360129"
               ],
               ...
           ],
     "timestamp":1559561187,
    }
    
    
    1. ["11,389.20344241","0.00263210"] : [ PRICE, AMOUNT ]
    2. URL param fsym=BTC&tsym=USDT : Replace this with any market to get the desired order book. fsym='COIN_NAME' and tsym='PAIR_NAME'
  4. TRADE HISTORY

    GET api/public/trading-history Live link

    Get trade history of a market

    Returns JSON response which has trade history of a perticular market

    Response:

    [
      {
         "code": "BTC",
         "pair": "USDT",
         "type": "Buy",
         "price": "11,412.51340509",
         "amount": "0.00305040",
         "timestamp": "1562149565"
       }  
    ...
    ]
    
    1. URL param fsym=BTC&tsym=USDT : Replace this with any market to get the desired order book. fsym='COIN_NAME' and tsym='PAIR_NAME'

If you have any questions regarding APIs, please reach out to us at support@bitcoinbing.io

You can’t perform that action at this time.