BTC Price Trend API

Bitcoin price trend across multiple timeframes — quick directional pulse check for short- to medium-term momentum.

Webhook URL

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

Description

Summarizes Bitcoin's short- to medium-term price direction and momentum across multiple timeframes. It provides a clear, pre-interpreted view of whether BTC is trending up, down, or moving sideways — helping automations and AI agents quickly identify if market action is directional or neutral.

What this endpoint provides

A multi-timeframe breakdown of Bitcoin's percentage changes and trend states, including qualitative fields (trend, momentum_state, interpretation) that express the underlying price behavior in plain language. This indicator is designed to be used as a quick contextual reference for trend reasoning or short-term bias detection.

Response fields

value

Latest BTC price in USD.

delta_7d, delta_30d, delta_60d

Percentage changes over 7, 30, and 60 days.

trend_7d, trend_30d, trend_60d

Directional trend classification per timeframe (up, down, or flat).

trend

Consolidated directional assessment across all timeframes (bullish, bearish, neutral).

momentum_state

Describes whether momentum is building, fading, or stable (accelerating, decelerating, stable).

interpretation

Textual description of overall price action context (e.g., "Sideways or mixed signals — no clear directional bias.").

summary

Compact preformatted string combining deltas, direction, and interpretation.

timestamp

UTC time when the data was last updated.

Output example

[
  {
    "indicator": "btc_price_trend",
    "timestamp": "2025-11-01T02:24:35.761Z",
    "value": 109701.96,
    "delta_7d": -1.2,
    "delta_30d": -7.54,
    "delta_60d": 0.41,
    "trend_7d": "flat",
    "trend_30d": "down",
    "trend_60d": "flat",
    "trend": "neutral",
    "momentum_state": "stable",
    "interpretation": "Sideways or mixed signals — no clear directional bias.",
    "summary": "BTC flat -1.2% (7d) | down -7.5% (30d) | flat 0.4% (60d) | Sideways or mixed signals — no clear directional bias."
  }
]

Interpretation & Use

The BTC price trend acts as a directional pulse check. Multiple up trends across timeframes → strengthening bullish bias. Multiple down trends → clear bearish alignment. Mixed or flat trends → consolidation or indecision. Automations can use trend or interpretation directly to set directional bias (e.g., "stay neutral" when trend = neutral), or feed summary into LLMs to provide succinct, human-readable context about current market momentum.