Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
公共频道
私有频道
    下单撤单修改订单订单成交快速成交批量下单批量撤单批量修改订单账户持仓ADL通知策略订单频道
Reality
SBE
私有频道

账户

描述

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

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

  1. 首次订阅,推送
  2. 统一账户现货/杠杆/合约委托单成交,推送
  3. 资金结算时,推送
  4. 改变balance时(划转、空投、借贷等),推送
Code
{ "op": "subscribe", "args": [ { "instType": "UTA", "topic": "account" } ] }

请求参数说明

参数名参数类型是否必须描述
opString是操作
subscribe 订阅
unsubscribe 取消订阅
argsList<Object>是请求订阅的频道列表
> instTypeString是产品类型
UTA 统一账户
> topicString是频道名 account
Code
{ "event": "subscribe", "arg": { "instType": "UTA", "topic": "account" }, "connId": "xxxxxxxxxx" }

返回参数说明

返回字段参数类型字段说明
eventString操作
subscribe 订阅
unsubscribe 退订
error 参数错误
argObject订阅的频道
> instTypeString产品类型
UTA 统一账户
> topicString频道名
account 账户频道
codeString错误码
msgString错误消息
connIdString连接ID
Code
{ "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", "bonus": "0" }, { "debts": "0", "balance": "52.00819", "available": "52.00819", "borrow": "0", "locked": "0", "equity": "52.00819", "coin": "BTC", "usdValue": "4630564.31304974", "bonus": "0" }, { "debts": "0", "balance": "354411.45536458", "available": "344282.65536458", "borrow": "0", "locked": "0", "equity": "344282.65536458", "coin": "USDT", "usdValue": "343866.07335159", "bonus": "10" }] }], "arg": { "instType": "UTA", "topic": "account" }, "action": "snapshot", "ts": 1740546523244 }

推送参数说明

属性名类型描述
actionString推送数据动作
snapshot全量
update 增量
tsNumber时间戳
argObject订阅成功频道
> instTypeString产品线类型
UTA统一账户
> topicString频道名
account账户频道
dataList<Object>订阅的数据
>totalEquityString账户权益,单位为USD
>effEquityString有效保证金,单位为USD
账户中可为全仓模式下的现货、永续合约交易提供保证金的资产折合成法币价值的净值
>mmrString维持保证金,单位为USD
维持当前仓位所需的最低保证金
>imrString初始保证金,单位为USD
账户中所有全仓持仓及挂单的保证金折合成法币价值的净值
>mgnRatioString保证金比率
>positionMgnRatioString持仓保证金比率
>unrealisedPnLString未实现盈亏
>coinArray资产币种列表
>>coinString币种名称
>>balanceString币种余额
>>lockedString下单占用
仅现货下单场景有值
>>equityString币种权益
>>usdValueString币种美金价值
>>availableString币种可用
>>borrowString借款
>>debtsString负债
当前币种的已用借贷额度 (仅现货杠杆借贷时)
>>bonusStringUSDT 体验金金额
批量修改订单持仓
JSON
JSON
JSON