Read Weinstein Stages
Stan Weinstein splits a stock's cycle into four stages: a base (1), an advance (2), a top (3) and a decline (4). scanr.ai classifies every U.S. stock into a stage and sub-stage each week, counts the weeks it has been there, and measures its Mansfield relative strength against the S&P 500.
This guide reads a stock's stage history, finds stocks by stage with a scan, and does both from an AI assistant.
You'll need: an API token, which every API plan (Starter and up) includes. Stage history, the Stage filter and the Mansfield RS sort are on every plan.
How the reading works
- It is weekly. Each reading is the last completed week's, so it changes once a week, after Friday's close. A scan run on Tuesday and again on Thursday sees the same stages.
- Stages follow the 30-week moving average: 1 is a flat average after a decline, 2 is price above a rising average, 3 is a flat average after an advance, 4 is price below a falling average.
- Sub-stages split stages 2 and 4:
1 and 3 have no sub-stages; their sub-stage is the stage itself.
- Mansfield RS is ((close ÷ S&P 500) ÷ its 52-week average − 1) × 100. Above 0, the stock is beating the index by more than it usually does. It is centered on 0 and unbounded, not a 1–99 percentile like relative strength.
GET /api/v2/scan/stage-vocabulary serves this list (labels, descriptions and the wire values) so you don't have to hard-code it.
1. A stock's stage history
GET /api/v2/stocks/stage-history returns the weekly readings, oldest first: usually one point per completed week. A week whose sessions disagree, such as one with a split, spans several points with the same week_ending. Narrow it with from and to (YYYY-MM-DD, sessions); omit both for the stock's whole history.
The newest point is the current reading. To find the breakout weeks in a history, keep the points whose sub_stage is 2A.
Read the nulls as absences. A point with a null stage has no reading that week: the stock's first 30 weeks, the weeks after a long gap in trading or a split. Don't carry the previous week's stage into it. mansfield_rs is independent of stage, so either can be null without the other.
ready: false means the server is still building its copy of the history. weeks is then empty, which says nothing about the stock; try again later. ETFs and funds have no stage and answer ready: true with no weeks. Breadth symbols and non-U.S. listings answer 422.
2. Find stocks by stage
To find stocks in a stage, scan with a Stage filter. It is a list on a filter group, like the other categories:
This is scanr.ai's Stage 2A breakouts preset: stocks in the first week of an advance, with at least $10M a day of average dollar volume, strongest Mansfield RS first. Run it with POST /api/v2/scan as {"instructions": <payload>}, or send "stocks in a Stage 2A breakout, sorted by Mansfield RS" to /scan/natural for the payload.
Each entry in Stage takes:
An entry needs at least one stage, weeks or RS condition. Every field set on one entry must hold in the same week; add a second entry to ask about a different week.
Stages and SubStages on one entry must both hold
{"Stages": [1], "SubStages": ["2A"]} asks for a stock that is in Stage 1 and in 2A, which matches nothing. To keep a mix, list sub-stages only: "all of Stage 2, or a 4A breakdown" is {"SubStages": ["2A", "2", "2-", "2B", "2B-", "4A"]}.
Early in an advance and already leading
Stage 2 for at most 8 weeks, beating the index:
Breakouts from the last month
Within lets the 2A week fall anywhere in the last 20 sessions:
Drop declining stocks from any scan
Add an Exclude group that matches Stage 4, beside your All groups, so every stock in a decline is dropped:
Show each match's stage
A scan returns tickers, not rows. Save the payload above as stage-2a.json, run it, and read the current stage of the top matches from step 1's endpoint:
3. From an AI assistant
Over the MCP server, the stage_history tool returns the same points as step 1. It takes ticker, optional from and to, and limit (the newest 1–520 weeks, default 52, about a year); omitted_older_weeks counts the older weeks it left out. Ask "what stage is XMPL in, and when did it break out?" and the assistant calls it.
To find stocks by stage, the assistant calls natural_scan with the screen, then scan with the payload, as for any other scan. See Build a Scanning Agent.
Reading stages well
- Run stage scans after Friday's close. The reading doesn't move during the week, so a mid-week run returns last week's list.
- Prefer sub-stages to whole stages for a new trend. Stage 2 alone holds every advancing stock, early and late;
2A, or Stage 2 withMaxWeeksInStage, finds the new ones. - Sort breakouts by Mansfield RS. Weinstein's checklist favors the strongest stocks in the strongest groups.
