订阅24小时交易摘要
API说明
此Websocket提供交易所指定交易品种的 24 小时实时交易摘要。它包括关键市场指标，如最新交易价格、最高买入价、最低卖出价、24小时交易量等。
注意：24小时交易摘要数据只能通过 Websocket API 获取。
注意事项
- 目前有两种方法可用于24小时交易摘要订阅。用户在创建连接时应谨慎操作。
方法1
认证
这是一个公共Websocket，不需要认证。有关使用Websocket API的详细信息，请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法1
Websocket URL
wss://ws.futurescw.info?token={your_token}
频率限制
无
订阅参数
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| event | true | String | subscribe |
| args | true | String | 格式："spot/market-api-ticker:symbol"，其中symbol是要订阅的货币。 示例： "spot/market-api-ticker:BTC-USDT" |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| channel | String | 订阅的频道，即'spot/market-api-ticker:BTC-USDT' |
| subject | string | 主题：'spot/market-api-ticker' |
| buy | string | 买入价 |
| changePrice | string | 价格变化 |
| changeRate | String | 价格变化百分比 |
| high | String | 过去24小时最高价 |
| last | String | 最新价格 |
| low | String | 过去24小时最低价 |
| open | String | 开盘价 |
| sell | String | 卖出价 |
| symbol | String | 货币对ID，即78 : BTC_USDT。 注意：货币对ID与交易品种的映射关系可通过 获取所有交易 品种24小时交易摘要 接口获取。 |
| vol | string | 基础货币的交易量 |
| volValue | String | USDT金额 |
订阅示例
以下Python代码展示了如何订阅BTC的24小时交易摘要。
注意：完整代码请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法1
symbol = "BTC-USDT"
args = f'spot/market-api-ticker:{symbol}'
SpotWebsocketPublic(args) # 函数SpotWebsocketPublic()在章节(简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法1)中定义
注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法1。
响应示例
以下是上述Python订阅返回的示例响应。Websocket订阅将实时更新24小时交易摘要。为简洁起见，以下仅提供初始响应：
{'channel': 'spot/market-api-ticker:BTC-USDT',
'subject': 'spot/market-api-ticker',
'data': '{
"buy":"82821.35",
"changePrice":"-610.48",
"changeRate":"-0.007317",
"high":"83799.09",
"last":"82821.45",
"low":"79998.45",
"open":"83431.93",
"sell":"82821.40",
"symbol":"78",
"vol":"10329.2388",
"volValue":"843619014.31"
}'
},.....
方法2
认证
这是一个公共Websocket，不需要认证。有关使用Websocket API的详细信息，请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2
Websocket URL
频率限制
无
订阅参数
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| event | true | String | 订阅或取消订阅。sub: 订阅; unsub: 取消订阅。注意：此参数区分大小写。 |
| params | true | Json | 请求的参数对象，包括： |
| -biz | true | String | 指定频道，例如，"exchange"。注意：建议使用小写。 |
| -type | true | String | 定义功能类型，例如，"ticker"。注意：建议使用小写。 |
| -pairCode | true | String | 货币对ID，即78 : BTC_USDT。 注意：货币对ID与交易品种的映射关系可通过 获取所有交易品种24小时交易摘要 接口获取。 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| biz | String | 频道名称，例如，"exchange"。 |
| pairCode | String | 货币对ID，即78 : BTC_USDT。 注意：货币对ID与交易品种的映射关系可通过 获取所有交易品种24小时交易摘要 接口获取。 |
| channel | String | 订阅类型，例如，"subscribe"。 |
| type | String | 消息类型，例如，"ticker"。 |
| -result | Boolean | 订阅请求的结果：true或false。 |
| data | Json | 数据对象，包含以下字段： |
| changePrice | bigdecimal | 价格变化 |
| changeRate | bigdecimal | 价格变化率 |
| high | bigdecimal | 过去24小时最高价（以报价货币计） |
| last | bigdecimal | 过去24小时最新价（以报价货币计） |
| low | bigdecimal | 过去24小时最低价（以报价货币计） |
| open | bigdecimal | 开盘价（以报价货币计） |
| symbol | string | 货币对ID，即78 : BTC_USDT。 注意：货币对ID与交易品种的映射关系可通过 获取所有交易品种24小时交易摘要 接口获取。 |
| vol | bigdecimal | 基础货币的交易量 |
| volValue | bigdecimal | USDT金额 |
订阅示例
以下Python代码展示了如何订阅BTC-USDT的24小时交易摘要。
注意：完整代码请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2。
url = "wss://ws.futurescw.com"
subscription_params = {"event":"sub",
"params":{
"biz":"exchange",
"type":"ticker",
"pairCode":"78"}} # "78" : BTC-USDT
SpotWebsocketPublic(url, subscription_params) # 函数SpotWebsocketPublic()在章节(简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2)中定义
注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2。
响应示例
以下是上述Python订阅返回的示例响应。Websocket订阅将实时更新24小时交易摘要。为简洁起见，以下仅提供初始响应：
{"biz":"exchange","pairCode":"78","data":{"result":true},"channel":"subscribe","type":"ticker"}
{"biz":"exchange","pairCode":"78","data":
"{\"changePrice\":\"535.14\",
\"changeRate\":\"0.005678\",
\"high\":\"94827.32\",
\"last\":\"94788.99\",
\"low\":\"92788.41\",
\"open\":\"94253.85\",
\"symbol\":\"78\",
\"vol\":\"6209.9048\",
\"volValue\":\"583370376.71\"
}","type":"ticker"},.....