القائمة
Measure US equity market breadth using advance/decline lines, percentage of stocks above moving averages, and new highs/lows via the Finskills API.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | market-breadth-analyzer |
| version | 1.0.2 |
| description | Measure US equity market breadth using advance/decline lines, percentage of stocks above moving averages, and new highs/lows via the Finskills API. |
| author | finskills |
| metadata | {"openclaw":{"requires":{"env":["FINSKILLS_API_KEY"]},"primaryEnv":"FINSKILLS_API_KEY"},"homepage":"https://github.com/finskills/market-breadth-analyzer"} |
Assess internal market health and regime using breadth indicators from the Finskills API: advance/decline data, percentage of stocks above key moving averages, new highs vs. new lows, and short volume. Identify divergences between index price action and underlying breadth — the most reliable early warning system for market tops and bottoms.
API Key required — Register at https://finskills.net to get your free key.
Header: X-API-Key: <your_api_key>
Get your API key: Register at https://finskills.net — free tier available, Pro plan unlocks real-time quotes, history, and financials.
Activate when the user:
GET https://finskills.net/v1/free/market/breadth
Extract:
advancers: number of stocks advancingdecliners: number of stocks decliningunchanged: number of stocks flatnew52wHigh: stocks hitting 52-week highsnew52wLow: stocks hitting 52-week lowspctAbove200MA: % of S&P 500 stocks trading above 200-day MApctAbove50MA: % of S&P 500 stocks trading above 50-day MAadvanceVolume: volume in advancing stocksdeclineVolume: volume in declining stocksGET https://finskills.net/v1/market/summary
Extract: S&P 500 and Nasdaq current level, daily change, YTD performance
GET https://finskills.net/v1/free/market/short-volume-top
Extract: list of most heavily shorted stocks today (ratio of short vol to total vol)
Advance/Decline Ratio (ADR):
ADR = advancers / decliners
| ADR | Signal |
|---|---|
| > 3.0 | Strong breadth — broad rally |
| 1.5–3.0 | Good breadth — healthy market |
| 0.75–1.5 | Mixed breadth — selective market |
| 0.25–0.75 | Weak breadth — narrow or declining market |
| < 0.25 | Very weak breadth — broad selloff |
Volume-Weighted A/D:
Volume A/D = advanceVolume / declineVolume
If Volume ADR > ADR: Distribution (smart money selling into rally) — bearish signal
If Volume ADR < ADR: Accumulation (buying on pullbacks) — bullish signal
Net New Highs/Lows:
Net New Highs = new52wHigh - new52wLow
Classify market health by % of stocks above key moving averages:
% Stocks Above 200-Day MA:
| Level | Market Health |
|---|---|
| > 70% | Bull market — broad participation |
| 50–70% | Moderate — mixed conditions |
| 30–50% | Weakening — selective market |
| < 30% | Bear market conditions |
% Stocks Above 50-Day MA:
Bullish Divergence (oversold bounce setup):
Bearish Divergence (distribution signal):
Participation Narrowing: Calculate the ratio:
Narrowness Index = (leaders outperforming SPY with > 5% weight) / total S&P 500 constituents
If < 10 stocks are driving most of the index return, flag as "narrow rally" with high reversal risk.
Top heavily-shorted stocks signal areas of market stress:
Score each dimension and compute composite:
| Dimension | Score (1–5) |
|---|---|
| ADR (daily) | 5=very strong, 1=very weak |
| NetNewHighs | 5=expanding, 1=contracting |
| % > 200MA | 5= > 70%, 1= < 30% |
| % > 50MA | 5= > 65%, 1= < 35% |
| Vol. A/D Confirm | 5=confirmed, 3=neutral, 1=diverging |
Market Health Score = avg of 5 dimensions (scale 1–5)
╔══════════════════════════════════════════════════════╗
║ MARKET BREADTH REPORT — {DATE} ║
╚══════════════════════════════════════════════════════╝
📊 MARKET INDEXES
S&P 500: {level} {change}% YTD: {ytd}%
Nasdaq: {level} {change}% YTD: {ytd}%
Russell: {level} {change}% YTD: {ytd}%
🩺 MARKET HEALTH SCORE: {X}/5 → {HEALTHY / MODERATE / WEAKENING / UNHEALTHY}
📈 BREADTH DASHBOARD
Advancers / Decliners: {adv} / {dec} (ADR: {ratio} — {Strong/Weak/Mixed})
Volume Split: {adv_vol}B advancing / {dec_vol}B declining
Volume A/D Ratio: {ratio} [{Accumulation/Distribution}]
New 52-Week Highs: {n}
New 52-Week Lows: {n}
Net New Highs: {+/-n} [{Expanding/Contracting}]
% Stocks > 200-Day MA: {%} [{Bull/Moderate/Bear} zone]
% Stocks > 50-Day MA: {%}
🔍 DIVERGENCE CHECK
Price vs. Breadth: {No divergence / BULLISH divergence / BEARISH divergence ⚠️}
Detail: {Brief explanation of any divergence}
Narrowing Rally Check: {Broad / Narrowing ⚠️}
📊 SHORT INTEREST SIGNALS
Top Heavily Shorted Stocks Today:
{TICKER}: {short_ratio}% short volume
{TICKER}: {short_ratio}% short volume
Signal: {Normal / Elevated stress in {sector}}
🎯 MARKET HEALTH ASSESSMENT
Overall Verdict: {Healthy Bull / Mixed / Weakening / Risk-Off}
Implication for Investors:
✅ {What to do if healthy} OR
⚠️ {What to watch / reduce if weakening}
Key indicator to monitor: {The metric most likely to confirm direction}