Back to builder reference

Value ref

live_position

Metric computed from the currently open position (live, not frozen) — field: entry_price | bars_in_position | unrealized_pnl_pct | unrealized_pnl_usd | max_excursion_pct | min_excursion_pct. NaN when flat.

Backing types

LivePositionSignalRef

Required fields

fieldreqenum: entry_price, bars_in_position, unrealized_pnl_pct, unrealized_pnl_usd, max_excursion_pct, min_excursion_pct-

Optional fields

factoranyOf (2 variants)-
resolutionanyOf (2 variants)Optional higher-timeframe override for this value ref. Set it inside lhs/rhs refs such as {'type': 'indicator', ..., 'resolution': '4h'} or {'type': 'price', 'field': 'close', 'resolution': '4h'}. Do not put timeframe/source_timeframe on the parent condition. None = strategy timeframe.
typestring-

Backing types

The IR ValueRef classes this builder field resolves to.

LivePositionSignalRef
Quawd

A subscription SaaS platform for designing, backtesting, and paper-trading algorithmic trading strategies on equities and crypto — described in plain English to an AI agent, no code required.

© 2026 Quawd. All rights reserved.

Quawd is a software tool, not a broker-dealer or investment adviser, and does not provide investment advice. Trading involves substantial risk of loss. Backtested and hypothetical results have inherent limitations and are not indicative of future performance.