订阅资金费率

API说明

此websocket允许查询指定交易品种的实时资金费率。

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

注意事项

1. RESTful API 提供最近一次结算时的资金费率信息，WebSocket API 和webpage 提供实时资金费率数据的获取。

认证

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

Websocket URL

wss://ws.futurescw.com/perpum

频率限制

无

订阅参数

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

响应参数

参数	类型	描述
biz	String	指定频道，例如，'futures"。
type	String	定义功能类型，例如，"funding_rate"
result	boolean	指示订阅或取消订阅是否成功：true, false。
channel	String	指定执行的操作：subscribe或unsubscribe。
pairCode	String	交易品种的基础货币，例如，BTC。
data	Json	数据对象，包含以下字段：
-r	big Decimal	资金费率
-nt	Long	时间戳（unix）
-n	string	交易品种的基础货币，例如，btc

订阅示例

以下Python代码展示了如何订阅"BTC"的资金费率。

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

subscription_params =  { "event": "sub",
                        "params": {
                        "biz": "futures",
                        "pairCode": "BTC",
                        "type": "funding_rate"}}
 
url = "wss://ws.futurescw.com/perpum"
FuturesWebsocketPublic(url, subscription_params)     #函数FuturesWebsocketPublic()在章节(简介 > 认证和代码示例 > 合约 > Websocket公共接口)中定义

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

响应示例

Websocket订阅将实时更新资金费率。为简洁起见，以下仅提供Python订阅的初始响应：

{'biz': 'futures',
 'pairCode': 'BTC',
 'data': {'result': True},
 'channel': 'subscribe',
 'type': 'funding_rate'}
{'biz': 'futures',
 'pairCode': 'btc',
 'data': {'r': 4.926e-05, 'nt': 1745490090000, 'n': 'btc'},
 'type': 'funding_rate'},.....