行情接口
获取服务器时间
GET /api/v1/time
获取服务器时间
权重: 1
参数: NONE
响应:
json
{
"serverTime": 1538323200000
}获取交易规则和交易对
GET /api/v1/exchangeInfo
获取交易规则和交易对
权重:1
参数:NONE
响应:
json
{
"timezone": "UTC",
"brokerFilters": [],
"symbols": [ // 现货交易对
{
"filters":[
{
"minPrice":"0.01",
"maxPrice":"100000.00000000",
"tickSize":"0.01",
"filterType":"PRICE_FILTER"
},
{
"minQty":"0.0001", // 最小交易数量, 注意这里是币的数量不是张数
"maxQty":"4000", // 最大交易数量, 注意这里是币的数量不是张数
"stepSize":"0.0001",
"filterType":"LOT_SIZE"
},
{
"minNotional":"10",
"filterType":"MIN_NOTIONAL"
},
{
"minAmount":"10", // 最小交易额
"maxAmount":"6600000", // 最大交易额
"minBuyPrice":"0.01", // 最小买入价格
"filterType":"TRADE_AMOUNT"
},
{
"maxSellPrice":"99999999", // 限价最大卖出价格
"buyPriceUpRate":"0.1", // 限价最大卖出价格
"sellPriceDownRate":"0.1", // 限价最大卖出价格
"sellPriceDownRate":"0.1", // 限价最大卖出价格
"maxEntrustNum":"100000", // 委托单最大比数(合约)
"maxConditionNum":"100000", // 条件单最大比数(合约
"filterType":"LIMIT_TRADING"
},
{
"buyPriceUpRate":"0.1", // 买入不能高于标记(合约)/最新(现货)价的 10%
"sellPriceDownRate":"0.1", // 卖出不能低于标记(合约)/最新(现货)价的 10%
"filterType":"MARKET_TRADING"
},
{
"noAllowMarketStartTime":"0", // 不允许使用市价单开始时间
"noAllowMarketEndTime":"0", // 不允许使用市价单结束时间
"limitOrderStartTime":"0", // 限时限价单开始时间
"limitOrderEndTime":"0", // 限时限价单结束时间
"limitMinPrice":"0", // 限时限价单最低价格
"limitMaxPrice":"0", // 限时限价单最高价格
"filterType":"OPEN_QUOTE"
}
],
"exchangeId": "301",
"symbol": "ETHUSDT",
"symbolName": "ETHUSDT",
"status": "TRADING",
"baseAsset": "ETH",
"baseAssetName": "ETH",
"baseAssetPrecision": "0.0001",
"quoteAsset": "USDT",
"quoteAssetName": "USDT",
"quotePrecision": "0.01",
"icebergAllowed": false,
"isAggregate": false,
"allowMargin": true
}
],
"rateLimits": [
{
"rateLimitType": "REQUEST_WEIGHT",
"interval": "MINUTE",
"intervalUnit": 1,
"limit": 3000
},
{
"rateLimitType": "ORDERS",
"interval": "SECOND",
"intervalUnit": 60,
"limit": 60
}
],
"options": [],
"contracts": [ // 合约交易对
{
"filters":[
{
"minPrice":"0.01",
"maxPrice":"100000.00000000",
"tickSize":"0.01",
"filterType":"PRICE_FILTER"
},
{
"minQty":"0.0001",
"maxQty":"4000",
"stepSize":"0.0001",
"filterType":"LOT_SIZE"
},
{
"minNotional":"10",
"filterType":"MIN_NOTIONAL"
},
{
"minAmount":"10", // 最小交易额
"maxAmount":"6600000", // 最大交易额
"minBuyPrice":"0.01", // 最小买入价格
"filterType":"TRADE_AMOUNT"
},
{
"maxSellPrice":"99999999", // 限价最大卖出价格
"buyPriceUpRate":"0.1", // 限价最大卖出价格
"sellPriceDownRate":"0.1", // 限价最大卖出价格
"sellPriceDownRate":"0.1", // 限价最大卖出价格
"maxEntrustNum":"100000", // 委托单最大比数(合约)
"maxConditionNum":"100000", // 条件单最大比数(合约
"filterType":"LIMIT_TRADING"
},
{
"buyPriceUpRate":"0.1", // 买入不能高于标记(合约)/最新(现货)价的 10%
"sellPriceDownRate":"0.1", // 卖出不能低于标记(合约)/最新(现货)价的 10%
"filterType":"MARKET_TRADING"
},
{
"noAllowMarketStartTime":"0", // 不允许使用市价单开始时间
"noAllowMarketEndTime":"0", // 不允许使用市价单结束时间
"limitOrderStartTime":"0", // 限时限价单开始时间
"limitOrderEndTime":"0", // 限时限价单结束时间
"limitMinPrice":"0", // 限时限价单最低价格
"limitMaxPrice":"0", // 限时限价单最高价格
"filterType":"OPEN_QUOTE"
}
],
"exchangeId": "301",
"symbol": "BTC-SWAP-USDT",
"symbolName": "BTC-SWAP-USDTUSDT",
"status": "TRADING",
"baseAsset": "BTC-SWAP-USDT",
"baseAssetPrecision": "1",
"quoteAsset": "USDT",
"quoteAssetPrecision": "0.1",
"icebergAllowed": false,
"inverse": false,
"index": "BTCUSDT",
"marginToken": "USDT",
"marginPrecision": "0.0001",
"contractMultiplier": "0.0001",
"underlying": "BTC",
"riskLimits": [
{
"riskLimitId": "200000133",
"quantity": "1000000.0",
"initialMargin": "0.01",
"maintMargin": "0.005"
},
{
"riskLimitId": "200000134",
"quantity": "2000000.0",
"initialMargin": "0.02",
"maintMargin": "0.01"
},
{
"riskLimitId": "200000135",
"quantity": "3000000.0",
"initialMargin": "0.03",
"maintMargin": "0.015"
},
{
"riskLimitId": "200000136",
"quantity": "4000000.0",
"initialMargin": "0.04",
"maintMargin": "0.02"
}
]
},
{
"filters":[
{
"minPrice":"0.01",
"maxPrice":"100000.00000000",
"tickSize":"0.01",
"filterType":"PRICE_FILTER"
},
{
"minQty":"0.0001",
"maxQty":"4000",
"stepSize":"0.0001",
"filterType":"LOT_SIZE"
},
{
"minNotional":"10",
"filterType":"MIN_NOTIONAL"
},
{
"minAmount":"10", // 最小交易额
"maxAmount":"6600000", // 最大交易额
"minBuyPrice":"0.01", // 最小买入价格
"filterType":"TRADE_AMOUNT"
},
{
"maxSellPrice":"99999999", // 限价最大卖出价格
"buyPriceUpRate":"0.1", // 限价最大卖出价格
"sellPriceDownRate":"0.1", // 限价最大卖出价格
"sellPriceDownRate":"0.1", // 限价最大卖出价格
"maxEntrustNum":"100000", // 委托单最大比数(合约)
"maxConditionNum":"100000", // 条件单最大比数(合约
"filterType":"LIMIT_TRADING"
},
{
"buyPriceUpRate":"0.1", // 买入不能高于标记(合约)/最新(现货)价的 10%
"sellPriceDownRate":"0.1", // 卖出不能低于标记(合约)/最新(现货)价的 10%
"filterType":"MARKET_TRADING"
},
{
"noAllowMarketStartTime":"0", // 不允许使用市价单开始时间
"noAllowMarketEndTime":"0", // 不允许使用市价单结束时间
"limitOrderStartTime":"0", // 限时限价单开始时间
"limitOrderEndTime":"0", // 限时限价单结束时间
"limitMinPrice":"0", // 限时限价单最低价格
"limitMaxPrice":"0", // 限时限价单最高价格
"filterType":"OPEN_QUOTE"
}
],
"exchangeId": "301",
"symbol": "BTC-SWAP",
"symbolName": "BTC-SWAP",
"status": "TRADING",
"baseAsset": "BTC-SWAP",
"baseAssetPrecision": "1",
"quoteAsset": "USDT",
"quoteAssetPrecision": "0.1",
"icebergAllowed": false,
"inverse": true,
"index": "BTCUSDT",
"marginToken": "BTC",
"marginPrecision": "0.00000001",
"contractMultiplier": "1.0",
"underlying": "BTC",
"riskLimits": [
{
"riskLimitId": "200000137",
"quantity": "1000000.0",
"initialMargin": "0.01",
"maintMargin": "0.005"
},
{
"riskLimitId": "200000138",
"quantity": "2000000.0",
"initialMargin": "0.02",
"maintMargin": "0.01"
},
{
"riskLimitId": "200000139",
"quantity": "3000000.0",
"initialMargin": "0.03",
"maintMargin": "0.015"
},
{
"riskLimitId": "200000140",
"quantity": "4000000.0",
"initialMargin": "0.04",
"maintMargin": "0.02"
}
]
}
],
"coins": [
{
"orgId": "9001",
"coinId": "ETH",
"coinName": "ETH",
"coinFullName (tokenFullName)": "Ethereum",
"allowWithdraw": true,
"allowDeposit": true,
"chainTypes": []
},
{
"orgId": "9001",
"coinId": "USDT",
"coinName": "USDT",
"coinFullName (tokenFullName)": "TetherUS",
"allowWithdraw": true,
"allowDeposit": true,
"chainTypes": [
{
"chainType": "ERC20",
"withdrawFee": "0.1",
"minWithdrawQuantity": "10",
"maxWithdrawQuantity": "1000",
"minDepositQuantity": "1",
"allowDeposit": true,
"allowWithdraw": true
},
{
"chainType": "TRC20",
"withdrawFee": "0.1",
"minWithdrawQuantity": "10",
"maxWithdrawQuantity": "1000",
"allowDeposit": true,
"allowWithdraw": true
},
{
"chainType": "OMNI",
"withdrawFee": "0.1",
"minWithdrawQuantity": "10",
"maxWithdrawQuantity": "1000",
"allowDeposit": true,
"allowWithdraw": true
}
]
},
{
"orgId": "9001",
"coinId": "BTC",
"coinName": "BTC",
"coinFullName": "Bitcoin",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
},
{
"orgId": "9001",
"coinId": "UNI",
"coinName": "UNI",
"coinFullName": "uniswap",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
},
{
"orgId": "9001",
"coinId": "XRP",
"coinName": "XRP",
"coinFullName (tokenFullName)": "XRP",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
},
{
"orgId": "9001",
"coinId": "EOS",
"coinName": "EOS1",
"coinFullName (tokenFullName)": "EOS",
"allowWithdraw": true,
"allowDeposit": true,
"chainTypes": []
},
{
"orgId": "9001",
"coinId": "JET",
"coinName": "JET",
"coinFullName (tokenFullName)": "JET",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
}
]
}status字段说明:
对于现货币对(symbols数组中的币对),status可能的值:
| 状态值 | 说明 |
|---|---|
| TRADING | 交易中 |
| ONLINE | 在线(不可交易) |
| OFFLINE | 离线(币对已下线) |
| API_TRADE_FORBIDDEN | API交易被禁止(禁止通过API进行交易) |
对于合约币对(contracts数组中的币对),status可能的值:
| 状态值 | 说明 |
|---|---|
| TRADING | 交易中 |
| ONLINE | 在线(不可交易) |
| API_TRADE_FORBIDDEN | API交易被禁止(禁止通过API进行交易) |
| OPEN_FORBIDDEN | 禁止开仓(禁止开仓,但可以平仓) |
| CLOSE_FORBIDDEN | 禁止平仓(禁止平仓,但可以开仓) |
深度信息
GET /quote/v1/depth
权重:
| limit | 权重 |
|---|---|
| 5, 10, 20, 50, 100 | 1 |
| 500 | 5 |
| 1000 | 10 |
响应:
json
{
"t": 1768300458706,//撮合时间
"b": [
[
"3.90000000", // 价格
"431.00000000" // 数量
],
[
"4.00000000",
"431.00000000"
]
],
"a": [
[
"4.00000200", // 价格
"12.00000000" // 数量
],
[
"5.10000000",
"28.00000000"
]
]
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| limit | INT | NO | 默认 100; |
注意:如果设置limit=0会返回很多数据。
合并深度
GET /quote/v1/depth/merged
合并深度接口。
权重:1
响应
json
{
"t": 1672035413265,//时间
"b": [//买入深度高到低
[
"16851.95",//价格
"0.003321"//数量
],
[
"16851.87",
"0.005456"
],
[
"16851.47",
"0.002219"
]
],
"a": [//卖出深度低到高
[
"16870.19",
"0.003838"
],
[
"16873.05",
"0.00361"
],
[
"16873.06",
"0.002623"
]
]
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| scale | INT | NO | 档位: 0,1,2,3,4,5 例如:0表示1档,1表示2档 |
| limit | INT | NO | 返回条数 |
近期成交
GET /quote/v1/trades
获取当前最新成交(最多60)
权重:1
响应:
json
[
{
"p": "4.00000100",
"q": "12.00000000",
"t": 1499865549590,
"ibm": true // 成交方向 isBuyerMaker
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| limit | INT | NO | 默认 60; 最大 60 |
K线数据
GET /quote/v1/klines
symbol的k线/烛线图数据,K线会根据开盘时间而辨别。
权重:1
响应:
json
[
[
1499040000000, // 开盘时间
"0.01634790", // 开盘价
"0.80000000", // 最高价
"0.01575800", // 最低价
"0.01577100", // 收盘价
"148976.11427815", // 交易量
1499644799999, // 收盘时间
"2434.19055334", // Quote asset数量
308, // 交易次数
"1756.87402397", // Taker buy base asset数量
"28.46694368" // Taker buy quote asset数量
]
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| interval | ENUM | YES | 时间间隔 |
| startTime | LONG | NO | 开始时间 |
| endTime | LONG | NO | 结束时间 |
| limit | INT | NO | 默认 1000; 最大 1000 |
注意: 如果startTime和endTime没有发送,只有最新的K线会被返回。
价格指数K线数据
GET /quote/v1/index/klines
获取某个交易对的价格指数K线
响应:
json
{
"code": 200,
"data": [
{
"t": 1669155300000,// 时间戳
"s": "BTCUSDT",// 币对
"sn": "BTCUSDT",// 币对名称
"c": "1127.1",// 收盘价
"h": "1130.81",// 最高价
"l": "1126.17",// 最低价
"o": "1130.8",// 开盘价
"v": "0",// 成交量
"st": 1669156800000 // 接口响应时间戳
},
{
"t": 1669156200000,
"s": "ETH-SWAP-USDT",
"sn": "ETH-SWAP-USDTUSDT",
"c": "1129.44",
"h": "1129.54",
"l": "1127.1",
"o": "1127.1",
"v": "0",
"st": 1669156800000
}
]
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| interval | ENUM | YES | 时间间隔 |
| from | LONG | YES | 开始时间 |
| to | LONG | YES | 结束时间 |
| limit | INT | NO | 限制条数,默认值:2000 最大值:2000 |
价格指数成分
GET /quote/v1/indexPriceComponents
获取某个交易对的价格指数成分
响应:
json
{
"index": "91429.02891304", //最新指数价格
"edp": "91408.35002101", //10分钟指数价格平均值
"components": [
{
"exchange": "BITGET", //现货交易所
"spotPair": "BTCUSDT",
"weight": "1.0" //权重
},
{
"exchange": "KUCOIN",
"spotPair": "BTCUSDT",
"weight": "1.0"
},
{
"exchange": "COINBASE",
"spotPair": "BTCUSDT",
"weight": "1.0"
},
{
"exchange": "MEXC",
"spotPair": "BTCUSDT",
"weight": "1.0"
},
{
"exchange": "BYBIT",
"spotPair": "BTCUSDT",
"weight": "1.0"
},
{
"exchange": "OKEX",
"spotPair": "BTCUSDT",
"weight": "1.0"
},
{
"exchange": "BINANCE",
"spotPair": "BTCUSDT",
"weight": "1.0"
}
],
"time": 1768277194000 //指数更新时间
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
标记价格K线数据
GET /quote/v1/markPrice/klines
响应:
json
{
"code": 200,
"data": [
{
"symbol": "BTC-SWAP-USDT",//币对
"time": 1670157900000,//时间戳
"low": "16991.14096",//最低价
"open": "16991.78288",//开盘价
"high": "16996.30641",//最高价
"close": "16996.30641",//收盘价
"volume": "0",//成交量
"curId": 1670157900000,
"klineType": "1m", // k线类型,比如 1m,5m....
"change": "0.0008", // 标记价格偏离百分比(指数价格-标记价格)/标记价格
}
]
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| interval | ENUM | YES | 时间间隔 |
| from | LONG | YES | 开始时间 |
| to | LONG | YES | 结束时间 |
| limit | INT | NO | 限制条数, 默认值:2000 最大值:2000 |
最新标记价格
GET /quote/v1/markPrice
获取某个交易对的标记价格
响应:
json
{
"exchangeId": 301,//交易所ID
"symbolId": "BTC-SWAP-USDT",//币对
"price": "17042.54471",//标记价格
"time": 1670897454000//时间戳
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
最新资金费率
GET /api/v1/futures/fundingRate
响应:
json
[
{
"symbol": "BTC-SWAP-USDT", // 交易对
"nextFundingTime": "1668427200000", //下次资金费结算时间
"rate": "0.0018099173553719" //该次结算资金费率。
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | NO | 交易对 |
查询资金费率历史
GET /api/v1/futures/historyFundingRate
响应:
json
[
{
"id": "3434343434343",
"symbol": "BTC-SWAP-USDT", // 交易对
"settleTime": "1570708800000", //资金费率结算时间
"settleRate": "0.00321" //资金费率
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| fromId | LONG | NO | 起始id |
| endId | LONG | NO | 结束id |
| limit | INT | NO | 返回条数 默认20 最小1 最大1000 |
获取平台总持仓量
GET /quote/v1/openInterest
获取某交易对在平台的总持仓量
响应:
json
{
"openInterestList": [
{
"size": "88059.96", //平台总持仓量 特指交易币,如ETHUSDT中的ETH
"symbol": "ETH-SWAP-USDT" //币对名称
}
]
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
多空持仓人数比
GET /quote/v1/globalLongShortAccountRatio
多空持仓人数比
响应:
json
[
{
"symbol": "BTC-SWAP-USDT",
"timeStamp": 1768271400000,
"longShortRatio": "2.7432", // 多空人数比值
"longAccount": "0.7329", // 多仓人数比例
"shortAccount": "0.2671" // 空仓人数比例
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
| period | STRING | YES | "5m","15m","30m","1h","2h","4h","6h","12h","1d" |
| limit | LONG | NO | 默认 30, 最大 500 |
| startTime | LONG | NO | |
| endTime | LONG | NO |
注意:仅支持最近30天的数据, 若无 startime 和 endtime 限制, 则默认返回当前时间往前的limit值
保险基金余额查询
GET /api/v1/futures/insuranceBySymbol
保险基金余额查询
响应:
json
{
"list": [
{
"coin": "USDT", //保险池的币种
"symbol": "BTC-SWAP-USDT", //合约交易对
"value": "4271010.26212436", //保险基金的币种价值,折合成USD的价值
"updateTime": "1768262400000" //最近更新时间(ms)
},
{
"coin": "USDT",
"symbol": "BTC-SWAP-USDT",
"value": "4271013.74008353",
"updateTime": "1768176000000"
}
]
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbolId | STRING | YES | 交易对 |
注意:默认返回14天的数据,每天UTC0点时间更新一次
获取系统所有风险限额配置列表
GET /api/v1/futures/riskLimits
获取指定交易对的所有风险限额配置列表(仅返回非白名单的风险限额)。
权重:1
响应:
json
[
{
"level": 1, // 风险档位等级,按quantity排序,起始等级为1
"quantity": "1000000.0", // 数量
"maintainMargin": "0.005", // 维持保证金率
"initialMargin": "0.01", // 初始保证金率
"maxLeverage": 100 // 最大杠杆
},
{
"level": 2,
"quantity": "2000000.0",
"maintainMargin": "0.01",
"initialMargin": "0.02",
"maxLeverage": 50
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | 交易对 |
24hr价格变动情况
GET /quote/v1/contract/ticker/24hr
24小时价格变化数据。注意 如果没有发送symbol,会返回很多数据。
权重: 如果只有一个symbol为1,不带symbol为40。
响应:
json
[
{
"t": 1538725500422, // 时间
"a": "1.10000000", // 最高卖价
"b": "1.00000000", // 最高买价
"s": "BTC-SWAP-USDT", // symbol
"c": "4.00000200", // 最新成交价
"o": "99.00000000", // 开盘价
"h": "100.00000000", // 最高价
"l": "0.10000000", // 最低价
"v": "8913.30000000", // 成交量
"qv": "15.30000000", // 成交额
"pc": "15.30000000", // 24小时价格变动
"pcp": "15.30000000" // 24小时价格变动百分比
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | NO | 交易对 |
| realtimeInterval | ENUM | NO | value值如下:24h、1d、1d+8 |
- 如果symbol没有被发送,所有symbol的数据都会被返回。
最新价格
GET /quote/v1/contract/ticker/price
返回最近价格
权重:1
响应:
json
[
{
"s": "BTC-SWAP-USDT", // 交易对
"p": "4.00000200" // 最新价
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | NO | 交易对 |
- 如果symbol没有发送,所有symbol的最新价都会被返回。
指数价格
GET /quote/v1/index
返回指数价格
权重:1
响应:
json
{
"index":{
"BTCUSDT":"42999.21" // 币对及对应的指数价格
},
"edp":{
"BTCUSDT":"43031.36006" // 10分钟内指数平均值
}
}参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | NO | 交易对 |
- 如果symbol没有发送,所有symbol的指数价都会被返回。
当前最优挂单
GET /quote/v1/contract/ticker/bookTicker
单个或者多个symbol的最佳买单卖单价格。
权重:1
响应:
json
[
{
"t": 132222222222222, // 时间
"s": "BTC-SWAP-USDT", // 交易对
"b": "4.00000000", // 最高买价
"bq": "431.00000000", // 最高买价对应的数量
"a": "4.00000200", // 最高卖价
"aq": "9.00000000" // 最高卖价对应的数量
}
]参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | NO | 交易对 |
- 如果symbol没有被发送,所有symbol的最佳订单簿价格都会被返回。