菜单
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}