订阅交易

API说明

此Websocket接口提供指定交易品种的实时交易数据，包括交易数量、交易价格、总交易金额、交易时间戳和交易方向。

注意：交易数据可通过RESTful和Websocket接口获取。本页是Websocket接口的描述。如需了解RESTful接口，请参见 跳转

注意事项

1. 目前有两种方法可用于交易订阅。用户在创建连接时应谨慎操作。

方法1

认证

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

Websocket URL

wss://ws.futurescw.info?token={your_token}

频率限制

无

订阅参数

参数	必填	类型	描述
event	True	String	subscribe
args	True	String	"spot/match:symbol"; 其中symbol是要订阅的货币。 示例，"spot/match:BTC-USDT"

响应参数

参数	类型	描述
channel	String	订阅的频道，即"spot/match:BTC-USDT"
subject	String	主题，即"spot/match"
data	Array	数据对象
price	String	报价货币计的价格
seq	String	序列号
side	String	交易方向：BUY/SELL
size	String	基础货币计的数量
symbol	String	货币对ID，即78 : BTC_USDT。 注意：货币对ID与交易品种的映射关系可通过 获取所有交易品种24小时交易摘要 接口获取。
time	String	交易时间（毫秒时间戳）

订阅示例

以下Python代码展示了如何订阅BTC的交易数据。

注意：完整代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法1。

symbol = "BTC-USDT"
args = f'spot/match:{symbol}' 
SpotWebsocketPublic(args)     # 函数SpotWebsocketPublic()在章节(简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法1)中定义

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法1

响应示例

以下是上述Python订阅返回的示例响应。Websocket将实时更新交易数据。为简洁起见，以下仅显示一条交易数据：

{'channel': 'spot/match:BTC-USDT',
 'subject': 'spot/match',
 'data': '[{
"price":"82861.81",
"seq":"127365683",
"side":"SELL",
"size":"0.0004",
"symbol":"78",
"time":"1741944585776"
}]'
}

方法2

认证

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

Websocket URL

wss://ws.futurescw.com

频率限制

无

订阅参数

参数	必填	类型	描述
event	true	String	订阅或取消订阅。sub: 订阅; unsub: 取消订阅。 注意：此参数区分大小写。
params	true	Json	请求的参数对象，包括：
-biz	true	String	指定频道，例如，"exchange"。 注意：建议使用小写。
-type	true	String	定义功能类型，例如，"fills"。 注意：建议使用小写。
-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	定义功能类型，例如，"fills"。
-result	Boolean	订阅请求的结果：true或false。
data	Json	数据对象，包含以下字段：
price	String	报价货币计的价格
seq	String	序列号
side	String	交易方向：BUY/SELL
size	String	基础货币计的数量
symbol	String	货币对ID，即78 : BTC_USDT。 注意：货币对ID与交易品种的映射关系可通过 获取所有交易品种24小时交易摘要 接口获取。
time	String	交易时间（毫秒时间戳）

订阅示例

çç 以下Python代码展示了如何订阅BTC的交易数据。

注意：完整代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2。

url = "wss://ws.futurescw.com"
subscription_params =  {"event":"sub",
                        "params":{
                          "biz":"exchange",
                          "type":"fills",
                          "pairCode":"78"}}   #78表示BTC-USDT
SpotWebsocketPublic(url, subscription_params) # 函数SpotWebsocketPublic()在章节(简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2)中定义

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket公共接口 > 方法2

响应示例

以下是上述Python订阅返回的示例响应。Websocket将实时更新交易数据。为简洁起见，以下仅显示一条交易数据：

{"biz":"exchange","pairCode":"78","data":{"result":true},"channel":"subscribe","type":"fills"}

{"biz":"exchange","pairCode":"78","data":"[
{\"price\":\"94718.84\",
\"seq\":\"130167227\",
\"side\":\"BUY\",
\"size\":\"0.0010\",
\"symbol\":\"78\",
\"time\":\"1745825592789\"
}]","type":"fills"},.....