PreReason Cross Correlations - BTC vs Macro Correlation Matrix

x402

PreReason Cross Correlations - BTC vs Macro Correlation Matrix is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns a correlation matrix showing how Bitcoin moves relative to SPY, DXY, and bond yields, with cross-asset signal analysis.

Price / call$0.01

Seller volume →—

Success—

StatusUnknown

How this service works

Bitcoin correlation matrix. BTC vs SPY, dollar strength (UUP), Treasury yields, VIX relationship signals. Cross-asset diversification data for portfolio agents.

Output

Returns a structured context string and metrics object describing correlation signals between Bitcoin and key macro assets (SPY, DXY, yields), including trend direction, signal classification (bullish/bearish/neutral), and a confidence score. Includes a generated_at timestamp and briefing identifier.

Example use cases

Example prompt

“Pull the BTC cross-asset correlation briefing from PreReason — I want to see how Bitcoin is moving relative to SPY, DXY, and yields right now, in markdown format.”

Technical details

Endpoint

GEThttps://api.prereason.com/api/cross/correlations?utm_source=zero.xyz

When to prefer

Use this endpoint when you need to understand Bitcoin's directional relationship with traditional macro assets (equities via SPY, the US dollar via DXY, and interest rates via bond yields). Ideal for risk-on/risk-off regime detection, macro-driven BTC positioning, or when building context about whether BTC is behaving as a risk asset or a hedge. Prefer over btc.context (on-chain focused) or btc.momentum (trend-only) when the question is specifically about cross-asset linkages.

Side effects

Invalid date format (must match YYYY-MM-DD pattern) returns validation error
Date out of tier access range (Free tier limited to 30 days, Basic from Jan 2025) returns 403 or empty data
Missing required `briefing` query parameter returns 400
Invalid briefing ID string returns 400 or empty result
Payment not completed via x402 protocol returns 402 Payment Required
Network timeout on downstream data aggregation returns 503

Input

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "format": "json",
      "briefing": "cross.correlations"
    }
  }
}

Schema · Request body

Field	Type	Description
inputrequired	object
output	object

Output

{
  "date": "2026-06-18",
  "_timing": {
    "total_ms": 680,
    "computedAt": "2026-06-18T06:03:00.663Z",
    "metrics_ms": 304,
    "correlations_ms": 376,
    "tier_features_ms": 0
  },
  "metrics": {
    "dxy": {
      "name": "dxy",
      "trend": {
        "momentum": "steady",
        "change_7d": 0.61,
        "direction": "flat",
        "change_30d": 1.84,
        "change_90d": 1.88,
        "percentile": 60,
        "percentile_label": "above average"
      },
      "signal": "below-trend",
      "context": "Dollar strength (UUP) stable at 28.21. Consolidating: neutral dollar backdrop.",
      "timestamp": "2026-06-17T19:44:45+00:00",
      "confidence": 56,
      "regulatory_mode": "descriptive",
      "value_formatted": "28.21",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 100,
        "percentile_score": 0,
        "trend_consistency": 20
      }
    },
    "qqq": {
      "name": "qqq",
      "trend": {
        "momentum": "accelerating",
        "change_7d": 3.67,
        "direction": "rising",
        "change_30d": 2.38,
        "change_90d": 23.94,
        "percentile": 99,
        "percentile_label": "extremely high"
      },
      "signal": "above-trend",
      "context": "Nasdaq 100 (QQQ) at $721.42, +3.7% over 7d, rising. Accelerating tech momentum: risk appetite expanding.",
      "timestamp": "2026-06-17T19:45:07+00:00",
      "confidence": 90,
      "regulatory_mode": "descriptive",
      "value_formatted": "$721.42",
      "confidence_label": "Very High",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 100,
        "percentile_score": 100,
        "trend_consistency": 100
      }
    },
    "spy": {
      "name": "spy",
      "trend": {
        "momentum": "steady",
        "change_7d": 1.76,
        "direction": "flat",
        "change_30d": 0.3,
        "change_90d": 14.09,
        "percentile": 99,
        "percentile_label": "extremely high"
      },
      "signal": "above-trend",
      "context": "S&P 500 (SPY) stable at $739.96. Consolidating: neutral equity backdrop.",
      "timestamp": "2026-06-17T19:45:08+00:00",
      "confidence": 76,
      "regulatory_mode": "descriptive",
      "value_formatted": "$739.96",
      "confidence_label": "High",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 100,
        "percentile_score": 100,
        "trend_consistency": 20
      }
    },
    "vxx": {
      "name": "vxx",
      "trend": {
        "momentum": "accelerating",
        "change_7d": -10.66,
        "direction": "falling",
        "change_30d": -13.53,
        "change_90d": -34.07,
        "percentile": 0,
        "percentile_label": "extremely low"
      },
      "signal": "below-trend",
      "context": "iPath Series B S&P 500 VIX Short-Term Futures ETN (VXX) at $23.72, -10.7% over 7d, falling. Decelerating fear: low risk premium. Note: VXX exhibits structural decay from VIX-futures contango over long holding periods.",
      "timestamp": "2026-06-17T19:45:05+00:00",
      "confidence": 90,
      "regulatory_mode": "descriptive",
      "value_formatted": "$23.72",
      "confidence_label": "Very High",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 100,
        "percentile_score": 100,
        "trend_consistency": 100
      }
    },
    "eur-usd": {
      "name": "eur-usd",
      "trend": {
        "momentum": "steady",
        "change_7d": 0,
        "direction": "flat",
        "change_30d": -0.26,
        "change_90d": -0.12,
        "percentile": 46,
        "percentile_label": "average"
      },
      "signal": "at-trend",
      "context": "EUR/USD stable at 1.1573. Consolidating: FX conditions neutral.",
      "timestamp": "2026-06-12T00:00:00+00:00",
      "confidence": 64,
      "regulatory_mode": "descriptive",
      "value_formatted": "1.16",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 30,
        "signal_strength": 48,
        "percentile_score": 60,
        "trend_consistency": 100
      }
    },
    "hash-ribbon": {
      "name": "hash-ribbon",
      "trend": {
        "momentum": "steady",
        "change_7d": 0,
        "direction": "flat",
        "change_30d": 0,
        "change_90d": -0.04,
        "percentile": 11,
        "percentile_label": "low"
      },
      "signal": "bearish",
      "context": "Hash Ribbon at 0.9869 (bearish, day 9).",
      "timestamp": "2026-06-18T05:05:42.455+00:00",
      "confidence": 69,
      "regulatory_mode": "signal",
      "value_formatted": "0.987",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 44,
        "percentile_score": 97,
        "trend_consistency": 75
      }
    },
    "bitcoin-price": {
      "name": "bitcoin-price",
      "trend": {
        "momentum": "accelerating",
        "change_7d": 3.87,
        "direction": "rising",
        "change_30d": -17,
        "change_90d": -9.42,
        "percentile": 69,
        "percentile_label": "above average"
      },
      "signal": "neutral",
      "context": "BTC at $63,864, up 3.9% over 7d. Accelerating upward - recent gains exceeding longer-term pace",
      "timestamp": "2026-06-18T05:56:22+00:00",
      "confidence": 37,
      "regulatory_mode": "signal",
      "value_formatted": "$63,864",
      "confidence_label": "Low",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 42,
        "percentile_score": 22,
        "trend_consistency": 20
      }
    },
    "net-liquidity": {
      "name": "net-liquidity",
      "trend": {
        "momentum": "steady",
        "change_7d": 0.94,
        "direction": "flat",
        "change_30d": 0.13,
        "change_90d": 1.52,
        "percentile": 81,
        "percentile_label": "above-average growth"
      },
      "signal": "neutral",
      "context": "Net liquidity stable at $5.89T. Consolidating.",
      "timestamp": "2026-06-18T05:05:42.455+00:00",
      "confidence": 55,
      "regulatory_mode": "signal",
      "value_formatted": "$5.89T",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 38,
        "percentile_score": 0,
        "trend_consistency": 100
      }
    }
  },
  "correlations": {
    "spy_vs_vxx": {
      "pair": "spy_vs_vxx",
      "value": -0.89,
      "metric1": "spy",
      "metric2": "vxx",
      "interpretation": "Strong negative correlation (-0.89)"
    },
    "bitcoin-price_vs_dxy": {
      "pair": "bitcoin-price_vs_dxy",
      "value": -0.47,
      "metric1": "bitcoin-price",
      "metric2": "dxy",
      "interpretation": "BTC moderately inverse to Dollar Strength (UUP) (-0.47)"
    },
    "bitcoin-price_vs_qqq": {
      "pair": "bitcoin-price_vs_qqq",
      "value": 0.62,
      "metric1": "bitcoin-price",
      "metric2": "qqq",
      "interpretation": "BTC moderately correlated with Nasdaq 100 (QQQ) (+0.62)"
    },
    "bitcoin-price_vs_spy": {
      "pair": "bitcoin-price_vs_spy",
      "value": 0.62,
      "metric1": "bitcoin-price",
      "metric2": "spy",
      "interpretation": "BTC moderately correlated with S&P 500 (SPY) (+0.62)"
    },
    "bitcoin-price_vs_vxx": {
      "pair": "bitcoin-price_vs_vxx",
      "value": -0.69,
      "metric1": "bitcoin-price",
      "metric2": "vxx",
      "interpretation": "BTC moderately inverse to Volatility (VXX) (-0.69)"
    },
    "net-liquidity_vs_spy": {
      "pair": "net-liquidity_vs_spy",
      "value": 0.31,
      "metric1": "net-liquidity",
      "metric2": "spy",
      "interpretation": "Weak positive correlation (+0.31)"
    },
    "bitcoin-price_vs_eur-usd": {
      "pair": "bitcoin-price_vs_eur-usd",
      "value": null,
      "metric1": "bitcoin-price",
      "metric2": "eur-usd",
      "interpretation": "Insufficient data (7 points, need 10+)",
      "unavailable_reason": "eur-usd has only 7 data points in 30-day window"
    },
    "hash-ribbon_vs_bitcoin-price": {
      "pair": "hash-ribbon_vs_bitcoin-price",
      "value": -0.1,
      "metric1": "hash-ribbon",
      "metric2": "bitcoin-price",
      "interpretation": "No meaningful correlation (-0.10)"
    },
    "bitcoin-price_vs_net-liquidity": {
      "pair": "bitcoin-price_vs_net-liquidity",
      "value": 0.29,
      "metric1": "bitcoin-price",
      "metric2": "net-liquidity",
      "interpretation": "BTC weak positive correlation with Net Liquidity (+0.29)"
    }
  },
  "data_quality": {
    "severity": "ok",
    "health_score": 100,
    "metrics_total": 8,
    "metrics_available": 8,
    "correlations_total": 9,
    "unavailable_metrics": [],
    "correlations_computable": 9,
    "unavailable_correlations": []
  },
  "generated_at": "2026-06-18T06:03:00.663Z",
  "_tier_context": {
    "your_tier": "free",
    "related_briefings": [
      {
        "id": "cross.delta",
        "tier": "basic",
        "description": "Adds percentile rankings"
      },
      {
        "id": "cross.industrial-regime",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis"
      },
      {
        "id": "cross.full",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, historical context"
      },
      {
        "id": "cross.inflation-regime",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis"
      },
      {
        "id": "cross.breadth",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      },
      {
        "id": "cross.regime",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, regime classification, divergence detection, historical context"
      }
    ],
    "higher_tier_features": [
      "Causal reasoning (Pro)",
      "Percentile rankings (Basic+)",
      "Extended 90d momentum (Basic+)",
      "Narrative analysis (Pro)",
      "Regime classification (Pro)",
      "Divergence detection (Pro)",
      "Historical context (Pro)",
      "Extended historical data from Jan 2025 (Basic+)",
      "Full historical data access (Pro)"
    ]
  },
  "briefing_used": "cross.correlations",
  "briefing_metadata": {
    "name": "Correlation Check",
    "tier": "free",
    "data_access": "Today + last 30 days",
    "description": "How Bitcoin correlates with equities, volatility, and the dollar across 9 metric pairs (30-day window)",
    "metrics_count": 8,
    "correlations_count": 9,
    "earliest_usable_date": "1999-04-01",
    "correlations_window_days": 30
  }
}

Schema · Response

{
  "type": "json",
  "example": {
    "metrics": {
      "dxy": {
        "name": "dxy"
      },
      "qqq": {
        "name": "qqq"
      },
      "spy": {
        "name": "spy"
      },
      "vxx": {
        "name": "vxx"
      },
      "eur-usd": {
        "name": "eur-usd"
      },
      "hash-ribbon": {
        "name": "hash-ribbon"
      },
      "treasury-10y": {
        "name": "treasury-10y"
      },
      "bitcoin-price": {
        "name": "bitcoin-price"
      },
      "net-liquidity": {
        "name": "net-liquidity"
      }
    },
    "briefing_used": "cross.correlations",
    "briefing_metadata": {
      "name": "Correlation Check",
      "description": "How Bitcoin correlates with equities, volatility, and the dollar across 10 metric pairs (30 and 90 day windows)",
      "metrics_count": 9,
      "correlations_count": 10
    }
  }
}

Reviews

No reviews yet. Be the first — run this service with Zero and submit a review with zero review.

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"