Bitget account

messageaccountBitget WebSocket APIWebSocketPrivate channels

The unified trading account: equity, margin figures and the balance of each coin. Bitget says data is pushed on first subscribing, when orders are filled, when funds are settled and when a balance changes.

Risk warning: CFDs and spread bets are complex instruments and come with a high risk of losing money rapidly due to leverage. You can lose money on these products, and each provider publishes its own loss figure under FCA rules. You should consider whether you understand how they work and whether you can afford to take the high risk of losing your money. Automated and API trading can amplify losses through bugs, connectivity failures and runaway orders.

Independent and unofficialbitget.comchecked 12 Oct 2026

This is a subscription of the Bitget WebSocket API, not an HTTP endpoint. It has no method and no path: it is sent as JSON over an open WebSocket connection.

The message

Name: account
Direction: Subscription, opened by the client and then fed by the server
Subscribed to as: account
Carried by: WebSocket. This channel is in the private section of Bitget's WebSocket documentation, so the connection has to send login first. The addresses are the ones on Bitget's quick start page (bitget.com/docs/uta/quick-start), opened the same day, which also lists VIP and low latency hosts.
Private channel: wss://ws.bitget.com/v3/ws/private
Private channel, demo trading: wss://wspap.bitget.com/v3/ws/private

Fields

Name	Type	Description
oprequired	String	subscribe to start the channel, unsubscribe to stop it.
argsrequired	List<Object>	The channels to act on. Each entry names one.
args[].instTyperequired	String	Always UTA, for the unified trading account.
args[].topicrequired	String	Always account.

What arrives

account: A message with the event subscribe and the same arg confirms the subscription, with a connId for the connection. On an error the event is error, with a code and a msg. Data then arrives as below.

The vendor's page does not say which of these fields are required or always present.

Name	Type	Description
arg	Object	The channel the data belongs to: the instType, the topic and, on a public channel, the symbol that were subscribed to.
action	String	snapshot for full data, update for incremental data.
ts	Number	The time of the push.
data	List	The account data.
data[].totalEquity	String	The equity of the account, in US dollars.
data[].effEquity	String	The effective margin, in US dollars.
data[].mmr	String	The maintenance margin, in US dollars.
data[].imr	String	The initial margin, in US dollars.
data[].mgnRatio	String	The margin ratio.
data[].positionMgnRatio	String	The margin ratio of held positions.
data[].unrealisedPnL	String	The unrealised profit and loss.
data[].coin	List	One entry for each coin held.
data[].coin[].coin	String	The name of the coin.
data[].coin[].balance	String	The balance of the coin.
data[].coin[].balanceOriginal	String	The balance worked out without deducting amounts related to borrowing.
data[].coin[].locked	String	The amount locked. For spot orders only.
data[].coin[].equity	String	The equity of the coin, in US dollars.
data[].coin[].usdValue	String	The value of the coin, in US dollars.
data[].coin[].available	String	The balance available.
data[].coin[].borrow	String	The amount borrowed.
data[].coin[].debts	String	The debt. For margin trading only.
data[].coin[].bonus	String	The USDT bonus amount.

Sample

Written by this site from the fields recorded on this page. It has not been run against a terminal, a server or an account, and the values in it are placeholders. No credential is typed into it: where a field holds one, the placeholder says where it comes from. Nothing is entered on this site.

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

Limits that apply at Bitget

Limit	Value	Scope	Source
Public market data, legacy v1 API	20 per 2 s per IP, public market data	Per IP address, public market data endpoints of the legacy v1 API	bitgetlimited.github.iochecked 12 Oct 2026
Overall requests a minute	6,000	Per IP address, all requests to the common domain name, with REST and WebSocket sharing one allowance	bitget.comchecked 12 Oct 2026
Concurrent WebSocket connections	100	Per IP address	bitget.comchecked 12 Oct 2026
WebSocket messages a second	10	Per WebSocket connection, counting ping, login, subscribe and unsubscribe messages	bitget.comchecked 12 Oct 2026
WebSocket subscription requests an hour	240	Per WebSocket connection	bitget.comchecked 12 Oct 2026
Concurrent WebSocket channel subscriptions	1,000	Per WebSocket connection	bitget.comchecked 12 Oct 2026