Positions

Positions

Name Lite	Type	Required Default	Description
event_time et	string	True	Time at which the event was emitted in unix nanoseconds
sub_account_id sa	string	True	The sub account ID that participated in the trade
instrument i	string	True	The instrument being represented
size s	string	True	The size of the position, expressed in base asset decimal units. Negative for short positions
notional n	string	True	The notional value of the position, negative for short assets, expressed in quote asset decimal units
entry_price ep	string	True	The entry price of the position, expressed in 9 decimals Whenever increasing the size of a position, the entry price is updated to the new average entry price new_entry_price = (old_entry_price * old_size + trade_price * trade_size) / (old_size + trade_size)
exit_price ep1	string	True	The exit price of the position, expressed in 9 decimals Whenever decreasing the size of a position, the exit price is updated to the new average exit price new_exit_price = (old_exit_price * old_exit_trade_size + trade_price * trade_size) / (old_exit_trade_size + trade_size)
mark_price mp	string	True	The mark price of the position, expressed in 9 decimals
unrealized_pnl up	string	True	The unrealized PnL of the position, expressed in quote asset decimal units unrealized_pnl = (mark_price - entry_price) * size
realized_pnl rp	string	True	The realized PnL of the position, expressed in quote asset decimal units realized_pnl = (exit_price - entry_price) * exit_trade_size
total_pnl tp	string	True	The total PnL of the position, expressed in quote asset decimal units total_pnl = realized_pnl + unrealized_pnl
roi r	string	True	The ROI of the position, expressed as a percentage roi = (total_pnl / (entry_price * abs(size))) * 100^
quote_index_price qi	string	True	The index price of the quote currency. (reported in USD)
est_liquidation_price el	string	True	The estimated liquidation price
leverage l	string	True	The current leverage value for this position
cumulative_fee cf	string	True	The cumulative fee paid on the position, expressed in quote asset decimal units
cumulative_realized_funding_payment cr	string	True	The cumulative realized funding payment of the position, expressed in quote asset decimal units. Positive if paid, negative if received
margin_type mt	PositionMarginType	True	The margin type of the position
isolated_balance ib	string	False None	[IsolatedOnly] The wallet balance reserved for this isolated margin position, expressed in quote asset decimal units. If this positions is liquidated, this is the maximal balance that can be lost
isolated_im ii	string	False None	[IsolatedOnly] The initial margin of the isolated margin position, expressed in quote asset decimal units. The total_equity required to open more size in the position
isolated_mm im	string	False None	[IsolatedOnly] The maintenance margin of the isolated margin position, expressed in quote asset decimal units. The total_equity required to avoid liquidation of the position

PositionMarginType

Value	Description
ISOLATED = 1	Isolated Margin Mode: each position is allocated a fixed amount of collateral
CROSS = 2	Cross Margin Mode: uses all available funds in your account as collateral across all cross margin positions