订阅最新成交数据

API说明

此Websocket API提供指定交易品种交易数据，包括合约大小、方向、交易ID、时间戳和价格。

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

注意事项

无

认证

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

Websocket URL

wss://ws.futurescw.com/perpum

频率限制

此订阅的频率限制为每IP每2秒50个请求。

订阅参数

参数	必填	类型	描述
event	true	String	订阅或取消订阅。sub：订阅；unsub：取消订阅。注意：此参数区分大小写。
params	true	Json	请求参数对象，包括：
-biz	true	String	指定频道，例如"futures"。注意：建议使用小写。
-type	true	String	定义功能类型，例如"fills"。注意：建议使用小写。
-pairCode	true	String	交易品种基础货币（例如，BTC或btc）。此参数不区分大小写。注意：对于以数字开头的合约（例如1000PEPE），大写和小写格式都有效。

响应参数

参数	类型	描述
biz	String	指定频道，例如"futures"
type	String	功能类型，例如"fills"
result	boolean	表示订阅或取消订阅是否成功：true，false
channel	String	指定执行的操作：subscribe或unsubscribe
pairCode	String	交易品种基础货币，即BTC
data	Json	数据对象，包含以下字段：
-createdDate	Long	交易发生的时间戳
-quantity	BigDecimal	基础货币的订单大小
-piece	BigDecimal	合约数量
-price	BigDecimal	已执行的交易价格
-id	Long	ID
-direction	String	交易方向：做多(long)，做空(short)

订阅示例

以下Python代码展示了如何订阅最新成交数据。

注意：完整代码示例请参考简介 > 认证和代码示例 > 合约 > Websocket公共接口。

subscription_params =  { "event": "sub",
                        "params": {
                        "biz": "futures",
                        "pairCode": "BTC",
                        "type": "fills"}}
url = "wss://ws.futurescw.com/perpum"
FuturesWebsocketPublic(url, subscription_params)  # function FuturesWebsocketPublic() is defined in section (Introduction > Authentication & Code Snippet > Futures > Websocket Public Interface)

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 合约 > Websocket公共接口。

响应示例

Websocket将实时更新交易数据。为简洁起见，以下仅显示Python订阅的一笔交易：

{'biz': 'futures',
 'pairCode': 'BTC',
 'data': {'result': True},
 'channel': 'subscribe',
 'type': 'fills'}
{'biz': 'futures',
 'pairCode': 'BTC',
 'data': [{'createdDate': 1740386094525,
   'quantity': 0.007,
   'piece': 7,
   'price': 95449,
   'id': 20742103698619397,
   'direction': 'long'}],
 'type': 'fills'},...........