BTC Dominance Trend API

Bitcoin dominance trends across micro, meso, and macro timeframes — reflects capital rotation and risk appetite in crypto.

Webhook URL

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

Description

Tracks the evolution of Bitcoin's dominance — the percentage of total crypto market capitalization held by BTC. This metric reflects capital rotation and investor risk preference: rising dominance suggests a shift toward Bitcoin (risk-off), while falling dominance indicates increased speculative appetite for altcoins (risk-on).

What this endpoint provides

A multi-timeframe analysis of BTC dominance with micro (short-term), meso (medium-term), and macro (long-term) trends, as well as derived fields that describe the dominant regime and trend behavior. The endpoint includes both quantitative deltas and qualitative labels, allowing automations and AI agents to interpret market positioning at a glance.

Response fields

value

Current BTC dominance as a percentage of total crypto market capitalization.

delta_3d, delta_30d, delta_90d

Percentage point changes in dominance over 3, 30, and 90 days.

micro_trend, meso_trend, macro_trend

Trend direction at different time scales (up, down, or flat).

trend

Overall consolidated directional assessment (bullish, bearish, or neutral).

momentum_state

Indicates the strength or evolution of the current move (accelerating, transitioning, decelerating).

trend_pattern

Descriptive label summarizing the current configuration (e.g. strong uptrend, sideways, reversal forming).

major_trend_shifts

Count of significant reversals detected within the analysis window.

last_trend_dir

Direction of the most recent completed dominance trend (up or down).

last_trend_length

Duration of the last completed dominance phase (in weeks).

highest_in_period / lowest_in_period

Range extremes within the observation period.

regime

Interpreted market state based on dominance behavior (risk-on, risk-off, or variants like strong risk-off).

timestamp

UTC time when the metric was last updated.

Output example

[
  {
    "indicator": "btc_dominance_trend",
    "timestamp": "2025-11-01T02:16:00.544Z",
    "value": 56.68,
    "delta_3d": -0.28,
    "delta_30d": 0.07,
    "delta_90d": 0.53,
    "micro_trend": "down",
    "meso_trend": "flat",
    "macro_trend": "up",
    "trend": "bullish",
    "momentum_state": "transitioning",
    "trend_pattern": "strong uptrend",
    "major_trend_shifts": 1,
    "last_trend_dir": "up",
    "last_trend_length": 3,
    "highest_in_period": 57.4,
    "lowest_in_period": 55.49,
    "regime": "strong risk-off"
  }
]

Interpretation & Use

BTC dominance reflects capital rotation and risk appetite within the crypto ecosystem. A rising dominance trend typically marks risk-off conditions, with capital consolidating into Bitcoin during uncertainty. A falling dominance signals risk-on behavior, as traders rotate into altcoins seeking higher returns. The macro_trend, momentum_state, and regime fields allow automations to identify when dominance is strengthening, plateauing, or reversing — useful for constructing strategies that adapt to market sentiment (e.g., altcoin accumulation during risk-on phases or defensive posture during strong risk-off regimes).