---
title: "TradFi macro context (VIX, DXY, US 10Y, SPX, gold) — $0.02/call"
method: GET
path: "/api/v1/macro"
tags: ["macro", "paid"]
---

# TradFi macro context (VIX, DXY, US 10Y, SPX, gold) — $0.02/call

`GET /api/v1/macro`

## Request

- Base URL: `https://kronossignals.com` (the document declares no server; this is the origin it was published from)
- URL: `https://kronossignals.com/api/v1/macro`
- Auth: none declared

Returns TradFi macro context for crypto risk assessment: VIX fear gauge, DXY (US Dollar Index), US 10-Year Treasury yield, S&P 500 (SPX), and gold spot price. Sourced from stooq.com and Yahoo Finance in parallel. 15-minute in-memory cache. A field is null when its source is unreachable — never fabricated; if every source is unreachable the call answers 503 and nothing is charged. BTC-SPX and BTC-DXY 30-day Pearson correlations are computed from daily returns (Binance + stooq historical) and included when source data is available; null with btc_spx_correlation_available:false when upstream fetch fails — never fabricated. Costs $0.02 USDC on Base mainnet via x402.

## Response `200`

Macro context returned (payment verified)

- object
  - `as_of` string, date-time, required
  - `cached` boolean
  - `cache_age_seconds` integer, nullable
  - `vix` object, required
    - `value` number, nullable
    - `source` string, nullable
    - `unavailable` boolean
  - `dxy` object, required
    - `value` number, nullable
    - `source` string, nullable
    - `unavailable` boolean
  - `us_10y_yield` object, required
    - `value` number, nullable
    - `source` string, nullable
    - `unavailable` boolean
  - `spx` object, required
    - `value` number, nullable
    - `source` string, nullable
    - `unavailable` boolean
  - `gold` object, required
    - `value` number, nullable
    - `source` string, nullable
    - `unavailable` boolean
  - `btc_spx_correlation` number, nullable: Pearson correlation of 30d daily returns (BTC vs SPX). Null when <10 aligned days or fetch failed. Field omitted when BTC history unavailable.
  - `btc_spx_correlation_available` boolean: true when btc_spx_correlation was successfully computed.
  - `btc_dxy_correlation` number, nullable: Pearson correlation of 30d daily returns (BTC vs DXY). Null when <10 aligned days or fetch failed. Field omitted when BTC history unavailable.
  - `btc_dxy_correlation_available` boolean: true when btc_dxy_correlation was successfully computed.
  - `correlation_note` string: Present only when correlation fields are omitted due to upstream fetch failure.
  - `disclaimer` string, required

## Other responses

- `402`: Payment Required — x402 micropayment instructions in response body

---

[API](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api.md) · [All operations](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/revisions/bfdcf7230e93?raw)