Altcoin Rotation Radar API

High-level snapshot of how capital is rotating across the crypto market — showing whether dominance currently lies with Bitcoin, Ethereum, or the broader altcoin sector.

Webhook URL

https://api.hunchmachine.com/webhook/indicators?indicator=altcoin_rotation_radar&api_key=YOUR_API_KEY

Description

The Altcoin Rotation Radar provides a high-level snapshot of how capital is rotating across the crypto market — showing whether dominance currently lies with Bitcoin, Ethereum, or the broader altcoin sector. It interprets 30–90-day smoothed momentum trends in BTC dominance and ETH/BTC strength, combined with the performance breadth of the top altcoins, to classify the market's current rotational phase.

What this endpoint provides

A concise, interpretable summary of where liquidity and leadership reside in the crypto ecosystem. It identifies whether the market is BTC-led, in early ETH rotation, or already entering a broader altcoin season — while also providing short contextual notes for dashboards, alerts, or AI-driven automations.

Response fields

indicator

Name of the indicator — "altcoin_rotation_radar".

timestamp

UTC timestamp of the latest data snapshot.

btc_dom_delta_smooth

Smoothed 30–90 day rate-of-change in Bitcoin market dominance (%). Positive = BTC gaining dominance.

ethbtc_delta_smooth

Smoothed 30–90 day momentum of the ETH/BTC ratio (%). Positive = ETH gaining strength relative to BTC.

breadth_pct

Percentage of the top altcoins outperforming BTC over the last 30 days — a measure of how widespread rotation is.

phase

Detected macro rotation phase: btc_led, eth_rotation, early_altseason, full_altseason, or neutral.

context

Secondary qualifier when phase = neutral: btc_dominant, eth_stabilizing, sideways_consolidation, or mixed.

summary

Short natural-language interpretation of the current structure.

note

Compact explanation of what ΔSmooth and Breadth represent — useful for tooltips or inline documentation.

Output example

[
  {
    "indicator": "altcoin_rotation_radar",
    "timestamp": "2025-11-08T17:54:50.143Z",
    "btc_dom_delta_smooth": 0.63,
    "ethbtc_delta_smooth": -5.81,
    "breadth_pct": 40,
    "phase": "neutral",
    "context": "btc_dominant",
    "summary": "BTC remains slightly dominant; rotation paused.",
    "note": "ΔSmooth shows 30–90d momentum trends in BTC dominance and ETH/BTC ratio; Breadth = % of alts outperforming BTC."
  }
]

Interpretation & Use

The radar acts as a cycle-aware map of crypto capital flow:

• **BTC-Led** → Capital concentrated in BTC; ETH and alts lag. Rotation has not yet begun.

• **ETH Rotation** → ETH starts gaining vs BTC; early stage of capital rotation.

• **Early Altseason** → Mid-cap alts join the rally — rotation broadens across the market.

• **Full Altseason** → Broad speculative phase where most alts outperform BTC and ETH.

• **Neutral / Mixed** → No clear rotation pattern; market consolidating or transitioning.

Use this endpoint to determine where we are in the altcoin cycle, trigger automation conditions (e.g., enable "altseason" strategies when phase = early_altseason or full_altseason), or feed AI agents that summarize market structure in plain language.