行情接口
深度信息
GET /api/v3/depth
权重:
| 限制 | 权重 |
|---|---|
| 1-100 | 5 |
| 101-500 | 25 |
| 501-1000 | 50 |
| 1001-5000 | 250 |
参数:
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | |
| limit | INT | NO | 默认: 100; 最大: 5000。 如果 limit > 5000, 最多返回5000条数据。 |
| symbolStatus | ENUM | NO | 过滤具有此 tradingStatus 的交易对。如果状态不匹配,将返回错误 -1220 交易对与状态不匹配有效值: TRADING, HALT, BREAK |
数据源: 缓存
响应:
{
"lastUpdateId": 1027024,
"bids": [
[
"4.00000000", // 价位
"431.00000000" // 挂单量
]
],
"asks": [["4.00000200", "12.00000000"]]
}
近期成交
GET /api/v3/trades
获取近期成交
权重: 25
参数:
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | |
| limit | INT | NO | 默认值: 500; 最大值: 1000。 |
数据源: 缓存
响应:
[
{
"id": 28457,
"price": "4.00000100",
"qty": "12.00000000",
"quoteQty": "48.000012",
"time": 1499865549590,
"isBuyerMaker": true,
"isBestMatch": true
}
]
查询历史成交
GET /api/v3/historicalTrades
权重: 25
参数:
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | |
| limit | INT | NO | 默认值: 500; 最大值: 1000。 |
| fromId | LONG | NO | 从哪一条成交id开始返回,缺省返回最近的成交记录 |
数据源: 数据库
响应:
[
{
"id": 28457,
"price": "4.00000100",
"qty": "12.00000000",
"quoteQty": "48.000012",
"time": 1499865549590,
"isBuyerMaker": true,
"isBestMatch": true
}
]
查询历史大宗交易
GET /api/v3/historicalBlockTrades
权重: 25
参数:
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
symbol | STRING | YES | |
fromId | LONG | YES | 起始大宗交易ID |
limit | LONG | NO | 默认值:500; 最大值:1000 |
数据源: 数据库
响应:
[
{
"id": 582,
"price": "0.052",
"qty": "5838",
"quoteQty": "303.576",
"time": 1772506983321,
"isBuyerMaker": true
}
]
近期成交(归集)
GET /api/v3/aggTrades
与trades的区别是,同一个taker在同一时间同一价格与多个maker的成交会被合并为一条记录
权重: 4
参数:
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | |
| fromId | LONG | NO | 从包含fromID的成交开始返回结果 |
| startTime | LONG | NO | 从该时刻之后的成交记录开始返回结果 |
| endTime | LONG | NO | 返回该时刻为止的成交记录 |
| limit | INT | NO | 默认值: 500; 最大值: 1000。 |
- 如果没有发送任何筛选参数(fromId, startTime, endTime),默认返回最近的成交记录
数据源: 数据库
响应:
[
{
"a": 26129, // 归集成交ID
"p": "0.01633102", // 成交价
"q": "4.70443515", // 成交量
"f": 27781, // 被归集的首个成交ID
"l": 27781, // 被归集的末个成交ID
"T": 1498793709153, // 成交时间
"m": true, // 是否为主动卖出单
"M": true // 是否为最优撮合单(可忽略,目前总为最优撮合)
}
]
K线数据
GET /api/v3/klines
每根K线的开盘时间可视为唯一ID
权重: 2
参数:
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | |
| interval | ENUM | YES | 请参考 K线间隔 |
| startTime | LONG | NO | |
| endTime | LONG | NO | |
| timeZone | STRING | NO | 默认值: 0 (UTC) |
| limit | INT | NO | 默认值: 500; 最大值: 1000。 |
支持的K线间隔 (区分大小写):
| 间隔 | 间隔 值 |
|---|---|
| seconds -> 秒 | 1s |
| minutes -> 分钟 | 1m, 3m, 5m, 15m, 30m |
| hours -> 小时 | 1h, 2h, 4h, 6h, 8h, 12h |
| days -> 天 | 1d, 3d |
| weeks -> 周 | 1w |
| months -> 月 | 1M |
请注意:
- 如果未发送
startTime和endTime,将返回最近的K线数据。 timeZone支持的值包括:- 小时和分钟(例如
-1:00,05:45) - 仅小时(例如
0,8,4) - 接受的值范围严格为 [-12:00 到 +14:00](包括边界)
- 小时和分钟(例如
- 如果提供了
timeZone,K线间隔将在该时区中解释,而不是在UTC中。 - 请注意,无论
timeZone如何,startTime和endTime始终以UTC时区解释。
数据源: 数据库
响应:
[
[
1499040000000, // 开盘时间
"0.01634790", // 开盘价
"0.80000000", // 最高价
"0.01575800", // 最低价
"0.01577100", // 收盘价(当前K线未结束的即为最新价)
"148976.11427815", // 成交量
1499644799999, // 收盘时间
"2434.19055334", // 成交额
308, // 成交笔数
"1756.87402397", // 主动买入成交量
"28.46694368", // 主动买入成交额
"17928899.62484339" // 请忽略该参数
]
]
UIK线数据
GET /api/v3/uiKlines
请求参数与响应和k线接口相同。
uiKlines 返回修改后的k线数据,针对k线图的呈现进行了优化。
权重: 2
参数:
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | |
| interval | ENUM | YES | 请参考 K线间隔 |
| startTime | LONG | NO | |
| endTime | LONG | NO | |
| timeZone | STRING | NO | 默认值: 0 (UTC) |
| limit | INT | NO | 默认值: 500; 最大值: 1000。 |
- 如果未发送
startTime和endTime,默认返回最近的交易。 timeZone支持的值包括:- 小时和分钟(例如
-1:00,05:45) - 仅小时(例如
0,8,4) - 接受的值范围严格为 [-12:00 到 +14:00](包括边界)
- 小时和分钟(例如
- 如果提供了
timeZone,K线间隔将在该时区中解释,而不是在UTC中。 - 请注意,无论
timeZone如何,startTime和endTime始终以UTC时区解释。
数据源: 数据库
响应:
[
[
1499040000000, // k线开盘时间
"0.01634790", // 开盘价
"0.80000000", // 最高价
"0.01575800", // 最低价
"0.01577100", // 收盘价(当前K线未结束的即为最新价)
"148976.11427815", // 成交量
1499644799999, // k线收盘时间
"2434.19055334", // 成交额
308, // 成交笔数
"1756.87402397", // 主动买入成交量
"28.46694368", // 主动买入成交额
"0" // 请忽略该参数
]
]
当前平均价格
GET /api/v3/avgPrice
权重: 2
参数:
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| symbol | STRING | YES |
数据源: 缓存
响应:
{
"mins": 5,
"price": "9.35751834",
"closeTime": 1694061154503
}
24hr价格变动情况
GET /api/v3/ticker/24hr
请注意,不携带symbol参数会返回全部交易对数据,不仅数据庞大,而且权重极高
权重:
| 参数 | 提供Symbol数量 | 权重 |
|---|---|---|
| symbol | 1 | 2 |
| 不提供symbol | 80 | |
| symbols | 1-20 | 2 |
| 21-100 | 40 | |
| >= 101 | 80 | |
| 不提供symbol | 80 |
参数:
| 名称 | 类型 | 是否强制要求 |
|---|