Crypto Market Breadth — Advance/Decline Ratio and Risk Signal

What does Crypto Market Breadth do?

Crypto Market Breadth is the cryptocurrency equivalent of the NYSE advance/decline line — a real-time market internals indicator that scans all 690+ Binance USDT spot pairs and computes how many coins are rising versus falling. The result is a breadth score from -100 to +100, an advance/decline ratio, volume-weighted price change, sector rotation breakdown, and a crisp RISK_ON / RISK_OFF signal. It is the fastest way to know whether a crypto price move has broad market participation or is driven by a handful of large-caps masking underlying weakness.

Why use Crypto Market Breadth?

• Market internals at a glance — the breadth_score and market_state label give you a one-number answer to "is the market healthy right now?" without reading 690 individual tickers.
• Catch divergences early — when BTC is up but the ad_ratio is below 1.0, the rally lacks breadth. This actor surfaces that divergence before it appears in price-only charts.
• Sector rotation visibility — built-in sector groupings (Layer 1, Layer 2, DeFi, AI, gaming, meme, exchange, infra) show which sectors are leading and which are lagging, enabling informed rotation decisions.
• Volume-weighted signal quality — vol_weighted_change_pct weights each coin's move by its 24-hour trading volume, so large-caps with genuine price discovery carry more weight than low-liquidity tokens.
• McClellan oscillator proxy — mcclellan_proxy tracks whether breadth is expanding or contracting relative to total listings, giving a momentum signal for market internals.

How to use Crypto Market Breadth

1. Go to the Apify Store and open Crypto Market Breadth.
2. Click Try for free — no input configuration is required.
3. Click Start. The actor screens 690+ pairs via the Binance API and completes in under 20 seconds.
4. Read the breadth_summary record for the aggregate signal, then check top_gainers and top_losers for the individual leaders.
5. Schedule every 15 or 30 minutes to build a time-series breadth chart for your trading dashboard.

Input

No required inputs. The actor screens all active Binance USDT pairs automatically.

Field	Type	Default	Description
(none required)	—	—	Actor runs with zero configuration

Output

[
  {
    "record_type": "breadth_summary",
    "breadth_score": 42.1,
    "ad_ratio": 2.18,
    "market_state": "RISK_ON",
    "total_pairs": 693,
    "gainers": 421,
    "losers": 193,
    "flat": 79,
    "strong_gain_5pct_plus": 112,
    "gain_1_to_5pct": 309,
    "flat_neg1_to_1pct": 79,
    "loss_neg5_to_neg1pct": 158,
    "strong_loss_5pct_plus": 35,
    "vol_weighted_change_pct": 2.84,
    "near_24h_high_count": 88,
    "near_24h_low_count": 14,
    "composite_breadth_score": 71,
    "mcclellan_proxy": 32.8,
    "sector_breadth": {
      "layer1": {"gainers": 8, "losers": 2, "state": "RISK_ON"},
      "defi": {"gainers": 7, "losers": 4, "state": "MILDLY_BULLISH"},
      "ai": {"gainers": 5, "losers": 3, "state": "MILDLY_BULLISH"}
    },
    "fetched_at": "2026-09-02T09:00:00Z"
  },
  {
    "record_type": "top_gainers",
    "items": [
      {"symbol": "WIFUSDT", "change_pct": 18.4, "volume_usdt": 142000000},
      {"symbol": "BONKUSDT", "change_pct": 14.2, "volume_usdt": 98000000}
    ],
    "fetched_at": "2026-09-02T09:00:00Z"
  }
]

Data fields

Field	Description
record_type	breadth_summary, top_gainers, top_losers, or top_volume
breadth_score	Raw breadth score from -100 (all losing) to +100 (all gaining)
ad_ratio	Gainers divided by losers — above 1.0 = net advancing market
market_state	RISK_ON / MILDLY_BULLISH / NEUTRAL / MILDLY_BEARISH / RISK_OFF
total_pairs	Total Binance USDT pairs screened
gainers	Count of pairs with positive 24h change
losers	Count of pairs with negative 24h change
flat	Count of pairs within ±1%
strong_gain_5pct_plus	Pairs surging more than 5%
gain_1_to_5pct	Pairs with healthy 1–5% gain
flat_neg1_to_1pct	Directionless pairs
loss_neg5_to_neg1pct	Pairs in mild pullback
strong_loss_5pct_plus	Pairs falling more than 5%
vol_weighted_change_pct	Volume-weighted average price change across all pairs
near_24h_high_count	Pairs trading within 0.1% of their 24h high
near_24h_low_count	Pairs trading within 0.1% of their 24h low
composite_breadth_score	Composite 0–100 score blending AD ratio, highs/lows, and breadth score
mcclellan_proxy	Simplified McClellan oscillator proxy (positive = expanding breadth)
sector_breadth	Per-sector breakdown with gainers, losers, and state label
items[].symbol	Binance trading pair symbol
items[].change_pct	24-hour price change percentage
items[].volume_usdt	24-hour trading volume in USDT
fetched_at	UTC timestamp of data fetch

Cost estimation

Scenario	Runs	Cost
One-off market snapshot	1 run	$0.005
Every 15 minutes for 24 hours	96 runs	$0.48
Every 15 minutes for 30 days	2,880 runs	$14.40

Pricing is $0.005 flat per run. One PPE event is charged at successful completion regardless of the number of pairs screened.

FAQ

What does the breadth score threshold mean in practice? A breadth_score above +40 (RISK_ON) means more than 60% of all Binance pairs are advancing — broad bullish participation. A score below -40 (RISK_OFF) means the selloff is market-wide, not concentrated. The range between -40 and +40 represents mixed or consolidating conditions. Use these thresholds as confirmation filters rather than standalone entry signals.

Why does the actor exclude stablecoin pairs like USDCUSDT? Stablecoin-to-stablecoin pairs (USDC/USDT, BUSD/USDT, etc.) are filtered from the breadth calculation because their near-zero volatility would artificially inflate the flat bucket and dampen the overall breadth score. The actor maintains an internal exclusion list of known stablecoin pairs to keep the signal clean.

Can I use this to build an automated risk-on/risk-off switching system? Yes. The market_state field is designed for exactly this use case. Run the actor on a schedule, read market_state, and use it as a regime filter — for example, only take long entries when market_state is RISK_ON or MILDLY_BULLISH. The composite_breadth_score (0–100) works well as a continuous signal for more nuanced position sizing.

Disclaimer: Market breadth indicators are analytical tools, not trade signals. A RISK_ON reading does not guarantee continued upside, and a RISK_OFF reading does not guarantee that losses will continue. This actor provides data for informational purposes only and does not constitute financial advice. Cryptocurrency markets are highly volatile; always conduct your own research and risk management.

Keywords: crypto market breadth, advance decline ratio, bullish percentage indicator, market internals crypto, Binance spot pairs breadth, risk-on risk-off signal, crypto breadth score, McClellan oscillator crypto, sector rotation crypto, cryptocurrency market health

---

Related actors

• CoinMarketCap Global Metrics — BTC dominance and total market cap to contextualize breadth signal direction
• Crypto Category Screener — 738 sector rankings to see which categories are leading the advance/decline
• Altcoin Season Index — 90-day BTC-relative performance to pair with real-time breadth readings

Feedback

If this actor powers your market analysis, a review helps others find it: Leave a review on Apify Store