Which Regime Decides Whether You Should Be Long at All?

Most regime signals tell you how to trade the next few hours — squeeze, cascade, funding extreme. None of them tell you whether the tide is coming in or going out. That answer lives in a slower, structural layer most bots ignore until they get run over by it.

We call that layer the directional backdrop: the months-to-weeks posture that sets the regime everything faster trades inside of. A 200MA reclaim means something different in a structural bull than in a bleeding bear. The fast signal is identical; the backdrop is what makes it tradable.

Three regimes make up that backdrop, and they nest by timescale: #1 Macro Trend (months), #2 BTC Cycle (weeks-months), and #6 Macro Correlation (days-weeks). They are regimes #1, #2 and #6 of 14 in the regime taxonomy. This post is the hub — it shows how they fit together and points to the deep dives.

The Three Layers of the Directional Backdrop

Each layer answers a different question at a different speed. Read them top-down: the slow layer gates the medium layer, which gates the fast one. Mismatches between them are where the highest-conviction setups — and the worst traps — live.

RegimeTimescaleWhat it measuresEndpoint
#1 Macro Trend1–6 monthsStructural posture: HH/HL vs LH/LL, aggregate funding, BTC dominance flow/market + funding/OI feeds
#2 BTC CycleWeeks–monthsHalving supply shocks, miner flows, dominance rotations/market-intelligence/btc/cycle-indicators
#6 Macro CorrelationDays–weeksCrypto as high-beta tech: equities, DXY, gold, treasury yields/sentiment/macro

The faster regimes — squeeze, liquidation cascade, funding reset — all assume you already know which of these three states you are in. That is why we bundle them: they are the floor the rest of the 14-regime framework stands on.

Regime #1: Macro Trend — The Broadest Posture

Macro Trend is the slowest and broadest backdrop, with a 1–6 month duration. It does not fire entries; it tells your bot what kind of market it is operating in, so every downstream filter inherits the right bias.

It resolves into six structural baskets, each with a clear posture:

The inputs — aggregate funding, open interest, and BTC dominance — come from the same derivatives and market-health feeds that power /market. The backdrop is a synthesis you compute on top of them, refreshed on a slow cadence because structure does not flip intraday.

Regime #2: BTC Cycle — Halvings, Miners & Dominance

Bitcoin has its own clock that does not always track the broader market. Halving supply shocks, miner sell pressure, and dominance rotations move on a weeks-to-months cycle that is tradeable independently of alts. That is regime #2.

The /market-intelligence/btc/cycle-indicators endpoint returns all eight on-chain cycle indicators in one call. The response wraps them as {"indicators": {...}, "available": [...]}, where available lists every indicator key present:

curl -H "X-API-Key: cdk_live_yourkey" \
  "https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators?days=1"

A trimmed response:

{
  "available": [
    "puell_multiple", "stock_to_flow", "pi_cycle_top",
    "golden_ratio", "rainbow_chart", "two_year_ma",
    "two_hundred_week_ma", "ahr999"
  ],
  "indicators": {
    "puell_multiple": [{"date": "2026-06-10", "value": 0.92}],
    "pi_cycle_top": [{"date": "2026-06-10", "signal": false}]
  }
}

The days query param trims each indicator's history (default 30, days=0 returns the full series). For a single indicator, hit /btc/cycle-indicators/{indicator} — valid names match the available list. Cycle baskets include BTC Solo Bull Run, Pre-Halving Ramp, Post-Halving Lag, and BTC Risk-Off Sell.

The full indicator-by-indicator breakdown — Puell Multiple, Stock-to-Flow, Pi Cycle Top and the rest — lives in the BTC cycle indicators deep dive.

Regime #6: Macro Correlation — Crypto as High-Beta Tech

On a days-to-weeks horizon, crypto increasingly trades as a high-beta tech asset. When macro drives the tape, BTC follows the Nasdaq, the dollar suppresses risk, and gold flags monetary fear. Regime #6 captures that external pull.

The /sentiment/macro endpoint returns the traditional-market inputs your bot needs to read the risk environment, all in one call:

curl -H "X-API-Key: cdk_live_yourkey" \
  "https://cryptodataapi.com/api/v1/sentiment/macro"
{
  "eur_usd_latest": 1.0824,
  "eur_usd_30d_change_pct": 1.42,
  "eur_usd_7d_change_pct": 0.31,
  "gold_price_usd": 2841.50,
  "treasury_yield": 4.18
}

Read these as a dollar-and-rates risk gauge. A rising eur_usd_30d_change_pct means a weakening dollar (risk-on for crypto); a falling value means DXY strength (risk-off). A treasury_yield under ~3.5% is bullish for risk assets; above ~5.0% is a headwind. Elevated gold_price_usd signals safe-haven demand.

The macro baskets — Risk-Off (Equities Sell), Risk-On (Equities Rally), Dollar Strength (DXY Spike), and Gold/Copper Ratio Shift — map directly onto these fields. The scoring logic that turns them into a risk-on / risk-off label is walked through in the macro correlation deep dive.

Wiring All Three Into One Backdrop Read

The value of bundling these is a single, cheap read your faster strategies can gate on. Pull all three, collapse them into one posture object, and pass it down as context. Two requests cover the cycle and macro layers:

import httpx

HDR = {"X-API-Key": "cdk_live_yourkey"}
BASE = "https://cryptodataapi.com/api/v1"

def directional_backdrop():
    cycle = httpx.get(
        f"{BASE}/market-intelligence/btc/cycle-indicators",
        headers=HDR, params={"days": 1},
    ).json()
    macro = httpx.get(
        f"{BASE}/sentiment/macro", headers=HDR,
    ).json()

    # Macro Correlation (regime #6): dollar + rates risk gauge
    dollar_weak = macro["eur_usd_30d_change_pct"] > 1
    rates_easy = macro["treasury_yield"] < 3.5
    risk_on = dollar_weak and rates_easy

    # BTC Cycle (regime #2): is a top signal firing?
    pi = cycle["indicators"].get("pi_cycle_top", [{}])[-1]
    cycle_top = pi.get("signal", False)

    return {
        "risk_environment": "risk_on" if risk_on else "risk_off",
        "cycle_top_warning": cycle_top,
        "gold": macro["gold_price_usd"],
    }

Now any faster strategy can ask one question before it fires: does my signal agree with the backdrop? A breakout long in a risk_off environment with a cycle_top_warning is exactly the trade you skip.

When to Reach for the Directional Backdrop

This bundle is not a trigger layer — it almost never tells you to enter. It tells you what to allow. Reach for it in three situations:

Read it slow — these regimes move on weeks and months, so polling every few minutes wastes calls and invites noise. Pull #1, #2 and #6 a few times a day, cache the posture, and gate your fast strategies on it. For the full picture of how the backdrop nests under the faster regimes, see the regime taxonomy and the 14-regime framework.