跳到主要内容

WebSocket 行情接口

基本信息

  • 本篇所列出的所有wss接口的baseurl为: wss://nbstream.binance.com/w3w/wsa/stream

实时订阅/取消数据流

  • 以下数据可以通过 WebSocket 发送以实现订阅或取消订阅数据流。示例如下.
  • 请求中的id被用作唯一标识来区分来回传递的消息。以下格式被接受:
    • 64位有符号整数
    • 字母数字字符串;最大长度36
    • null
  • 如果相应内容中的result 为 null,表示请求发送成功。

订阅一个信息流

请求

{
"method": "SUBSCRIBE",
"params": [
"came@allTokens@ticker24"
],
"id": 1
}

响应

{
"result": null,
"id": 1
}

取消订阅一个信息流

请求

{
"method": "UNSUBSCRIBE",
"params": [
"came@allTokens@ticker24"
],
"id": 1
}

响应

{
"result": null,
"id": 1
}

已订阅信息流

请求

{
"method": "LIST_SUBSCRIPTION",
"id": 3
}

响应

{
"result": ["came@allTokens@ticker24"],
"id": 3
}

Streams

came@allTokens@ticker24

{
"data": {
"d": [
{
"ca": "0x8fce7206e3043dd360f115afa956ee31b90b787c@56", // 合约地址@链ID
"cnt24": 10426, // 24小时成交笔数
"fdv": "72834145.18711072", // 完全稀释市值 (FDV)
"hc": "6822", // 持有者数量
"liq": "1442996.98151177662835", // 流动性
"mc": "13542034.24008014", // 市值
"p": "0.072849536538593663", // 当前价格
"pc24": "-2.32", // 24小时价格变化%
"s": "1",
"t": 1771825733000, // 时间戳 (ms)
"vol24": "12930712.213702157742688594285" // 24小时交易量
}
],
"e": "tickerList"
},
"stream": "came@allTokens@ticker24"
}

<symbol>@aggTrade

{
"data": {
"E": 1771828569861, // 事件时间 (ms)
"T": 1771828569702, // 成交时间 (ms)
"a": 2684294, // 聚合交易ID
"e": "aggTrade", // 事件类型
"f": 2684294, // 被归集的首个交易ID
"l": 2684294, // 末个交易ID
"m": false, // 是否为做市方
"p": "0.08530000", // 成交价格
"q": "879.24000000", // 成交数量
"s": "ALPHA_474USDT" // 交易对符号
},
"stream": "alpha_474usdt@aggTrade"
}

<symbol>@fulldepth@<interval>

interval: 0ms, 100ms, 500ms
这条数据流会返回所有可用的深度信息,其中包括 UI 和 API 的订单

{
"data": {
"E": 1771828614381, // 事件时间 (ms)
"T": 1771828614258, // 撮合时间 (ms)
"U": 42648947917, // 本次更新首个updateId
"a": [
[
"0.07680652",
"0.00000000"
],
[
"0.08529794",
"0.00000000"
]
],
"b": [
[
"0.08513788",
"0.00000000"
],
[
"0.08520502",
"23.47000000"
],
[
"0.08521196",
"320.94000000"
],
[
"0.08529880",
"0.00000000"
],
[
"0.08529885",
"0.00000000"
]
],
"e": "depthUpdate",
"pu": 42648947321, // 上次推送的updateId
"s": "ALPHA_474USDT",
"u": 42648948229 // 本次更新末个updateId
},
"stream": "alpha_474usdt@fulldepth@500ms"
}

came@contractAddress@chainId@kline_<interval>

interval: 1s, 1m, 5m, 15m, 1h, 4h, 1d

{
"data": {
"ca": "G7vQWurMkMMm2dU3iZpXYFTHT9Biio4F4gZCrwFpKNwG@CT_501", // 合约地址@链ID
"e": "kline",
"k": {
"c": "0.15584957424118055058", // 收盘价
"ct": 1771828656000, // k线结束时间
"h": "0.15584957424118055058", // 最高价
"i": "1s", // interval
"l": "0.15584372258086979622", // 最低价
"o": "0.15584372258086979622", // 开盘价
"ot": 1771828655000, // k线开始时间
"v": "2.8584092999332775480" // 成交量
}
},
"stream": "came@G7vQWurMkMMm2dU3iZpXYFTHT9Biio4F4gZCrwFpKNwG@CT_501@kline_1s"
}

<symbol>@bookTicker

{
"data": {
"A": "2.00353200", // 卖一数量
"B": "0.91076900", // 买一数量
"E": 1773108379067, // 事件时间
"T": 1773108379054, // 成交时间/交易时间
"a": "9.30000000", // 卖一价格
"b": "8.30000000", // 买一价格
"e": "bookTicker", // 事件类型
"s": "ALPHA_116USDT", // 交易对
"u": 6663207693 // 更新 ID
},
"stream": "alpha_116usdt@bookTicker"
}

!bookTicker

{
"data": {
"A": "2.00353200", // 卖一数量
"B": "0.91076900", // 买一数量
"E": 1773108379067, // 事件时间
"T": 1773108379054, // 成交时间/交易时间
"a": "9.30000000", // 卖一价格
"b": "8.30000000", // 买一价格
"e": "bookTicker", // 事件类型
"s": "ALPHA_116USDT", // 交易对
"u": 6663207693 // 更新 ID
},
"stream": "!bookTicker"
}

<symbol>@miniTicker

{
"data": {
"E": 1773109449908, // 事件时间
"c": "8.40000000", // 收盘价
"e": "24hrMiniTicker", // 事件类型
"h": "8.50000000", // 最高价
"l": "8.30000000", // 最低价
"o": "8.40000000", // 开盘价
"q": "543810.36005090", // 计价资产成交额
"s": "ALPHA_116USDT", // 交易对
"v": "64739.03978900" // 基础资产成交量
},
"stream": "alpha_116usdt@miniTicker"
}

!miniTicker@arr

{
"data": {
"E": 1773109449908, // 事件时间
"c": "8.40000000", // 收盘价
"e": "24hrMiniTicker", // 事件类型
"h": "8.50000000", // 最高价
"l": "8.30000000", // 最低价
"o": "8.40000000", // 开盘价
"q": "543810.36005090", // 计价资产成交额
"s": "ALPHA_116USDT", // 交易对
"v": "64739.03978900" // 基础资产成交量
},
"stream": "!miniTicker@arr"
}

<symbol>@ticker

{
"data": {
"C": 1773109631555, // 统计结束时间
"E": 1773109631569, // 事件时间
"F": 19847634, // 首笔成交 ID
"L": 19911287, // 末笔成交 ID
"O": 1773023220000, // 统计开始时间
"P": "0.00", // 涨跌幅
"Q": "0.49293200", // 最近一笔成交量
"c": "8.40000000", // 收盘价
"e": "24hrTicker", // 事件类型
"h": "8.50000000", // 最高价
"l": "8.30000000", // 最低价
"n": 217505, // 成交笔数
"o": "8.40000000", // 开盘价
"p": "0.00000000", // 涨跌额
"q": "543907.35169250", // 计价资产成交额
"s": "ALPHA_116USDT", // 交易对
"v": "64750.63418500", // 基础资产成交量
"w": "8.40003127" // 平均价
},
"stream": "alpha_116usdt@ticker"
}

!ticker@arr

{
"data": {
"C": 1773109631555, // 统计结束时间
"E": 1773109631569, // 事件时间
"F": 19847634, // 首笔成交 ID
"L": 19911287, // 末笔成交 ID
"O": 1773023220000, // 统计开始时间
"P": "0.00", // 涨跌幅
"Q": "0.49293200", // 最近一笔成交量
"c": "8.40000000", // 收盘价
"e": "24hrTicker", // 事件类型
"h": "8.50000000", // 最高价
"l": "8.30000000", // 最低价
"n": 217505, // 成交笔数
"o": "8.40000000", // 开盘价
"p": "0.00000000", // 涨跌额
"q": "543907.35169250", // 计价资产成交额
"s": "ALPHA_116USDT", // 交易对
"v": "64750.63418500", // 基础资产成交量
"w": "8.40003127" // 平均价
},
"stream": "!ticker@arr"
}

<symbol>@trade

{
"data": {
"E": 1773110023891, // 事件时间
"T": 1773110023877, // 成交时间
"e": "trade", // 事件类型
"m": false, // 是否为买方挂单成交
"p": "8.40000000", // 成交价
"q": "0.97915700", // 成交量
"s": "ALPHA_116USDT", // 交易对
"t": 19911650 // 成交 ID
},
"stream": "alpha_116usdt@trade"
}

<symbol>@depth<levels>@<interval>

levels:可选,取值:[5, 10, 20]
interval:可选,取值:[0ms, 100ms, 500ms]
请注意:这里只会展示 UI 订单。

{
"data": {
"E": 1773110222878, // 事件时间
"T": 1773110222767, // 成交时间/交易时间
"U": 6663367135, // 首个更新 ID
"a": [
[
"8.30000000", // 价格
"8.02776700" // 数量
]
],
"b": [
[
"8.40000000", // 价格
"1266.84789600" // 数量
]
],
"e": "depthUpdate", // 事件类型
"pu": 6663366971, // 上一个更新 ID
"s": "ALPHA_116USDT", // 交易对
"u": 6663367147 // 最后更新 ID
},
"stream": "alpha_116usdt@depth"
}

<symbol>@kline_<interval>

可选 interval 取值:[1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M]

{
"data": {
"E": 1773111055144, // 事件时间
"e": "kline", // 事件类型
"k": {
"B": "0", // 忽略
"L": 19912765, // 末笔成交 ID
"Q": "534.64960920", // 主动买入成交额
"T": 1773111059999, // K 线结束时间
"V": "63.64876300", // 主动买入成交量
"c": "8.40000000", // 收盘价
"f": 19912696, // 首笔成交 ID
"h": "8.40000000", // 最高价
"i": "1m", // K 线周期
"l": "8.40000000", // 最低价
"n": 218, // 成交笔数
"o": "8.40000000", // 开盘价
"q": "534.64960920", // 成交额
"s": "ALPHA_116USDT", // 交易对
"t": 1773111000000, // K 线开始时间
"v": "63.64876300", // 成交量
"x": false // K 线是否已完结
},
"s": "ALPHA_116USDT" // 交易对
},
"stream": "alpha_116usdt@kline_1m"
}