BTC Swing History 1Y API

Bitcoin daily swing log over ~1 year — fractal highs and lows filtered to moves of 6% or more.

API URL

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

Description

Reads Binance BTCUSDT daily candles (last 365) and marks Williams-style fractals (2 bars left and right). Consecutive pivots of the same type collapse to the more extreme print, then swings smaller than 6% are dropped so the log is usable as narrative structure rather than noise.

What this endpoint provides

A time-ordered list of qualifying HIGH/LOW swings, the last swing, and a structure hint (last_pivot_high / last_pivot_low). Refreshed daily after the Binance 1d close (00:30 UTC).

Response fields

as_of

UTC calendar date when the snapshot was computed.

symbol

Always BTCUSDT.

current_close

Close of the latest daily candle in the window.

swing_settings

Fractal width (left/right) and minimum move (0.06 = 6%).

swings

Every qualifying pivot in the one-year window, oldest first: date, type (HIGH/LOW), price, signed move_pct_from_prev.

structure_hint

last_pivot_high, last_pivot_low, or unknown when fewer than two swings remain.

last_swing

Date, type, and price of the most recent qualifying swing, or null.

summary

One-line read of the last swing and structure hint.

timestamp

UTC time of the latest update.

Output example

[
  {
    "indicator": "btc_swing_history_1y",
    "timestamp": "2026-09-22T00:30:00.000Z",
    "as_of": "2026-09-22",
    "symbol": "BTCUSDT",
    "current_close": 112450,
    "swing_settings": {
      "left": 2,
      "right": 2,
      "min_move_pct": 0.06
    },
    "swings": [
      {
        "date": "2026-04-07",
        "type": "LOW",
        "price": 74500,
        "move_pct_from_prev": null
      },
      {
        "date": "2026-07-14",
        "type": "HIGH",
        "price": 123200,
        "move_pct_from_prev": 65.37
      }
    ],
    "structure_hint": "last_pivot_high",
    "last_swing": {
      "date": "2026-07-14",
      "type": "HIGH",
      "price": 123200
    },
    "summary": "BTC 1y swings: last HIGH at 123200 on 2026-07-14 (last_pivot_high)."
  }
]

Interpretation & Use

A last_pivot_high means the latest qualifying turn was a peak; last_pivot_low is a trough. The swings array is the story for an LLM or a sheet — not a trade signal by itself. Moves under 6% never enter the log, so the sequence is coarser than raw daily fractals.