近期成交(归集)
与trades的区别是，同一个taker在同一时间同一价格与多个maker的成交会被合并为一条记录
查询参数
symbolfromId从包含fromID的成交开始返回结果
startTime从该时刻之后的成交记录开始返回结果
endTime返回该时刻为止的成交记录
limit近期成交(归集) › 响应
近期成交(归集
a归集成交ID
p成交价
q成交量
f被归集的首个成交ID
l被归集的末个成交ID
T成交时间
m是否为主动卖出单
M是否为最优撮合单(可忽略，目前总为最优撮合)
深度信息
深度信息
深度信息 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
根据 limit 调整：
| 限制 | 请求权重 |
|---|---|
| 1-100 | 5 |
| 101-500 | 25 |
| 501-1000 | 50 |
| 1001-5000 | 250 |
查询参数
symbollimit如果 limit > 5000, 最多返回5000条数据。
symbolStatus过滤具有此 tradingStatus 的交易对。
如果状态不匹配，将返回错误 -1220 交易对与状态不匹配
深度信息 › 响应
深度信息
lastUpdateId买单列表。每项为 [价格, 数量]。
[0]价位
[1]挂单量
卖单列表。每项为 [价格, 数量]。
[0]价位
[1]挂单量
查询历史成交
查询历史成交
查询参数
symbollimitfromId从哪一条成交id开始返回，缺省返回最近的成交记录
查询历史成交 › 响应
查询历史成交
idpriceqtyquoteQtytimeisBuyerMakerisBestMatch查询历史大宗交易 (MARKET_DATA)
获取大宗交易记录。
查询参数
symbolfromId从该大宗交易ID开始查询
limit默认: 500; 最大: 1000
查询历史大宗交易 (MARKET_DATA) › 响应
历史大宗交易
idpriceqtyquoteQtytimeisBuyerMakerK线数据
每根K线的开盘时间可视为唯一ID
查询参数
symbolintervalstartTimeendTimetimeZone默认值： 0 (UTC)
limitK线数据 › 响应
K线数据
[0]开盘时间
[1]开盘价
[2]最高价
[3]最低价
[4]收盘价
[5]成交量
[6]收盘时间
[7]成交额
[8]成交笔数
[9]主动买入成交量
[10]主动买入成交额
[11]忽略字段
滚动窗口价格变动统计
注意: 此接口和 GET /api/v3/ticker/24hr 有所不同.
此接口统计的时间范围比请求的windowSize多不超过59999ms.
接口的 openTime 是某一分钟的起始，而结束是当前的时间. 所以实际的统计区间会比请求的时间窗口多不超过59999ms.
比如, 结束时间 closeTime 是 1641287867099 (January 04, 2022 09:17:47:099 UTC)
, windowSize 为 1d. 那么开始时间 openTime 则为 1641201420000 (January 3,
2022, 09:17:00 UTC)
滚动窗口价格变动统计 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
每个交易对占用 4 个权重，与 windowSize 无关。
当请求中的 symbols 数量超过 50 时，此请求的权重上限为 200。
查询参数
symbol参数 symbol 和 symbols 不可以一起使用
symbols参数 symbol 和 symbols 不可以一起使用
如果都不提供, 所有symbol的ticker数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"]
%5B%22BTCUSDT%22,%22BNBUSDT%22%5D
windowSize不可以组合使用, 比如1d2h
typesymbolStatus过滤具有此 tradingStatus 的交易对。
对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。
对于多个或者全部交易对， 响应中不会包括状态不匹配的交易对。
滚动窗口价格变动统计 › 响应
Rolling 窗口 价格 修改 statistics
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = array | |
| type = object | |
| type = array |
symbolpriceChange价格变化
priceChangePercent价格变化百分比
weightedAvgPriceQuoteVolume / 成交量
openPricehighPricelowPricelastPricevolumequoteVolume此k线内所有交易的price(价格) x volume(交易量)的总和
openTimeticker的开始时间
closeTimeticker的结束时间
firstId统计时间内的第一笔trade id
lastIdcount统计时间内交易笔数
24hr价格变动情况
请注意，不携带symbol参数会返回全部交易对数据，不仅数据庞大，而且权重极高
24hr价格变动情况 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
| 参数 | 提供Symbol数量 | 权重 |
|---|---|---|
| symbol | 1 | 2 |
| 不提供 symbol 参数 | 80 | |
| symbols | 1-20 | 2 |
| 21-100 | 40 | |
| 101 或更多 | 80 | |
| 不提供 symbols 参数 | 80 |
查询参数
symbol参数 symbol 和 symbols 不可以一起使用
symbols参数 symbol 和 symbols 不可以一起使用
如果都不提供, 所有symbol的ticker数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"]
%5B%22BTCUSDT%22,%22BNBUSDT%22%5D
typesymbolStatus过滤具有此 tradingStatus 的交易对。
对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。
对于多个或者全部交易对， 响应中不会包括状态不匹配的交易对。
24hr价格变动情况 › 响应
24hr ticker 价格 修改 statistics
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = array | |
| type = object | |
| type = array |
symbol交易对
priceChangepriceChangePercentweightedAvgPriceprevClosePricelastPrice间隔收盘价
lastQtybidPricebidQtyaskPriceaskQtyopenPrice间隔开盘价
highPrice间隔最高价
lowPrice间隔最低价
volume总交易量 (base asset)
quoteVolume总交易量 (quote asset)
openTimeticker间隔的开始时间
closeTimeticker间隔的结束时间
firstId首笔成交id
lastId末笔成交id
count成交笔数
最优挂单接口
返回当前最优的挂单(最高买单，最低卖单)
查询参数
symbol参数 symbol 和 symbols 不可以一起使用
如果都不提供, 所有symbol的bookTicker数据都会返回.
symbols参数 symbol 和 symbols 不可以一起使用
如果都不提供, 所有symbol的bookTicker数据都会返回.
symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] 或 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbolStatus过滤具有此 tradingStatus 的交易对。
对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。
对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。
最优挂单接口 › 响应
最优挂单接口
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = array |
symbolbidPricebest bid price.
bidQtybid/ask qty.
askPricebest ask price.
askQtybid/ask qty.
最新价格接口
返回最近价格
查询参数
symbol参数 symbol 和 symbols 不可以一起使用
如果都不提供, 所有symbol的价格数据都会返回.
symbols参数 symbol 和 symbols 不可以一起使用
如果都不提供, 所有symbol的价格数据都会返回.
symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] 或 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbolStatus过滤具有此 tradingStatus 的交易对。
对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。
对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。
最新价格接口 › 响应
最新价格接口
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = array |
symbolprice交易日行情(Ticker)
交易日价格变动统计。
交易日行情(Ticker) › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
每个交易对占用 4 个权重。当请求中的交易对数量超过 50 时，此请求的权重上限为 200。
查询参数
symbolsymbol 或者 symbols 必须提供之
symbolssymbol 或者 symbols 必须提供之一
symbols 可以接受的格式: ["BTCUSDT","BNBUSDT"] 或者 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D.
symbols 最多可以发送100个.
timeZone默认值： 0 (UTC)
typesymbolStatus过滤具有此 tradingStatus 的交易对。
对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。
对于多个交易对，响应中不会包括状态不匹配的交易对。
交易日行情(Ticker) › 响应
Trading Day 行情
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = array | |
| type = object | |
| type = array |
symbolpriceChange绝对价格变动
priceChangePercent相对价格变动百分比
weightedAvgPrice报价成交量 / 成交量
openPricehighPricelowPricelastPricevolume基础资产的成交量
quoteVolume报价资产的成交量
openTimecloseTimefirstId区间内的第一个交易的交易ID
lastId区间内的最后一个交易的交易ID
count区间内的交易数量
UIK线数据
请求参数与响应和k线接口相同。
uiKlines 返回修改后的k线数据，针对k线图的呈现进行了优化。
查询参数
symbolintervalstartTimeendTimetimeZone默认值： 0 (UTC)
limitUIK线数据 › 响应
UIK线数据
[0]开盘时间
[1]开盘价
[2]最高价
[3]最低价
[4]收盘价
[5]成交量
[6]收盘时间
[7]成交额
[8]成交笔数
[9]主动买入成交量
[10]主动买入成交额
[11]忽略字段
查询参考价格
查询某个交易对的参考价格。
查询参考价格计算方式
描述某个交易对的参考价格是如何计算的。
查询参数
symbolsymbolStatus支持的值: TRADING, HALT, BREAK, CANCEL_ONLY
查询参考价格计算方式 › 响应
参考价格计算方式
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = object |
symbolcalculationTypeARITHMETIC_MEAN 或 EXTERNAL。
bucketCount当 calculationType 为 ARITHMETIC_MEAN 时存在。
bucketWidthMs当 calculationType 为 ARITHMETIC_MEAN 时存在。