跳到主要内容

订阅所有交易品种的24小时交易摘要

API说明

此Websocket API提供实时现货市场交易品种,流式传输实时买卖盘数据。

注意:交易品种24小时交易摘要数据可通过RESTful和Websocket接口获取。本页是Websocket接口的描述。如需了解RESTful接口,请参见 跳转

注意事项

  1. 此websocket返回交易所上所有交易品种的实时数据。
  2. 只有方法2可用于实现此功能。

认证

这是一个公共Websocket,不需要认证。有关使用Websocket API的详细信息,请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2

Websocket URL

wss://ws.futurescw.com

频率限制

订阅参数

参数必填类型描述
eventtrueString订阅或取消订阅:sub: 订阅,unsub: 取消订阅。
注意:此参数区分大小写。
paramstrueJson请求的参数对象,包括:
-biztrueString指定频道,例如,"exchange"。
注意:建议使用小写。
-typetrueString定义功能类型,例如,"ticker_all"。
注意:建议使用小写。

响应参数

参数类型描述
bizString频道名称,例如,"exchange"。
channelString订阅类型,例如,"subscribe"。
typeString定义功能类型,例如,"ticker_all"。
-resultBoolean订阅请求的结果:true/false。
dataJson数据对象,包含以下字段:
-activityStateInteger活动状态(未提供具体含义)。
-currencyVolBigDecimal交易的货币总量。
-fPartitionIdsString与市场或平台分区相关的ID。
-favBoolean币对是否标记为收藏。
-hotCoinSortInteger根据受欢迎程度或交易量排名的币种排名。
-leftCoinNameString交易品种的基础货币名称,即BTC。
-leftCoinUrlString左侧币种图像的URL。
-newCoinSortInteger新上市币种的排序排名(用户可以忽略)。
-oneDayHighestBigDecimal过去24小时币种的最高价格。(以报价货币计)
-oneDayLowestBigDecimal过去24小时币种的最低价格。(以报价货币计)
-oneDayTotalBigDecimal过去24小时交易的币种总量。(以基础货币计)
-priceBigDecimal以报价货币计的最新价格。
-rightCoinNameString交易品种的报价货币名称,即USDT
-roseBigDecimal以报价货币计的价格百分比变化。
-selectiveBoolean指示数据是否针对特定条件进行选择性筛选。(用户可以忽略)
-symbolString用于定价的货币符号(例如,"$")。
-tmIdInteger货币对ID,即78 : BTC_USDT。
注意:货币对ID与交易品种的映射关系可通过 获取所有交易品种24小时交易摘要 接口获取。 。
-transferPriceBigDecimal转账价格(用户可以忽略)
-transferSymbolString转换货币的符号(用户可以忽略)

订阅示例

以下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"},........