> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cross-Asset Macro Correlation

> Assess how current macro conditions affect BTC using rules-based analysis.

## Overview

Evaluates DXY, US 10Y Treasury yield, Gold (XAU), BTC-Nasdaq correlation,
and BTC dominance. Returns a directional assessment and per-signal breakdown.

**Tier:** Basic (\$49/mo) 🔒
**Cache TTL:** 300 seconds
**Rate limit:** 1,000 calls/day, 30/minute

## Score Interpretation

| btc\_macro\_score | overall\_assessment                       |
| ----------------- | ----------------------------------------- |
| ≥ 0.60            | BULLISH -- macro environment supports BTC |
| 0.41–0.59         | NEUTRAL -- mixed signals                  |
| ≤ 0.40            | BEARISH -- macro headwinds for BTC        |

## Signals Evaluated

| Signal         | Description                                                       |
| -------------- | ----------------------------------------------------------------- |
| DXY            | US Dollar Index -- falling dollar = BTC tailwind                  |
| US10Y          | 10-Year Treasury yield -- falling yields = lower opportunity cost |
| XAU\_SPOT      | Gold spot price -- spiking gold = risk-off headwind               |
| BTC\_NDX\_CORR | BTC-Nasdaq 7-day correlation                                      |
| BTC\_DOMINANCE | BTC market share -- rising dominance = capital rotation in        |

<ResponseExample>
  ```json theme={null}
  {
    "timestamp": "2026-04-18T10:00:00Z",
    "btc_macro_score": 0.70,
    "overall_assessment": "BULLISH",
    "signals": [
      {
        "asset": "DXY",
        "current_value": 99.2,
        "trend": "FALLING",
        "btc_impact": "BULLISH",
        "explanation": "Dollar weakening supports BTC as alternative store of value"
      },
      {
        "asset": "US10Y",
        "current_value": 4.25,
        "trend": "STABLE",
        "btc_impact": "NEUTRAL",
        "explanation": "Treasury yields stable -- no significant BTC pressure"
      },
      {
        "asset": "XAU_SPOT",
        "current_value": 3280.0,
        "trend": "CONSOLIDATING",
        "btc_impact": "BULLISH",
        "explanation": "Gold volatility declining -- rotation to BTC historically follows"
      },
      {
        "asset": "BTC_NDX_CORR",
        "current_value": 0.58,
        "trend": "RISING",
        "btc_impact": "BULLISH",
        "explanation": "High BTC-Nasdaq correlation with Nasdaq at ATH supports BTC"
      },
      {
        "asset": "BTC_DOMINANCE",
        "current_value": 62.4,
        "trend": "RISING",
        "btc_impact": "BULLISH",
        "explanation": "Rising BTC dominance confirms early bull cycle positioning"
      }
    ],
    "summary": "Macro environment is broadly supportive of BTC.",
    "cached": false,
    "cache_ttl_seconds": 300
  }
  ```
</ResponseExample>