# 行情介面
# 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"
}
}