# PreReason Cross Correlations - BTC vs Macro Correlation Matrix

> 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.

## Facts

- Endpoint: GET https://api.prereason.com/api/cross/correlations?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-cross-correlations-btc-vs-macro-correlation-matrix-f723301b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PaGq8KWspHsBNyGJu_8Sa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability prereason-cross-correlations-btc-vs-macro-correlation-matrix-f723301b
```

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.

## When to prefer this

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.

## Known failure modes

- 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

## 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 request

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

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-cross-correlations-btc-vs-macro-correlation-matrix-f723301b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)