# Market Interface

# CoinMarketCap

Endpoint: https://api.bingbon.com/api/v1/market/cmc/spot/

# 1. Summary /summary

The summary endpoint is to provide an overview of market data for all tickers and all market pairs on the exchange.

HTTP Requests

    # Request
    GET /summary

Return Fields

Field Description
ticker_id Identifier of a ticker with delimiter to separate base/quote, eg. BTC-USD (Price of BTC is quoted in USD)
base_currency Symbol/currency code of base currency, eg. BTC
quote_currency Symbol/currency code of quote currency, eg. USD
last_price Last transacted price of base currency based on given quote currency
lowest_ask Lowest Ask price of base currency based on given quote currency
highest_bid Highest bid price of base currency based on given quote currency
base_volume 24-hr volume of market pair denoted in BASE currency
quote_volume 24-hr volume of market pair denoted in QUOTE currency
price_change_percent_24h 24-hr % price change of market pair
highest_price_24h Highest price of base currency based on given quote currency in the last 24-hrs
lowest_price_24h Lowest price of base currency based on given quote currency in the last 24-hrs
# Response
{
   "code":0,
   "timestamp":1642647818151,
   "data":[
      {
         "ticker_id":"BTC-USDT",
         "base_currency":"BTC",
         "quote_currency":"USDT",
         "last_price":42033.58,
         "lowest_ask":42041.986716,
         "highest_bid":42025.173284,
         "base_volume":1753.752344,
         "quote_volume":73432355.795524,
         "price_change_percent_24h":-0.009519,
         "highest_price_24h":42559.27,
         "lowest_price_24h":41100
      },
      ...
   ]
}

# 2. Ticker /ticker

The ticker endpoint is to provide a 24-hour pricing and volume summary for each market pair available on the exchange.

HTTP Requests

  # Request
  GET /ticker

**Return Fields

Field Description
last_price Last transacted price of base currency based on given quote currency
base_volume 24-hour trading volume denoted in BASE currency
quote_volume 24 hour trading volume denoted in QUOTE currency
isFrozen Indicates if the market is currently enabled (0) or disabled (1).
# Response
{
   "code":0,
   "timestamp":1642648056171,
   "data":{
      "BTC-USDT":{
         "last_price":42000,
         "base_volume":1753.390017,
         "quote_volume":73415971.34346,
         "isFrozen":0
      },
      ...
}

# 3. Order book /orderbook/market_pair

The order book endpoint is to provide a complete level 2 order book (arranged by best asks/bids) with full depth returned for a given market pair.

HTTP Requests

    # Request
    GET /orderbook/BTC-USDT

Return Fields

Field Description
timestamp Unix timestamp in milliseconds for when the last updated time occurred.
bids An array containing 2 elements. The offer price and quantity for each bid order.
asks An array containing 2 elements. The ask price and quantity for each ask order.
# Response
{
   "code":0,
   "timestamp":1642648332283,
   "data":{
      "ticker_id":"BTC-USDT",
      "timestamp":1642648332283,
      "bids":[
         [
            41977.79,
            0.258769
         ],
         ...
      ],
      "asks":[
         [
            41977.8,
            0.314369
         ],
         ...
   }
}

# 4. Trades /trades/market_pair

The trades endpoint is to return data on all recently completed trades for a given market pair.

HTTP Requests

  # Request
  GET /trades/BTC-USDT

Return Fields

Field Type
trade_id A unique ID associated with the trade for the currency pair transaction
price Last transacted price of base currency based on given quote currency
base_volume Transaction amount in BASE currency.
quote_volume Transaction amount in QUOTE currency.
timestamp Unix timestamp in milliseconds for when the transaction occurred.
type Used to determine whether or not the transaction originated as a buy or sell. Buy – Identifies an ask was removed from the order book. Sell – Identifies a bid was removed from the order book.
 # Response
{
   "code":0,
   "timestamp":1642648499850,
   "data":[
      {
         "trade_id":"123456",
         "price":42000.23,
         "base_volume":0.00017,
         "quote_volume":7.15,
         "timestamp":1642648499538,
         "type":"Sell"
      },
      ...
   ]
}

# CoinGecko

Endpoint: https://api.bingbon.com/api/coingecko/v1/spot/

# 1. Pairs /pairs

Details on cryptoassets traded on the exchange.

HTTP Requests

    # Request
    GET /pairs

Return Fields

Field Description
ticker_id Identifier of a ticker with delimiter to separate base/target, eg. BTC_USDT
base Symbol/currency code of a the base cryptoasset, eg. BTC
target Symbol/currency code of the target cryptoasset, eg. USDT
# Response
{
   "success":"true",
   "code":0,
   "result":[
      {
         "ticker_id":"BTC-USDT",
         "base":"BTC",
         "target":"USDT"
      },
      ...
}

# 2. Ticker /ticker

The /tickers endpoint provides 24-hour pricing and volume information on each market pair available on the exchange.

HTTP Requests

  # Request
  GET /ticker

**Return Fields

Field Description
ticker_id Identifier of a ticker with delimiter to separate base/target, eg. BTC_USDT
base_currency Symbol/currency code of a the base cryptoasset, eg. BTC
target_currency Symbol/currency code of the target cryptoasset, eg. USDT
last_price Last transacted price of base currency based on given target currency
base_volume 24 hour trading volume in base pair volume
quote_volume 24 hour trading volume in target pair volume
bid Current highest bid price
ask Current lowest ask price
high Rolling 24-hours highest transaction price
low Rolling 24-hours lowest transaction price
# Response
{
    "success":"true",
    "code":0,
    "result":[
       {
          "ticker_id":"BTC-USDT",
          "base_currency":"BTC",
          "target_currency":"USDT",
          "last_price":"41922.22",
          "base_volume":"1753.390017",
          "target_volume":"73415971.35",
          "bid":"41913.835556",
          "ask":"41930.604444",
          "high":"42559.27",
          "low":"41100"
       },
       ...
    ]
 }

# 3. Order book /orderbook/ticker_id

The /orderbook/ticker_id endpoint is to provide order book information for a given market pair/ticker.

HTTP Requests

    # Request
    GET /orderbook/BTC-USDT

Return Fields

Field Description
ticker_id A pair such as "BTC_USDT", with delimiter between different cryptoassets
timestamp Unix timestamp in milliseconds for when the last updated time occurred.
bids An array containing 2 elements. The offer price and quantity for each bid order.
asks An array containing 2 elements. The ask price and quantity for each ask order.
# Response
{
    "success":"true",
    "code":0,
    "result":{
       "ticker_id":"BTC-USDT",
       "base":"BTC",
       "target":"USDT",
       "timestamp":"1642649819",
       "bids":[
          [
             "41910.91",
             "0.218379"
          ],
          ...
       ],
       "asks":[
          [
             "41910.92",
             "0.387427"
          ],
          ...
       ]
    }
 }

# 4. Trades /historical_trades/ticker_id

The /historical_trades/ticker_id is used to return data on historical completed trades for a given market pair.

HTTP Requests

  # Request
  GET /historical_trades/BTC-USDT

Return Fields

Field Type
trade_id A unique ID associated with the trade for the currency pair transaction
price Last transacted price of base currency based on given quote currency
base_volume Transaction amount in BASE currency.
quote_volume Transaction amount in QUOTE currency.
timestamp Unix timestamp in milliseconds for when the transaction occurred.
type Used to determine whether or not the transaction originated as a buy or sell. Buy – Identifies an ask was removed from the order book. Sell – Identifies a bid was removed from the order book.
# Response
{
 "success":"true",
 "code":0,
 "result":{
    "buy":[
       {
          "trade_id":"123456",
          "price":"41901.09",
          "base_volume":"0.020000",
          "target_volume":"838.03",
          "trade_timestamp":"1642649904",
          "type":"buy"
       },
       ...
    ]
 }
}
Last Updated: 4/22/2022, 12:58:16 PM