Skip to content
StatAlphaDocumentation

Movement analysis

Movement analysis describes how far price moved after a defined historical event. It is available for supported ORB, GAP, FVG, BOS and PDHLB profiles. The event, reference price and observation horizon depend on the selected profile: a historical reference is not a guaranteed executable entry.

Maximum favourable excursion (MFE) measures the largest movement in the event’s direction from its reference price. Maximum adverse excursion (MAE) measures the largest movement against it. For a long event with reference 100, later high 103 and later low 98, MFE is 3 and MAE is 2. For a short event, the directions are reversed. Percentages use the event reference price. ORB-width multiples are not risk multiples.

Supply positive target_pct and stop_pct values to examine which level was reached first. Price bars do not reveal every intrabar movement: if both levels are reached and their order cannot be established, the event is marked ambiguous. Ambiguous and incomplete observations are not silently treated as wins or losses. Review sample counts and coverage before interpreting probabilities. Historical results do not represent realized execution, trading costs or a trading recommendation.

A response can be complete, partial, pending or unavailable. A partial or pending result does not describe all requested sessions. Some profiles, ranges or data may not be available for every symbol or account. Missing or incomplete paths are not equivalent to zero movement. Compare like-for-like profiles, reference prices, horizons and observation periods.

For ORB, optional segments can compare conditional outcomes with a matching overall baseline. Percentages, lift and confidence intervals are descriptive of the observed sample and should not be interpreted as causal proof.

For a supported {family} (orb, gap, fvg, bos or pdhlb):

  • GET /stats/{family}/excursions returns event-level results.
  • GET /stats/{family}/excursions/summary returns grouped results.
  • GET /stats/{family}/excursion-analysis reads the available target/stop analysis.
  • POST /stats/{family}/excursion-analysis can request additional missing results where supported; review the returned status and coverage.

Parameters and response schemas are in the Movement API reference. Availability and access are subject to the product and your account.