Skip to main content
WSS
This stream provides your account balance, margin usage, and PnL. Subscribe with the optionsAccountSummary subscription, then request a snapshot with emitOptionsAccountSummary.
emitOptionsAccountSummary returns the current snapshot — it does not subscribe you. Subscribe to optionsAccountSummary explicitly with subscribe, or list it in the subscriptions query parameter when you connect. Without the subscription the snapshot you asked for is published to a channel you are not listening on, and you receive nothing.
The account summary is account-wide — emitOptionsAccountSummary takes no market, and any contract filter is ignored when you subscribe to optionsAccountSummary.

​
Keeping the Summary Current

There is no delta on this stream and no spontaneous push — a snapshot is only ever sent in response to an emitOptionsAccountSummary. To track the account live, re-emit after events that move your balance — order fills on the Order Creation Stream and settlements on the Settlements Stream — or on a timer. totalEquity and the margin ratios also depend on the mark price, so re-emit on Contracts Stream updates if you need them to track the market between balance changes. See Account Equity & Balances for how totalEquity, availableBalance, and the margin ratios are derived.
market
type:string
required

A specific market (e.g. BTC-USDT) or ALL.

expiration
type:string
required

Contract expiration, e.g. 24JUN26. Requires market; omit to match every expiration.

strike
type:string
required

Strike price, e.g. 62000. Requires expiration; omit to match every strike.

type
type:string
required

C (call) or P (put). Requires strike; omit to match both.

Sec-WebSocket-Protocol
type:httpApiKey

Supply as authorization#<JWT> during the WebSocket handshake.

Emit Options Account Summary
type:object

Returns the current snapshot; does not subscribe you. Requires an active optionsAccountSummary subscription for the response to reach you. Account-wide, so market is ignored.

Account Summary
type:object

Response to emitOptionsAccountSummary. Delivered only while subscribed to optionsAccountSummary; nothing is pushed on its own.