# 行情接口

# 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: 2021/5/17 上午11:05:34