订阅资产

API说明

此Websocket在建立连接后，当用户的现货账户上发生交易活动时，提供资产余额的实时更新。

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

注意事项

1. Websocket连接仅返回连接建立后进入交易的订单所影响的资产的实时更新。连接前已存在的订单或已执行交易的更新将不会被推送。用户应确保有活跃的交易活动以接收实时更新。

认证

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

Websocket URL

wss://ws.futurescw.com

频率限制

无

订阅参数

参数	必填	类型	描述
event	True	String	订阅或取消订阅。sub：订阅；unsub：取消订阅。 注意：此参数区分大小写。
params	True	Json	包含以下内容的数据对象：
-biz	True	String	指定频道，例如"exchange"
-type	True	String	定义功能类型，例如"assets"

响应参数

参数	类型	描述
biz	String	指定频道，例如"exchange"
type	String	定义功能类型，例如"assets"
data	Array	数据对象
-available	Long	可用余额
-currency	String	基础货币，例如BTC
-time	String	时间戳
-type	String	类型：change
-ledger_id	String	关联的账本ID
-account	String	账户：spot
-hold	String	持有量

订阅示例

以下Python代码展示了如何订阅用户资产。

注意：完整代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket私有接口。

url = "wss://ws.futurescw.com"
 
subscription_payload = {"event": "sub",
                         "params": {"biz": "exchange",
                                    "type": "assets"}}
api_key= "your_api_key" 
sec_key = "your_sec_key"
SpotWebsocketPrivate(url, subscription_payload, api_key, sec_key)  # 函数SpotWebsocketPrivate()在章节(简介 > 认证和代码示例 > 现货 > Websocket私有接口)中定义

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > Websocket私有接口。

响应示例

以下是上述Python订阅返回的示例响应。Websocket订阅将实时更新资产余额。为简洁起见，下面仅显示初始响应：

{'data': {'result': True}, 'channel': 'login'}
{'biz': 'exchange', 'data': {'result': True}, 'channel': 'subscribe', 'type': 'assets'}     
{'biz': 'exchange',
 'data': {'available': '12.59490035',
  'currency': 'USDT',
  'time': 1743773396836,
  'type': 'change',
  'ledger_id': 1125899934698144651,
  'account': 'spot',
  'hold': '0'},
 'type': 'assets'}
{'biz': 'exchange',
 'data': {'available': '0.0025',
  'currency': 'BTC',
  'time': 1743773396836,
  'type': 'change',
  'ledger_id': 1125899934698144652,
  'account': 'spot',
  'hold': '0'},
 'type': 'assets'}