订阅账户变动数据

account

是否验签: 是

接口权限: 读取

限频: WebSocket私有订单成交推送接口(需要API KEY验签) 一个UID最多同时建立30个私有订单成交推送WS链接。该用户在一个品种(包含该品种的所有周期的合约)上，仅需要维持一个订单推送WS链接即可。 单个链接为50次/秒的请求，单个IP链接为100次/秒的请求。 注意: 订单推送WS的限频，跟用户RESTFUL私有接口的限频是分开的，相互不影响。

接口描述: 当账户的静态金额发生变化的时刻(冻结、释放保证金、资金费率结算、已实现盈亏等)，推送如下账户相关信息

订阅地址

环境	地址
线上环境	wss://api.sunx.io/ws/v1/notification
线上环境（aws客户首选）	wss://api.sunx.io/ws/v1/notification

请求参数

字段名称	类型	说明
op	string	必填;操作名称，sub 或 unsub;
cid	string	选填;Client 请求唯一 ID
topic	string	必填;account

规则说明

订阅(sub)	取消订阅(unsub)	规则
account	account	允许
account.contract_code1	account.*	不允许

订阅参数

参数	数据类型	是否必填	描述	取值范围	默认值
无数据

数据更新

参数	数据类型	是否必填	描述	取值范围
op	String	true	操作名称	notify
topic	String	true	推送的主题	account
ts	long	true	服务端应答时间戳
event	String	true	账户变化通知相关事件说明	事件类型 snapshot：首推快照 create_order: 订单下单 cancel_order: 订单撤单 delivered：交割 transferred：划转 filled：成交 liquidation：强平 adl：ADL自动减仓 funding_fee：资金费 set_leverage：设置杠杆 price_update ：价格更新 （api 用户不要） auto_exchange：自动兑换
uid	String	true	用户uid
<data>		true
state	String	true	账户状态	1(NORMAL):正常（交易，划转）、2(LOCKED):-暂时未用到、3(LIQUIDATING)：强平中，不允许交易、划转、收取资金费、4(BANKRUPTCY):暂时未用到 5(ADL):adl中，不允许交易、收取资金费、划转、6(OPEN_LIMIT):风控撤单中，合约交易只允许下减仓单，可以转入，不允许转出
equity	String	true	账户权益
initial_margin	String	true	初始保证金
maintenance_margin	String	true	维持保证金
maintenance_margin_rate	String	true	维持保证金率
profit_unreal	String	true	未实现盈亏
available_margin	String	true	可用保证金
voucher_value	String	true	体验金(usdt)
created_time	String	true	账户创建时间
updated_time	String	true	账户更新时间
details	String	true
currency	String	true	币种
equity	String	true	该币种资产权益
available	String	true	该币种可用
withdraw_available	String	true	该币种可转
profit_unreal	String	true	未实现盈亏
initial_margin	String	true	该币种初始保证金
maintenance_margin	String	true	该币种维持保证金
maintenance_margin_rate	String	true	该币种维持保证金率
initial_margin_rate	String	true	该币种初始保证金率
voucher	String	true	体验金
voucher_value	String	true	体验金(usdt)
created_time	String	true	创建时间
updated_time	String	true	更新时间
<data>		false

订阅示例

{
  "op": "sub",
  "cid": "CEP7ozFIYa",
  "topic": "account"
}

订阅成功示例

{
    "ch": "market.BTC-USDT.estimated_rate.1min",
    "status": "ok",
    "ts": 1757932916625,
    "data": [
        {
            "id": 1757932860,
            "open": "0.0001",
            "close": "0.0001",
            "high": "0.0001",
            "low": "0.0001",
            "amount": "0",
            "vol": "0",
            "trade_turnover": "0",
            "count": "0"
        }
    ]
}

数据更新示例

{
  "op": "notify",
  "topic": "account",
  "contract_code": "",
  "ts": 1734681235891,
  "uid": "413120795",
  "event": "snapshot",
  "data": {
    "equity": "10264.111400000000001",
    "state": "normal",
    "details": [
      {
        "currency": "USDT",
        "equity": "10264.111400000000001",
        "available": "10977.511400000000001",
        "profit_unreal": "-713.4",
        "initial_margin": "133.933333333333333333",
        "maintenance_margin": "6.027",
        "maintenance_margin_rate": "0.00058719160043411",
        "initial_margin_rate": "0.013048702231869125",
        "voucher": "",
        "voucher_value": "",
        "withdraw_available": "123456",
        "created_time": 1734675405381,
        "updated_time": 1734681182933
      },
      {
        "currency": "BTC",
        "equity": "0",
        "available": "0",
        "profit_unreal": "0",
        "initial_margin": "0",
        "maintenance_margin": "0",
        "maintenance_margin_rate": "0",
        "initial_margin_rate": "0",
        "voucher": "",
        "voucher_value": "",
        "withdraw_available": "123456",
        "created_time": 1734675456866,
        "updated_time": 1734675570751
      }
    ],
    "initial_margin": "133.933333333333333333",
    "maintenance_margin": "6.027",
    "maintenance_margin_rate": "0.00058719160043411",
    "profit_unreal": "-713.4",
    "available_margin": "10130.178066666666667667",
    "created_time": 1734668300071,
    "updated_time": 1734681182933,
    "voucher_value": "",
    "version": 1010
  }
}