market-top-detector

Market top detection works by quantifying six components—distribution days, leading-stock health, breadth divergence, defensive rotation, index technicals, and sentiment—into a composite score. The framework generates a detailed JSON and Markdown report for 2-8 week tactical timing signals.

The best way to detect market-top risk is applying a phase-driven workflow that collects data from the FMP API and CLI inputs, scores the six components, and compares results to historical tops. It includes what-if scenarios and follow-through-day detection to support risk management decisions.

Generate a market-top risk report by running the detector with an FMP API key and required CLI inputs. The workflow scores distribution days, breadth divergence, leading-stock health, defensive rotation, index technicals, and sentiment, outputting both JSON and Markdown formats.

Yes, you need an FMP API key to run the market top detector. The phase-driven workflow requires the FMP API for data collection alongside CLI inputs to score the six components and generate the composite market-top risk report.

Yes, you can test what-if scenarios and follow-through-day signals for market-top risk management. The framework generates scenario comparisons against historical tops and detects follow-through days to support tactical decision-making within a 2-8 week timing window.