pub struct PositionRef<'a>(/* private fields */);Expand description
Lifetime-scoped read borrow of a cached position.
Returned by crate::cache::Cache::position. The borrow drops with the enclosing scope, which
makes any attempt to hold it across a cache mutation panic at runtime: a loud failure beats the
silent staleness that a stored clone would produce.
Method calls on the inner [Position] resolve via Deref; comparisons against &Position
or owned Position values are direct (position_ref == &position); Display and Debug
forward to the inner record. Use cloned when an owned snapshot is required
(for example, before crossing a boundary that may dispatch events).
Implementations§
Source§impl<'a> PositionRef<'a>
impl<'a> PositionRef<'a>
Methods from Deref<Target = Position>§
pub fn clone_without_events(&self) -> Position
pub fn clone_without_events(&self) -> Position
Returns a copy without stored events, adjustments, replay events, fill voids, or trade IDs.
§Warning
Use this copy only as transient read state. Applying events or caching this copy can bypass replay and duplicate-fill checks and discard position history.
pub fn fill_fragments(
&self,
client_order_id: ClientOrderId,
trade_id: TradeId,
) -> Vec<&OrderFilled>
pub fn fill_fragments( &self, client_order_id: ClientOrderId, trade_id: TradeId, ) -> Vec<&OrderFilled>
Returns durable fill fragments matching an order trade in local application order.
pub fn try_calculate_pnl(
&self,
avg_px_open: f64,
avg_px_close: f64,
quantity: Quantity,
) -> Result<Money, Error>
pub fn try_calculate_pnl( &self, avg_px_open: f64, avg_px_close: f64, quantity: Quantity, ) -> Result<Money, Error>
Calculates profit and loss from the given prices and quantity.
§Errors
Returns an error if inverse P&L cannot be calculated or the result cannot be represented as
[Money].
pub fn calculate_pnl(
&self,
avg_px_open: f64,
avg_px_close: f64,
quantity: Quantity,
) -> Money
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 try_total_pnl(&self, last: Price) -> Result<Money, Error>
pub fn try_total_pnl(&self, last: Price) -> Result<Money, Error>
Returns total P&L (realized + unrealized) based on the last price.
§Errors
Returns an error if unrealized P&L cannot be calculated, the realized and unrealized
currencies differ, or the total cannot be represented as [Money].
pub fn total_pnl(&self, last: Price) -> Money
pub fn total_pnl(&self, last: Price) -> Money
Returns total P&L (realized + unrealized) based on the last price.
pub fn try_unrealized_pnl(&self, last: Price) -> Result<Money, Error>
pub fn try_unrealized_pnl(&self, last: Price) -> Result<Money, Error>
Returns unrealized P&L based on the last price.
§Errors
Returns an error if inverse P&L cannot be calculated or the result cannot be represented as
[Money].
pub fn unrealized_pnl(&self, last: Price) -> Money
pub fn unrealized_pnl(&self, last: Price) -> Money
Returns unrealized P&L based on the last price.
pub fn closing_order_side(&self) -> Option<OrderSide>
pub fn closing_order_side(&self) -> Option<OrderSide>
Returns the order side required to close this position.
pub fn is_opposite_side(&self, side: OrderSide) -> bool
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
pub fn symbol(&self) -> Symbol
Returns the instrument symbol.
pub fn venue(&self) -> Venue
pub fn venue(&self) -> Venue
Returns the trading venue.
pub fn event_count(&self) -> usize
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>
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>
pub fn venue_order_ids(&self) -> Vec<VenueOrderId>
Returns unique venue order IDs from all fill events, sorted.
pub fn try_notional_value(&self, last: Price) -> Result<Money, Error>
pub fn try_notional_value(&self, last: Price) -> Result<Money, Error>
Calculates the notional value based on the last price.
§Errors
Returns an error if this is an inverse position without a base currency, the price is not
positive for inverse valuation, or the result cannot be represented as [Money].
pub fn notional_value(&self, last: Price) -> Money
pub fn notional_value(&self, last: Price) -> Money
Calculates the notional value based on the last price.
§Panics
Panics if [Position::try_notional_value] returns an error.
pub fn last_event(&self) -> Option<OrderFilled>
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>
pub fn last_trade_id(&self) -> Option<TradeId>
Returns the last TradeId for the position (if any after purging).
pub fn is_open(&self) -> bool
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
pub fn is_closed(&self) -> bool
Returns whether the position is closed (flat with a close timestamp).
pub fn signed_decimal_qty(&self) -> Decimal
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>
pub fn commissions(&self) -> Vec<Money>
Returns the cumulative commissions for the position as a vector.