近期成交(归集
与trades的区别是，同一个taker在同一时间同一价格与多个maker的成交会被合并为一条记录
查询参数
symbolfromId从包含fromID的成交开始返回结果
startTime从该时刻之后的成交记录开始返回结果
endTime返回该时刻为止的成交记录
limit近期成交(归集 › 响应
近期成交(归集
a归集成交ID
p成交价
q成交量
f被归集的首个成交ID
l被归集的末个成交ID
T成交时间
m是否为主动卖出单
M是否为最优撮合单(可忽略，目前总为最优撮合)
深度信息
深度信息
深度信息 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
Adjusted based on the limit:
| Limit | Request Weight |
|---|---|
| 1-100 | 5 |
| 101-500 | 25 |
| 501-1000 | 50 |
| 1001-5000 | 250 |
查询参数
symbollimit如果 limit > 5000, 最多返回5000条数据。
symbolStatus过滤具有此 tradingStatus 的交易对。
如果状态不匹配，将返回错误 -1220 交易对与状态不匹配
深度信息 › 响应
深度信息
lastUpdateId买单列表。每项为 [价格, 数量]。
[0]Price
[1]Quantity
卖单列表。每项为 [价格, 数量]。
[0]Price
[1]Quantity
查询历史成交
查询历史成交
查询参数
symbollimitfromId从哪一条成交id开始返回，缺省返回最近的成交记录
查询历史成交 › 响应
查询历史成交
idpriceqtyquoteQtytimeisBuyerMakerisBestMatch历史大宗交易 (MARKET_DATA)
获取大宗交易记录。
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
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 for each requested symbol regardless of windowSize.
The weight for this request will cap at 200 once the number of symbols in the request is more than 50.
查询参数
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 |
symbolpriceChange价格变化
priceChangePercent价格变化百分比
weightedAvgPriceQuoteVolume / 成交量
openPricehighPricelowPricelastPricevolumequoteVolume此k线内所有交易的price(价格) x volume(交易量)的总和
openTimeticker的开始时间
closeTimeticker的结束时间
firstId统计时间内的第一笔trade id
lastIdcount统计时间内交易笔数
24hr价格变动情况
请注意，不携带symbol参数会返回全部交易对数据，不仅数据庞大，而且权重极高
24hr价格变动情况 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
| Parameter | Symbols Provided | Weight |
|---|---|---|
| symbol | 1 | 2 |
| symbol parameter is omitted | 80 | |
| symbols | 1-20 | 2 |
| 21-100 | 40 | |
| 101 or more | 80 | |
| symbols parameter is omitted | 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 |
symbol交易对
priceChangepriceChangePercentweightedAvgPriceprevClosePricelastPrice间隔收盘价
lastQtybidPricebidQtyaskPriceaskQtyopenPrice间隔开盘价
highPrice间隔最高价
lowPrice间隔最低价
volume总交易量 (base asset)
quoteVolume总交易量 (quote asset)
openTimeticker间隔的开始时间
closeTimeticker间隔的结束时间
firstId首笔成交id
lastId末笔成交id
count成交笔数
最优挂单接口
返回当前最优的挂单(最高买单，最低卖单)
最优挂单接口 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
| Parameter | Symbols Provided | Weight |
|---|---|---|
| symbol | 1 | 2 |
| omitted | 4 | |
| symbols | Any | 4 |
查询参数
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.
最新价格接口
返回最近价格
最新价格接口 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
| Parameter | Symbols Provided | Weight |
|---|---|---|
| symbol | 1 | 2 |
| omitted | 4 | |
| symbols | Any | 4 |
查询参数
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 for each requested symbol. The weight for this request will cap at 200 once the number of symbols in the request is more than 50.
查询参数
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 |
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
查询参考价格计算方式 › 响应
参考价格计算方式
symbolcalculationTypeARITHMETIC_MEAN 或 EXTERNAL。
bucketCount当 calculationType 为 ARITHMETIC_MEAN 时存在。
bucketWidthMs当 calculationType 为 ARITHMETIC_MEAN 时存在。
externalCalculationId当 calculationType 为 EXTERNAL 时存在。