Halving Cycle API

Bitcoin halving cycle tracker — shows current position within the 4-year emission cycle and typical market phase (accumulation, expansion, late bull).

Webhook URL

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

Description

Tracks Bitcoin's position within its current halving cycle — the four-year emission schedule that reduces block rewards by 50% roughly every 210,000 blocks. Halvings are among the most influential structural events in Bitcoin's macro cycles, often marking transitions between accumulation, expansion, and distribution phases.

What this endpoint provides

A real-time snapshot of Bitcoin's halving progress, showing how far the network is from the next halving event and providing a qualitative label describing the typical market phase associated with that point in the cycle.

Response fields

current_block

Current Bitcoin block height.

current_halving_number

The current halving epoch (e.g., 4 = post-2024 halving).

progress_pct

Percentage of completion through the current halving cycle.

next_halving_estimated_date

Estimated calendar date of the next halving event.

blocks_remaining

Number of blocks left until the next halving.

days_remaining

Approximate number of days remaining until the next halving.

typical_cycle_phase

Typical market phase associated with the current progress (accumulation, expansion, late bull, etc.).

Output example

[
  {
    "indicator": "halving_cycle",
    "timestamp": "2025-11-01T03:16:06.220Z",
    "current_block": 921706,
    "current_halving_number": 4,
    "progress_pct": 38.9,
    "next_halving_estimated_date": "2028-04-10",
    "blocks_remaining": 128294,
    "days_remaining": 891,
    "typical_cycle_phase": "🟡 Expansion / Early Bull"
  }
]

Interpretation & Use

The halving_cycle indicator contextualizes Bitcoin's long-term phase within its emission schedule: • **0–25% progress** → Post-halving accumulation / early recovery. • **25–60% progress** → Expansion / early bull market phase. • **60–90% progress** → Mature bull or late cycle optimism. • **>90% progress** → Pre-halving cooldown or late-cycle transition. Automations can use progress_pct or typical_cycle_phase to infer macro positioning — especially when combined with structural indicators such as MA50/MA200 Trend or valuation models like Stock-to-Flow.