账户

描述

实时接收账户相关的数据更新

以下事件发生时推送数据：

1. 首次订阅,推送
2. 统一账户现货/杠杆/合约委托单成交,推送
3. 资金结算时,推送
4. 改变balance时（划转、空投、借贷等），推送

请求示例

{
    "op": "subscribe",
    "args": [
        {
            "instType": "UTA",
            "topic": "account"
        }
    ]
}

请求参数说明

参数名	参数类型	是否必须	描述
op	String	是	操作 subscribe 订阅 unsubscribe 取消订阅
args	List<Object>	是	请求订阅的频道列表
> instType	String	是	产品类型 UTA 统一账户
> topic	String	是	频道名 account

订阅返回示例

{
  "event": "subscribe",
  "arg": {
    "instType": "UTA",
    "topic": "account"
  }
}

返回参数说明

返回字段	参数类型	字段说明
event	String	操作 subscribe 订阅 unsubscribe 退订 error 参数错误
arg	Object	订阅的频道
> instType	String	产品类型 UTA 统一账户
> topic	String	频道名 account 账户频道
code	String	错误码
msg	String	错误消息

推送示例

{
  "data": [{
    "unrealisedPnL": "-10116.55",
    "totalEquity": "4976919.05",
    "positionMgnRatio": "0",
    "mmr": "408.08",
    "effEquity": "4847952.35",
    "imr": "17795.97",
    "mgnRatio": "0",
    "coin": [{
      "debts": "0",
      "balance": "0.9992",
      "available": "0.9992",
      "borrow": "0",
      "locked": "0",
      "equity": "0.9992",
      "coin": "ETH",
      "usdValue": "2488.667472"
    }, {
      "debts": "0",
      "balance": "52.00819",
      "available": "52.00819",
      "borrow": "0",
      "locked": "0",
      "equity": "52.00819",
      "coin": "BTC",
      "usdValue": "4630564.31304974"
    }, {
      "debts": "0",
      "balance": "354411.45536458",
      "available": "344282.65536458",
      "borrow": "0",
      "locked": "0",
      "equity": "344282.65536458",
      "coin": "USDT",
      "usdValue": "343866.07335159"
    }]
  }],
  "arg": {
    "instType": "UTA",
    "topic": "account"
  },
  "action": "snapshot",
  "ts": 1740546523244
}

推送参数说明

属性名	类型	描述
arg	Object	订阅成功频道
ts	String	时间戳
> instType	String	产品线类型 UTA统一账户
> topic	String	频道名 account账户频道
action	String	推送数据动作 snapshot全量 update 增量
data	List<String>	订阅的数据
>totalEquity	String	账户权益，单位为USD
>effEquity	String	有效保证金，单位为USD 账户中可为全仓模式下的现货、永续合约交易提供保证金的资产折合成法币价值的净值
>mmr	String	维持保证金，单位为USD 维持当前仓位所需的最低保证金
>imr	String	初始保证金，单位为USD 账户中所有全仓持仓及挂单的保证金折合成法币价值的净值
>mgnRatio	String	保证金比率
>positionMgnRatio	String	持仓保证金比率
>unrealisedPnL	String	未实现盈亏
>coin	Array	资产币种列表
>>coin	String	币种名称
>>balance	String	币种余额
>>locked	String	下单占用 仅现货下单场景有值
>>equity	String	币种权益
>>usdValue	String	币种美金价值
>>available	String	币种可用
>>borrow	String	借款
>>debts	String	负债 当前币种的已用借贷额度 (仅现货杠杆借贷时)