Struct PercentageTrailingStop 

pub struct PercentageTrailingStop { /* private fields */ }

Percentage Trailing Stop — a fixed-percentage stop that ratchets with the trend and flips to the opposite side on a close-through.

step = price · percent / 100

long:   stop_t = max(stop_{t−1}, close − step)   while close ≥ stop_{t−1}
short:  stop_t = min(stop_{t−1}, close + step)   while close ≤ stop_{t−1}
flip-to-long  on a close > prev short-stop -> stop = close − step
flip-to-short on a close < prev long-stop  -> stop = close + step

The first input seeds a long stop percent below price. Unlike the ATR trailing stop the band is purely proportional to the latest price, so it scales naturally across instruments without re-tuning. A common configuration is 5.0 (a 5% trail).

Example

use wickra_core::{Indicator, PercentageTrailingStop};

let mut indicator = PercentageTrailingStop::new(5.0).unwrap();
let mut last = None;
for i in 0..20 {
    last = indicator.update(100.0 + f64::from(i));
}
assert!(last.is_some());

Implementations

impl PercentageTrailingStop

pub fn new(percent: f64) -> Result<Self>

Construct a Percentage Trailing Stop with an explicit trail size (e.g. 5.0 for a 5% trail).

Errors

Returns Error::NonPositiveMultiplier if percent is not strictly positive and finite.

pub fn classic() -> Self

A common configuration: a 5.0% trail.

pub const fn percent(&self) -> f64

Configured trail percent.

Trait Implementations

impl Clone for PercentageTrailingStop

fn clone(&self) -> PercentageTrailingStop

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PercentageTrailingStop

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

Formats the value using the given formatter.

impl Indicator for PercentageTrailingStop

type Input = f64

Type of one input data point (typically f64 for a price, or Candle / Tick).

type Output = f64

Type of one output value.

fn update(&mut self, close: f64) -> Option<f64>

Feed one new data point into the indicator and return the freshly computed output, or None if the indicator is still warming up.

fn reset(&mut self)

Reset all internal state, leaving the indicator equivalent to a freshly constructed instance with the same parameters.

fn warmup_period(&self) -> usize

Number of inputs required before the first non-None output can be produced.

fn is_ready(&self) -> bool

Whether the indicator has emitted at least one value since the last reset.

fn name(&self) -> &'static str

Stable, human-readable indicator name. Used by chaining and diagnostics.