# 行情接口

# 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"
        }
    }

← 基础信息账户接口 →