# Market Interface

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

# 1. Contracts /contracts

The /contracts endpoint provides a summary of all contracts traded on the exchange.

HTTP Requests

    # Request
    GET /contracts

Return Fields

Field Description
ticker_id Identifier of a ticker with delimiter to separate base/quote, eg. BTC-USDT
base_currency Symbol/currency code of base pair, eg. BTC
quote_currency Symbol/currency code of target pair, 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
target_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
product_type What product is this? Futures, Perpetual, Options?
open_interest The open interest in the last 24 hours in contracts
index_price Underlying index price
index_name Name of the underlying index if any
index_currency Underlying currency for index
start_timestamp Starting of this derivative product (relevant for expirable futures or options)
end_timestamp Ending of this derivative product (relevant for expirable futures or options)
funding_rate Current funding rate
next_funding_rate Upcoming predicted funding rate
next_funding_rate_timestamp Timestamp of the next funding rate change
# Response
{
   "success":"true",
   "code":0,
   "result":[
      {
         "ticker_id":"BTC-USDT",
         "base_currency":"BTC",
         "target_currency":"USDT",
         "last_price":"41940.35",
         "base_volume":"14854.18",
         "target_volume":"621808932.91",
         "bid":"41940.35",
         "ask":"41948.73",
         "high":"42350.57",
         "low":"41560.74",
         "product_type":"Perpetual",
         "open_interest":"186088685.79",
         "index_price":"41940.35",
         "index_name":"BTC-USDT",
         "index_currency":"USDT",
         "start_timestamp":"0",
         "end_timestamp":"0",
         "funding_rate":"0.000100000",
         "next_funding_rate":"0.000100000",
         "next_funding_rate_timestamp":"1642665599",
         "contract_type":"",
         "contract_price":"41940.35",
         "contract_price_currency":"USDT"
      },
      ...
}

# 2. 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",
       "bids":[
          [
             41940.0,
             0.2930
          ],
          ...
       ],
       "asks":[
          [
             41941.2,
             0.1793
          ],
          ...
       ],
       "timestamp":1642650896587
    }
 }
Last Updated: 1/20/2022, 3:41:20 PM