Struct PositionRefMut 

pub struct PositionRefMut<'a>(/* private fields */);

Lifetime-scoped exclusive write borrow of a cached position.

Returned by crate::cache::Cache::position_mut. While the borrow is alive, no other read or write on the same cell is permitted (enforced at runtime by the underlying RefMut). Drop the borrow before dispatching events or taking any other cache borrow that may re-enter the same position.

Implementations

impl<'a> PositionRefMut<'a>

pub fn new(inner: RefMut<'a, Position>) -> Self

Wraps the given RefMut borrow.

pub fn cloned(&self) -> Position

Returns an owned snapshot of the borrowed position.

Methods from Deref<Target = Position>

pub fn purge_events_for_order(&mut self, client_order_id: ClientOrderId)

Purges all order fill events for the given client order ID and recalculates derived state.

Warning

This operation recalculates the entire position from scratch after removing the specified order’s fills. This is an expensive operation and should be used sparingly.

Panics

Panics if after purging, no fills remain and the position cannot be reconstructed.

pub fn apply(&mut self, fill: &OrderFilled)

Applies an OrderFilled event to this position.

Panics

Panics if the fill.trade_id is already present in the position’s trade_ids.

pub fn apply_adjustment(&mut self, adjustment: PositionAdjusted)

Applies a position adjustment event.

This method handles adjustments to position quantity or realized PnL that occur outside of normal order fills, such as:

• Commission adjustments in base currency (crypto spot markets).
• Funding payments (perpetual futures).

The adjustment event is stored in the position’s adjustment history for full audit trail.

Panics

Panics if the adjustment’s quantity_change cannot be converted to f64.

pub fn calculate_pnl( &self, avg_px_open: f64, avg_px_close: f64, quantity: Quantity, ) -> Money

Calculates profit and loss from the given prices and quantity.

pub fn total_pnl(&self, last: Price) -> Money

Returns total P&L (realized + unrealized) based on the last price.

pub fn unrealized_pnl(&self, last: Price) -> Money

Returns unrealized P&L based on the last price.

pub fn closing_order_side(&self) -> OrderSide

Returns the order side required to close this position.

pub fn is_opposite_side(&self, side: OrderSide) -> bool

Returns whether the given order side is opposite to the position entry side.

pub fn symbol(&self) -> Symbol

Returns the instrument symbol.

pub fn venue(&self) -> Venue

Returns the trading venue.

pub fn event_count(&self) -> usize

Returns the count of order fill events applied to this position.

pub fn client_order_ids(&self) -> Vec<ClientOrderId>

Returns unique client order IDs from all fill events, sorted.

pub fn venue_order_ids(&self) -> Vec<VenueOrderId>

Returns unique venue order IDs from all fill events, sorted.

pub fn trade_ids(&self) -> Vec<TradeId>

Returns unique trade IDs from all fill events, sorted.

pub fn notional_value(&self, last: Price) -> Money

Calculates the notional value based on the last price.

Panics

Panics if self.base_currency is None, or if last is not a positive price for inverse instruments.

pub fn last_event(&self) -> Option<OrderFilled>

Returns the last OrderFilled event for the position (if any after purging).

pub fn last_trade_id(&self) -> Option<TradeId>

Returns the last TradeId for the position (if any after purging).

pub fn is_long(&self) -> bool

Returns whether the position is long (positive quantity).

pub fn is_short(&self) -> bool

Returns whether the position is short (negative quantity).

pub fn is_open(&self) -> bool

Returns whether the position is currently open (has quantity and no close timestamp).

pub fn is_closed(&self) -> bool

Returns whether the position is closed (flat with a close timestamp).

pub fn signed_decimal_qty(&self) -> Decimal

Returns the signed quantity as a Decimal.

Uses the raw signed_qty field to preserve full precision, as the quantity field may have reduced precision based on the instrument’s size_precision.

pub fn commissions(&self) -> Vec<Money>

Returns the cumulative commissions for the position as a vector.

Trait Implementations

impl AsMut<Position> for PositionRefMut<'_>

fn as_mut(&mut self) -> &mut Position

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Position> for PositionRefMut<'_>

fn as_ref(&self) -> &Position

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for PositionRefMut<'_>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for PositionRefMut<'_>

type Target = Position

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for PositionRefMut<'_>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Display for PositionRefMut<'_>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> From<RefMut<'a, Position>> for PositionRefMut<'a>

fn from(inner: RefMut<'a, Position>) -> Self

Converts to this type from the input type.

impl PartialEq<&Position> for PositionRefMut<'_>

fn eq(&self, other: &&Position) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Position> for PositionRefMut<'_>

fn eq(&self, other: &Position) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.