Diszy - Grow your Discord Apps

Macro Radar API

FREE API

A frequently refreshed endpoint that provides overarching market regime indicators, such as the VIX, Yield Curve, Credit Spreads, and Fed Funds Rate.

Endpoint

GEThttps://diszy.com/bot/macro

Overview

The Macro API endpoint aggregates key macroeconomic indicators essential for evaluating the broader market regime. The response refreshes roughly every 15 minutes and returns explicit update timestamps so you can see when the payload was last rebuilt. The VIX uses Yahoo Finance, while the yield curve, credit spreads, and Fed Funds Rate use the Federal Reserve Economic Data (FRED) API.

Refresh & Sources

More frequent refreshes mainly benefit the VIX because it can move intraday. The FRED-backed fields only change when the underlying series publish a new observation, so polling them more often does not necessarily produce new values.

VIX: Yahoo Finance via yahoo-finance2 using chart for ^VIX. The latest VIX value uses a 5m chart, while the 30-day history uses a 1d chart.
FRED: https://api.stlouisfed.org/fred/series/observations with series T10Y2Y, BAMLC0A0CM, BAMLH0A0HYM2, and FEDFUNDS.

Response Properties

Property	Type	Description
`vix`	`number \| null`	CBOE Volatility Index (^VIX) rounded to 2 decimals. The latest reading is refreshed from Yahoo Finance intraday data.
`yieldCurve`	`number \| null`	10-Year Treasury Constant Maturity Minus 2-Year Treasury Constant Maturity (T10Y2Y).
`creditSpread`	`number \| null`	ICE BofA US Corporate Index Option-Adjusted Spread (BAMLC0A0CM).
`highYieldSpread`	`number \| null`	ICE BofA US High Yield Index Option-Adjusted Spread (BAMLH0A0HYM2).
`fedFunds`	`number \| null`	Effective Federal Funds Rate (FEDFUNDS).
`fedFundsTrend`	`string`	"Rising", "Falling", or "Stable" based on the most recent 1-month change.
`updatedAt`	`string`	ISO 8601 timestamp showing when this API payload was last aggregated.
`updatedTimeUtc`	`string`	Human-readable UTC time derived from `updatedAt`, e.g. `14:45:00 UTC`.
`date`	`string`	Legacy alias for `updatedAt` kept for backward compatibility.
`refreshCadenceMinutes`	`number`	Approximate cache window for the macro payload in minutes.
`regimeScore`	`number`	Sum of points based on current macro values. Positive scores indicate Risk-On, negative scores indicate Risk-Off.
`regimeStatus`	`string`	"Risk-On", "Neutral", or "Risk-Off" state based on the regimeScore.
`regimeFormula`	`object`	Details the formula and thresholds used to calculate the regimeScore and status.
`vixLabel` / `yieldCurveLabel` / `creditSpreadLabel`	`string`	Semantic labels for the respective values, e.g. "LOW", "NORMAL", "ELEVATED", "HIGH", "INVERTED", "STEEP", "TIGHT", "WIDE".
`sources`	`object`	Upstream provider metadata, including the Yahoo Finance operation for VIX and the FRED endpoint plus series IDs used for the other indicators.
`vixChartUrl`	`string \| null`	A complete URL to QuickChart rendering a 30-day history line chart for the VIX. Ready to be embedded.
`vixChanges`	`object \| null`	Absolute and percentage changes comparing the current rounded VIX to 1 trading day and 30 days ago.
`vixHistory`	`array`	Array containing the last 30 daily quotes (date and close) for the VIX index, with close values rounded to 2 decimals.

Market Regime Calculation

The Diszy Macro API doesn't just broadcast raw data; it analyzes it to output a synthesized Market Regime Status (Risk-On, Neutral, or Risk-Off). This enables you to feed unambiguous binary triggers into trading algorithms, confidently prompt LLMs with broader market states, or trigger automated hedging actions.

What do these Regimes mean?

Risk-On: Investors are optimistic and risk-tolerant. Volatility (VIX) is usually low, credit is cheap (low spreads), and yield curves are healthy. Capital flows into riskier assets like equities (especially tech/growth) and crypto. Recommendation: Build long positions or use leverage.
Risk-Off:Investors are fearful, often anticipating a recession or market shock. Volatility spikes, and corporate borrowing becomes expensive (high yields). Capital flees into "safe havens" like Treasuries, gold, or cash. Recommendation: Reduce risk, close positions, or build hedges.
Neutral: A transitional state or a phase lacking clear directional momentum.

The regimeScore is computed using the following formula:

VIX: < 16 (+1 point) | > 22 (-1 point)
Yield Curve (T10Y2Y): > 1.0% (+1 point) | < 0% (Inverted, -2 points)
High Yield Spread: < 2.5% (+1 point) | > 4.5% (-1 point)
Fed Funds Trend: Falling (+1 point) | Rising (-1 point) | Stable (0 points)

Final Status:

Risk-On (Score ≥ 2), Risk-Off (Score ≤ -2), else Neutral.

Interactive Calculator

Adjust the values below to see how the regime calculates live.

VIX

Range: 9.0 – 85.0

ELEVATED

Yield Curve (%)

Range: -2.5% – 4.5%

NORMAL

High Yield Spread (%)

Range: 2.0% – 25.0%

NORMAL

Fed Funds Trend

1-Month Change

Recommendation:

Neutral

Example Response

{
  "vix": 18.06,
  "yieldCurve": -0.45,
  "creditSpread": 0.76,
  "highYieldSpread": 2.90,
  "fedFunds": 5.33,
  "fedFundsTrend": "Stable",
  "updatedAt": "2026-05-20T14:45:00.000Z",
  "updatedTimeUtc": "14:45:00 UTC",
  "date": "2026-05-20T14:45:00.000Z",
  "refreshCadenceMinutes": 15,
  "regimeScore": -2,
  "regimeStatus": "Risk-Off",
  "regimeFormula": {
    "vix": "< 16 (+1), > 22 (-1)",
    "yieldCurve": "> 1.0% (+1), < 0% (-2)",
    "highYieldSpread": "< 2.5% (+1), > 4.5% (-1)",
    "fedFundsTrend": "Falling (+1), Rising (-1), Stable (0)",
    "status": "Score >= 2 (Risk-On), Score <= -2 (Risk-Off), else (Neutral)"
  },
  "vixLabel": "NORMAL",
  "yieldCurveLabel": "INVERTED",
  "creditSpreadLabel": "TIGHT",
  "sources": {
    "vix": {
      "provider": "Yahoo Finance",
      "library": "yahoo-finance2",
      "latestOperation": "chart",
      "latestInterval": "5m",
      "historyOperation": "chart",
      "historyInterval": "1d",
      "symbol": "^VIX"
    },
    "fred": {
      "provider": "FRED",
      "endpoint": "https://api.stlouisfed.org/fred/series/observations",
      "series": {
        "yieldCurve": "T10Y2Y",
        "creditSpread": "BAMLC0A0CM",
        "highYieldSpread": "BAMLH0A0HYM2",
        "fedFunds": "FEDFUNDS"
      }
    }
  },
  "vixChartUrl": "https://quickchart.io/chart?c=...",
  "vixChanges": {
    "change1D": 0.24,
    "change1DPct": 1.35,
    "yesterdayClose": 17.82,
    "change1M": -0.81,
    "change1MPct": -4.29,
    "lastMonthClose": 18.87
  },
  "vixHistory": [
    {
      "date": "2026-04-20",
      "close": 18.87
    },
    {
      "date": "2026-04-21",
      "close": 19.50
    }
  ]
}