# 行情接口
# 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"
}
}