# 行情介面

# 1. 查詢合約基礎信息

HTTP請求

    # Request
    GET api/v1/market/getAllContracts
    
    example: https://api-swap-rest.bingbon.pro/api/v1/market/getAllContracts

返回值說明

返回欄位 欄位說明
code 是否有錯誤信息,0為正常,1為有錯誤
msg 錯誤信息描述
contractId 合約ID
symbol 合約產品符號,以A_B的形式返回
name 合約產品名字
size 合約大小,例如0.0001 BTC
volumePrecision 交易數量精度
pricePrecision 價格精度
feeRate 交易手續費
tradeMinLimit 交易最小單位,單位為張
currency 結算和保證金貨幣資產
asset 合約交易資產
maxLongLeverage 多頭交易的最大槓桿倍數
maxShortLeverage 空頭交易的最大槓桿倍數
    # Response
    {
        "code": 0,
        "msg": "",
        "data": [{
            "contractId": "100",
            "symbol": "BTC-USDT",
            "name": "BTC合約",
            "size": "0.0001",
            "volumePrecision": 0,
            "pricePrecision": 2,
            "feeRate": 0.001,
            "tradeMinLimit": 1,
            "currency": "USDT",
            "asset": "BTC",
            "maxLongLeverage": 100,
            "maxShortLeverage": 100
        }, {
            "contractId": "101",
            "symbol": "ETH_USDT",
            "name": "ETH合約",
            "size": "0.01",
            "volumePrecision": 0,
            "pricePrecision": 2,
            "feeRate": 0.001,
            "tradeMinLimit": 1,
            "currency": "USDT",
            "asset": "ETH",
            "maxLongLeverage": 50,
            "maxShortLeverage": 50
        }],
        ...
   } 

# 2. 查詢合約最新價格

HTTP請求

    # Request
    GET api/v1/market/getLatestPrice

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT

返回值說明

參數名 參數類型 描述
tradePrice float64 成交價格
indexPrice float64 指數價格
fairPrice float64 標記價格
# Response
    {
        "code": 0,
        "msg": "",
        "data": {
          "tradePrice": "50000.18",
          "indexPrice": "50000.18",
          "fairPrice": "50000.18"
        }
    }

# 3. 查詢合約交易深度

HTTP請求

    # Request
    GET api/v1/market/getMarketDepth

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT
level String 層數 若為空,則默認返回5層

返回值說明

參數名 參數類型 描述
code Int64 是否有錯誤信息,0為正常,1為有錯誤
msg String 錯誤信息描述
asks 數組 賣方深度
bids 數組 買方深度
p float64 price價格
v float64 volume數量
    # Response
    {
        "code": 0,
        "msg": "",
        "data": {
            "asks": [
              {
                "p": 5319.94,
                "v": 0.05483456
              },{
                "p": 5320.19,
                "v": 1.05734545
              },{
                "p": 5320.39,
                "v": 1.16307999
              },{
                "p": 5320.94,
                "v": 0.05483456
              },{
                "p": 5330.19,
                "v": 1.05734545
              },{
                "p": 5330.39,
                "v": 1.16307999
              },
            ],
            "bids": [
              {
                "p": 5319.93,
                "v": 0.05483456
              },{
                "p": 5318.19,
                "v": 1.05734545
              },{
                "p": 5317.39,
                "v": 1.16307999
              },{
                "p": 5316.94,
                "v": 0.05483456
              },{
                "p": 5315.19,
                "v": 1.05734545
              },{
                "p": 5314.39,
                "v": 1.16307999
              },
            ],
        }
    }

# 4. 查詢最新成交記錄

HTTP請求

    # Request
    GET api/v1/market/getMarketTrades

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT

返回值說明

參數名 參數類型 描述
time data 成交時間
makerSide String 吃單方向(Buy / Sell 買/賣)
price String 成交價格
volume String 成交數量
    # Response
    {
        "code": 0,
        "msg": "",
        "data": {
            "trades": [
                {
                    "time": "2018-04-25T15:00:51.999Z",
                    "makerSide": "Buy",
                    "price": 0.279563,
                    "volume": 100,
                },
                {
                    "time": "2018-04-25T15:00:51.000Z",
                    "makerSide": "Sell",
                    "price": 0.279563,
                    "volume": 300,
                }
            ]
        }
    }

# 5. 查詢最新資金費率

HTTP請求

    # Request
    GET api/v1/market/getLatestFunding

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT

返回值說明

參數名 參數類型 描述
fundingRate float64 當前資金費率
fairPrice float64 當前的標記價格
leftSeconds float64 下次結算剩餘時間,單位為秒
# Response
    {
        "code": 0,
        "msg": "",
        "data": {
          "fundingRate": "0.3000",
          "fairPrice": "182.90",
          "leftSeconds": "1024",
        }
    }

# 6. 查詢資金費率歷史

HTTP請求

    # Request
    GET api/v1/market/getHistoryFunding

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT

返回值說明

參數名 參數類型 描述
historyId String 歷史ID號
fundingRate String 資金費率
fairPrice String 標記價格
interval String 資金費率結算周期,單位:小時
time data 結算時間
    # Response
    {
        "code": 0,
        "msg": "",
        "data": {
            "fundings": [
                {
                    "historyId": "687",
                    "symbol": "ETH-USDT",
                    "fundingRate": "0.3000",
                    "fairPrice": "182.73",
                    "interval": "8",
                    "time": "2019-10-28T16:00:00.000Z"
                },
                {
                    "historyId": "686",
                    "symbol": "ETH-USDT",
                    "fundingRate": "0.3000",
                    "fairPrice": "182.90",
                    "interval": "8",
                    "time": "2019-10-28T15:00:00.000Z"
                }
            ]
        }
    }

# 7. 查詢K線最新數據

 查詢最新成交價格的K線最新數據。

HTTP請求

    # Request
    GET api/v1/market/getLatestKline

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT
klineType String k線類型 參考欄位說明,如分鐘,小時,周等

備註

klineType 欄位說明
1 1m一分鐘K線
3 3m三分鐘K線
5 5m五分鐘K線
15 15m十五分鐘K線
30 30m三十分鐘K線
60 1h一小時K線
120 2h兩小時K線
240 4h四小時K線
360 6h六小時K線
720 12h十二小時K線
1D 1D日K線
1W 1W周K線
1M 1M月K線

返回值說明

參數名 參數類型 描述
open float64 開盤價
close float64 收盤價
high float64 最高價
low float64 最低價
volume float64 交易數量
ts int64 k線時間戳,單位毫秒
# Response
    {
        "code": 0,
        "msg": "",
        "data": {
            "kline": {
                "ts": 1572253500000,
                "open": 181.41,
                "close": 181.54,
                "high": 181.54,
                "low": 181.39,
                "volume": 281
            }
        }
    }

# 8. 查詢K線歷史數據

 查詢一段時間周期內成交價格的K線歷史數據。

HTTP請求

    # Request
    GET api/v1/market/getHistoryKlines

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT
klineType String k線類型 參考欄位說明,如分鐘,小時,周等
startTs int64 起始時間戳,單位毫秒
endTs int64 結束時間戳,單位毫秒

備註

klineType 欄位說明
1 1m一分鐘K線
3 3m三分鐘K線
5 5m五分鐘K線
15 15m十五分鐘K線
30 30m三十分鐘K線
60 1h一小時K線
120 2h兩小時K線
240 4h四小時K線
360 6h六小時K線
720 12h十二小時K線
1D 1D日K線
1W 1W周K線
1M 1M月K線

返回值說明

參數名 參數類型 描述
klines 數組 K線數據
open float64 開盤價
close float64 收盤價
high float64 最高價
low float64 最低價
volume float64 交易數量
ts int64 k線時間戳,單位毫秒
# Response
    {
        "code": 0,
        "msg": "",
        "data": {
            "klines": [
                {
                    "ts": 1572253140000,
                    "open": 181.89,
                    "close": 181.97,
                    "high": 182.04,
                    "low": 181.89,
                    "volume": 2136
                },
                {
                    "ts": 1572253200000,
                    "open": 181.94,
                    "close": 181.72,
                    "high": 181.94,
                    "low": 181.72,
                    "volume": 965
                },
                {
                    "ts": 1572253260000,
                    "open": 181.69,
                    "close": 181.72,
                    "high": 181.72,
                    "low": 181.56,
                    "volume": 1245
                },
                {
                    "ts": 1572253320000,
                    "open": 181.72,
                    "close": 181.73,
                    "high": 181.81,
                    "low": 181.69,
                    "volume": 541
                },
                {
                    "ts": 1572253380000,
                    "open": 181.77,
                    "close": 181.59,
                    "high": 181.77,
                    "low": 181.53,
                    "volume": 933
                },
                {
                    "ts": 1572253440000,
                    "open": 181.59,
                    "close": 181.38,
                    "high": 181.62,
                    "low": 181.38,
                    "volume": 1425
                },
                {
                    "ts": 1572253500000,
                    "open": 181.41,
                    "close": 181.64,
                    "high": 181.64,
                    "low": 181.39,
                    "volume": 923
                }
            ]
        }
    }

# 9. 查詢合約未平倉數量

HTTP請求

    # Request
    GET api/v1/market/getOpenPositions

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT

返回值說明

參數名 參數類型 描述
volume float64 持倉數量
unit string 持倉數量對應的單位,CONT(張), BTC, ETH, LINK, BCH等等
# Response
    {
        "code": 0,
        "msg": "",
        "data": {
          "volume": "10.00",
          "unit": "BTC",
        }
    }

# 10. 查詢合約24小時價格變動情況

HTTP請求

    # Request
    GET api/v1/market/getTicker

請求參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT

返回值說明

參數名 參數類型 描述
symbol String 合約名稱
priceChange String 價格變動, 單位是USDT
priceChangePercent String 價格變動百分比
lastPrice String 最新交易價格
lastVolume String 最新交易數量
highPrice String 24小時最高價
lowPrice String 24小時最低價
volume String 24小時成交量
dayVolume String 24小時成交額, 單位是USDT
openPrice String 24小時內第一個價格
# Response
    {
        "code": 0,
        "msg": "",
        "data": {
          "symbol": "BTC-USDT",
          "priceChange": "10.00",
          "priceChangePercent": "10",
          "lastPrice": "5738.23",
          "lastVolume": "31.21",
          "highPrice": "5938.23",
          "lowPrice": "5238.23",
          "volume": "23211231.13",
          "dayVolume": "213124412412.47",
          "openPrice": "5828.32"
        }
    }
Last Updated: 17/5/2021 上午11:05:34