{"uid":"cap_PaGq8KWspHsBNyGJu_8Sa","slug":"prereason-cross-correlations-btc-vs-macro-correlation-matrix-f723301b","name":"PreReason Cross Correlations - BTC vs Macro Correlation Matrix","description":"Bitcoin correlation matrix. BTC vs SPY, dollar strength (UUP), Treasury yields, VIX relationship signals. Cross-asset diversification data for portfolio agents.","url":"https://api.prereason.com/api/cross/correlations?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"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}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"format":"json","briefing":"cross.correlations"}}},"response":{"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}}},"exampleRequest":{"format":"json","briefing":"cross.correlations"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X-RfS-i4bMZ9gseTGFXP-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a correlation matrix showing how Bitcoin moves relative to SPY, DXY, and bond yields, with cross-asset signal analysis.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:46:45.628Z","isFirstParty":false,"canonicalSlug":"prereason-cross-correlations-btc-vs-macro-correlation-matrix-f723301b"}