agentsclimarketplace

Market breadth analyzer

Skill mahmoud20138/Tradecraft/plugins/tradecraft/skills/market-breadth-analyzer

Market breadth — how many pairs trending vs ranging, overall market health, breadth divergence. Use for "market breadth, breadth scan, market health, how many trending, broad market, pairs trending", or any related query. Works with trading-brain and relevant analysis/strategy skills.From its SKILL.md

Install
npx -y skills add mahmoud20138/Tradecraft --skill market-breadth-analyzer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 18 stars18 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.9 KB, 946 tokens by cl100k_base, as published. Nobody here has run it

Market Breadth Analyzer

import pandas as pd, numpy as np

class MarketBreadthAnalyzer:
    @staticmethod
    def scan_breadth(pairs_data: dict, trend_threshold: float = 25) -> dict:
        trending_up = []; trending_down = []; ranging = []
        for sym, df in pairs_data.items():
            if df.empty or len(df) < 50: continue
            close = df["close"]
            ema50 = close.ewm(span=50).mean().iloc[-1]
            plus_dm = df["high"].diff().clip(lower=0).rolling(14).mean()
            minus_dm = (-df["low"].diff()).clip(lower=0).rolling(14).mean()
            atr = (df["high"] - df["low"]).rolling(14).mean()
            dx = abs(plus_dm - minus_dm) / (plus_dm + minus_dm + 1e-10) * 100
            adx = dx.rolling(14).mean().iloc[-1]
            if adx > trend_threshold and close.iloc[-1] > ema50: trending_up.append(sym)
            elif adx > trend_threshold and close.iloc[-1] < ema50: trending_down.append(sym)
            else: ranging.append(sym)
        total = len(trending_up) + len(trending_down) + len(ranging)
        return {
            "trending_up": trending_up, "trending_down": trending_down, "ranging": ranging,
            "breadth_score": round((len(trending_up) - len(trending_down)) / max(total, 1) * 100, 1),
            "pct_trending": round((len(trending_up) + len(trending_down)) / max(total, 1) * 100, 1),
            "market_mode": "TRENDING" if len(trending_up) + len(trending_down) > len(ranging) else "RANGE-BOUND",
            "bias": "RISK-ON" if len(trending_up) > len(trending_down) * 1.5 else "RISK-OFF" if len(trending_down) > len(trending_up) * 1.5 else "MIXED",
        }

    @staticmethod
    def breadth_divergence(breadth_history: list[dict], index_prices: list[float]) -> dict:
        """Detect divergence between breadth and price index."""
        if len(breadth_history) < 5 or len(index_prices) < 5:
            return {"divergence": "INSUFFICIENT_DATA"}
        recent_breadth = [b["breadth_score"] for b in breadth_history[-5:]]
        breadth_trend = recent_breadth[-1] - recent_breadth[0]
        price_trend = index_prices[-1] - index_prices[0]
        if price_trend > 0 and breadth_trend < -10:
            return {"divergence": "BEARISH", "signal": "Price rising but fewer pairs trending up — rally weakening"}
        elif price_trend < 0 and breadth_trend > 10:
            return {"divergence": "BULLISH", "signal": "Price falling but more pairs turning up — selloff exhausting"}
        return {"divergence": "NONE", "signal": "Breadth confirms price action"}

Interpretation Guide

Breadth ScoreMarket ModeStrategy Implication
> +60Strong risk-onTrend-following, momentum strategies
+20 to +60Moderate bullishSelective breakouts, reduced position size
-20 to +20Mixed/neutralMean reversion, range strategies
-60 to -20Moderate bearishShort setups, defensive positioning
< -60Strong risk-offCounter-trend caution, hedge existing longs

Usage

breadth = MarketBreadthAnalyzer.scan_breadth(pairs_data)
print(f"Market: {breadth['market_mode']} | Bias: {breadth['bias']} | {breadth['pct_trending']}% trending")

div = MarketBreadthAnalyzer.breadth_divergence(breadth_history, dxy_prices)
if div["divergence"] != "NONE":
    print(f"WARNING: {div['divergence']} divergence — {div['signal']}")

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 610,677. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.