# 行情介面

# 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
minStep	用戶輸入步長
volumePrecision	交易數量精度
pricePrecision	價格精度
feeRate	交易手續費
tradeMinLimit	交易最小單位，單位為張
currency	結算和保證金貨幣資產
asset	合約交易資產
maxLongLeverage	多頭交易的最大槓桿倍數
maxShortLeverage	空頭交易的最大槓桿倍數

    # Response
    {
        "code": 0,
        "msg": "",
        "data": [{
            "contractId": "100",
            "symbol": "BTC-USDT",
            "name": "BTC合約",
            "size": "0.0001",
            "minStep": "0.5",
            "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",
            "minStep": "0.05",
            "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"
        }
    }

← 基礎信息賬戶介面 →