Public API

Convex Data API

Free access to live US macroeconomic data, regime classification, 150+ economic indicators, and AI-generated analysis. No API key required. Attribution required.

Quick Start

# Get a complete macro snapshot
curl https://convextrade.com/api/public/macro-summary

# Get any metric's current value
curl https://convextrade.com/api/public/metrics/dgs10
curl https://convextrade.com/api/public/metrics/vixcls
curl https://convextrade.com/api/public/metrics/btc

# Get the current regime
curl https://convextrade.com/api/public/regime

Usage Terms

Rate limit: 100 requests/day for unauthenticated access. Need more? Contact us.

Attribution: You must include a visible credit: “Data by Convex” with a link to convextrade.com in any published content using this data.

Caching: All responses include Cache-Control headers. Respect them — the data updates at most every 5 minutes.

CORS: All endpoints allow cross-origin requests. Use them from any domain.

Endpoints

GET/api/public/macro-summaryCache: 5 minutes

Complete macro snapshot — regime, recession probability, stress index, key rates, volatility, credit, labor, inflation, and AI narrative. Best single endpoint for AI agents.

Example response ▾

{
  "regime": { "current": "Stagflation", "confidence": 72, "trajectory": "deteriorating" },
  "recession_probability": 34,
  "stress_index": 45,
  "net_liquidity_trn": 5.42,
  "key_rates": { "10y": 4.25, "2y": 3.95, "spread_2s10s_bps": 30 },
  "volatility": { "vix": 18.5 },
  "credit": { "hy_spread_bps": 350 },
  "inflation": { "cpi_yoy_pct": 3.2 },
  "narrative": "...",
  "attribution": "Data by Convex — https://convextrade.com"
}

GET/api/public/regimeCache: 5 minutes

Current macro regime classification (Goldilocks, Reflation, Stagflation, Deflation) with trajectory, narrative, and per-asset views.

Example response ▾

{
  "regime": "STAGFLATION",
  "trajectory": "DETERIORATING",
  "narrative": "...",
  "assetViews": {
    "btc": { "direction": "BEARISH", "conviction": "HIGH", "thesis": "..." },
    "equities": { ... }, "oil": { ... }, "gold": { ... }
  },
  "attribution": { "text": "Data by Convex", "url": "https://convextrade.com/regime" }
}

GET/api/public/metrics/{ticker}Cache: 5 minutes

Current value and changes for any of 150+ economic indicators. Replace {ticker} with the metric ID (e.g., dgs10, vixcls, spy, btc, cpiaucsl).

Example response ▾

{
  "ticker": "dgs10",
  "displayName": "10Y Treasury Yield",
  "category": "Yield Curve & Rates",
  "unit": "%",
  "value": 4.25,
  "date": "2026-04-03",
  "changes": { "7d": -0.12, "30d": 0.35 },
  "interpretation": "Positive real yield — real tightening...",
  "attribution": { "text": "Data by Convex", "url": "https://convextrade.com/metrics/dgs10" }
}

GET/api/public/signalsCache: 5 minutes

Convex composite indices (CRPI recession probability, CNLI net liquidity, CMSI stress) plus key market signals.

Example response ▾

{
  "convexIndices": {
    "CONVEX_CRPI": { "value": 34, "interpretation": "Moderate recession probability..." },
    "CONVEX_CNLI": { "value": 5420000, "interpretation": "Net liquidity at $5.42T..." },
    "CONVEX_CMSI": { "value": 28, "interpretation": "Normal stress..." }
  },
  "marketSignals": {
    "T10Y2Y": { "value": 0.30, ... },
    "VIXCLS": { "value": 18.5, ... }
  }
}

GET/api/public/content/latestCache: 5 minutes

Latest 5 articles with title, summary, topic, tags, and URL. Useful for newsletter writers and content syndication.

Example response ▾

{
  "articles": [
    {
      "title": "Stagflation Watch: CPI Surprises Hot While Jobs Weaken",
      "slug": "stagflation-watch-...",
      "topic": "Macro",
      "summary": "...",
      "url": "https://convextrade.com/articles/stagflation-watch-..."
    }
  ]
}

Available Metric Tickers

Use these tickers with /api/public/metrics/{ticker}. Full list at /metrics.

dgs10 — 10Y Treasurydgs2 — 2Y Treasuryt10y2y — Yield Spreadfedfunds — Fed Fundsvixcls — VIXcpiaucsl — CPIunrate — Unemploymentbamlh0a0hym2 — HY Spreadspy — S&P 500 ETFbtc — Bitcoingold — Golddcoilwtico — WTI Crudeconvex_crpi — Recession Probconvex_cnli — Net Liquidityconvex_cmsi — Macro Stress

+ 140 more indicators across rates, inflation, credit, labor, housing, commodities, FX, crypto, and sentiment.

AI Agent Integration

MCP: https://convextrade.com/.well-known/mcp.json — Model Context Protocol discovery spec for Claude Desktop, ChatGPT, Cursor, and other MCP clients.

OpenAPI: https://convextrade.com/.well-known/openapi.yaml — OpenAPI 3.0 spec for AI plugin systems.

llms.txt: https://convextrade.com/llms.txt — AI crawler discovery file describing all available content and data.

Embeddable Widgets

Drop live macro data widgets into any website via iframe. See all available widgets.

<iframe src="https://convextrade.com/widget/regime" width="300" height="120" style="border:none" />
<iframe src="https://convextrade.com/widget/recession" width="300" height="140" style="border:none" />
<iframe src="https://convextrade.com/widget/metric/dgs10" width="250" height="100" style="border:none" />

Get notified about API updates and new data sources.

All Metrics →Widgets →Current Regime →AI Chatbot →