订阅所有交易品种的24小时交易摘要
API说明
此Websocket API提供实时现货市场交易品种,流式传输实时买卖盘数据。
注意:交易品种24小时交易摘要数据可通过RESTful和Websocket接口获取。本页是Websocket接口的描述。如需了解RESTful接口,请参见 跳转
注意事项
- 此websocket返回交易所上所有交易品种的实时数据。
- 只有方法2可用于实现此功能。
认证
这是一个公共Websocket,不需要认证。有关使用Websocket API的详细信息,请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2
Websocket URL
频率限制
无
订阅参数
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| event | true | String | 订阅或取消订阅:sub: 订阅,unsub: 取消订阅。 注意:此参数区分大小写。 |
| params | true | Json | 请求的参数对象,包括: |
| -biz | true | String | 指定频道,例如,"exchange"。 注意:建议使用小写。 |
| -type | true | String | 定义功能类型,例如,"ticker_all"。 注意:建议使用小写。 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| biz | String | 频道名称,例如,"exchange"。 |
| channel | String | 订阅类型,例如,"subscribe"。 |
| type | String | 定义功能类型,例如,"ticker_all"。 |
| -result | Boolean | 订阅请求的结果:true/false。 |
| data | Json | 数据对象,包含以下字段: |
| -activityState | Integer | 活动状态(未提供具体含义)。 |
| -currencyVol | BigDecimal | 交易的货币总量。 |
| -fPartitionIds | String | 与市场或平台分区相关的ID。 |
| -fav | Boolean | 币对是否标记为收藏。 |
| -hotCoinSort | Integer | 根据受欢迎程度或交易量排名的币种排名。 |
| -leftCoinName | String | 交易品种的基础货币名称,即BTC。 |
| -leftCoinUrl | String | 左侧币种图像的URL。 |
| -newCoinSort | Integer | 新上市币种的排序排名(用户可以忽略)。 |
| -oneDayHighest | BigDecimal | 过去24小时币种的最高价格。(以报价货币计) |
| -oneDayLowest | BigDecimal | 过去24小时币种的最 低价格。(以报价货币计) |
| -oneDayTotal | BigDecimal | 过去24小时交易的币种总量。(以基础货币计) |
| -price | BigDecimal | 以报价货币计的最新价格。 |
| -rightCoinName | String | 交易品种的报价货币名称,即USDT |
| -rose | BigDecimal | 以报价货币计的价格百分比变化。 |
| -selective | Boolean | 指示数据是否针对特定条件进行选择性筛选。(用户可以忽略) |
| -symbol | String | 用于定价的货币符号(例如,"$")。 |
| -tmId | Integer | 货币对ID,即78 : BTC_USDT。 注意:货币对ID与交易品种的映射关系可通过 获取所有交易品种24小时交易摘要 接口获取。 。 |
| -transferPrice | BigDecimal | 转账价格(用户可以忽略) |
| -transferSymbol | String | 转换货币的符号(用户可以忽略) |
订阅示例
以下Python代码展示了如何订阅所有交易品种的24小时交易摘要。
注意:完整代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2。
url = "wss://ws.futurescw.com"
subscription_params = {"event":"sub",
"params":
{"biz":"exchange",
"type":"ticker_all"}}
SpotWebsocketPublic(url, subscription_params) # 函数SpotWebsocketPublic()在章节(简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2)中定义
注意:完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2。
响应示例
以下是上述Python订阅返回的示例响应。Websocket订阅将实时更新。为简洁起见,以下仅提供初始响应:
{"biz":"exchange","data":{"result":true},"channel":"subscribe","type":"ticker_all"}
{"biz":"exchange","data":"[{\"activityState\":0,\"currencyVol\":604768021.9400,\"fPartitionIds\":\"1,2006\",\"fav\":false,\"hotCoinSort\":46,\"leftCoinName\":\"BTC\",\"leftCoinUrl\":\"https://hkto-prod.oss-accelerate.aliyuncs.com/201810020046047_T9g8i.png\",\"newCoinSort\":0,\"oneDayHighest\":\"94827.32\",\"oneDayLowest\":\"92788.41\",\"oneDayTotal\":\"6434.1919000000\",\"price\":\"94728.91\",\"rightCoinName\":\"USDT\",\"rose\":\"0.0063\",\"selective\":false,\"symbol\":\"$\",\"tmId\":78,\"transferPrice\":\"664049.6591\",\"transferSymbol\":\"¥\"},.........]","type":"ticker_all"},........