BTC Overview API

Compact Bitcoin technical overview combining price, momentum, volatility, and moving average signals in one snapshot.

Webhook URL

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

Description

Provides a compact technical overview of Bitcoin's current market state — combining price, momentum, volatility, and moving average signals into one digestible snapshot. It's designed to give automations and AI agents a quick, structured understanding of short-term trend and risk conditions.

What this endpoint provides

A set of real-time Bitcoin metrics normalized for decision-making, including price level, momentum (RSI), volatility, and position relative to key exponential moving averages. It includes a human-readable summary for quick context injection into LLMs or reasoning pipelines.

Response fields

btc_price_usd

Current Bitcoin price in USD.

change_7d_pct

Percentage change over the last 7 days.

ema_50 / ema_200

50-day and 200-day exponential moving averages, key indicators for short- and long-term trend direction.

rsi_14

14-period Relative Strength Index (momentum oscillator).

vol_30d

30-day realized volatility (expressed as a decimal).

trend

Relative trend condition, such as above_ema_200, below_ema_50, or neutral.

summary

Pre-formatted text interpretation summarizing market state (price, RSI, volatility, and trend).

timestamp

UTC time when data was last updated.

Output example

[
  {
    "indicator": "btc_overview",
    "btc_price_usd": 109393.21,
    "change_7d_pct": -2.04,
    "ema_50": 112784.78,
    "ema_200": 109234.6,
    "rsi_14": 55.2,
    "vol_30d": 0.408,
    "trend": "above_ema_200",
    "summary": "BTC $109,393 (-2.0% 7d) | RSI 55 | Vol 0.41 | above ema 200",
    "timestamp": "2025-11-01T01:17:27.872Z"
  }
]

Interpretation & Use

This endpoint acts as a "health check" for Bitcoin's short-term trend. Above EMA 200 → long-term uptrend, macro support intact. RSI around 50–60 → neutral-to-bullish momentum. Volatility (vol_30d) helps gauge risk: higher values imply more uncertainty, lower values suggest stability. Automations can use the trend field or summary directly to interpret the market phase (e.g., "bullish continuation" vs. "cooling off"), feed context to LLMs, or condition higher-level strategies on BTC regime changes.