{
  "generated_from": "https://x402.press/catalog.json",
  "generator": "scripts/generate_service_pages.py",
  "page": "https://x402.press/services/macro-analyst/",
  "llms": "https://x402.press/services/macro-analyst/llms.txt",
  "name": "macro-analyst",
  "display_name": "Macro Analyst",
  "host": "https://macro-analyst.x402.press",
  "state": "pending-review",
  "state_note": "Pending review as of 2026-10-30: retired from the fleet on 2026-10-28 and its vhost removed, so GET /health cannot complete a TLS handshake (tls_no_certificate, probed 2026-10-30T23:10Z). Nothing is for sale until a review brings it back.",
  "description": "Deterministic macro-economic analysis toolkit — yield-curve, breakeven-inflation, growth, inflation-decomposition, FX, rates-math and real-commodity compute operations behind x402 micropayments, with a machine-readable macro-analyst persona.",
  "archetype": "function-toolkit",
  "maturity": "beta",
  "tags": [
    "macro",
    "macro-economics",
    "rates",
    "inflation",
    "cross-asset"
  ],
  "paid_operations": [
    {
      "name": "yield_curve",
      "method": "POST",
      "path": "/ma/yield_curve",
      "kind": "compute",
      "latency_class": "fast",
      "description": "Yield-curve level, spreads (2s10s/3m10s/3m2s/10s30s), shape label, and — with a prior curve — per-tenor shift and steepener change. Caller supplies the curve."
    },
    {
      "name": "breakeven_inflation",
      "method": "POST",
      "path": "/ma/breakeven_inflation",
      "kind": "compute",
      "latency_class": "fast",
      "description": "Breakeven inflation (nominal minus real yield) per tenor, 5y5y forward from 5y/10y BEI, real yields, and an expectations label. Caller supplies nominal/real yield pairs."
    },
    {
      "name": "growth",
      "method": "POST",
      "path": "/ma/growth",
      "kind": "compute",
      "latency_class": "fast",
      "description": "Growth rates from a series: YoY, period-over-period, annualized (SAAR), trailing-average YoY, and a window trend. Caller supplies the series."
    },
    {
      "name": "inflation_decomp",
      "method": "POST",
      "path": "/ma/inflation_decomp",
      "kind": "compute",
      "latency_class": "fast",
      "description": "Headline/core CPI decomposition: headline-core gap, MoM annualized, 3m/6m/12m annualized, base effect, and per-component contributions. Caller supplies the monthly series."
    },
    {
      "name": "fx",
      "method": "POST",
      "path": "/ma/fx",
      "kind": "compute",
      "latency_class": "fast",
      "description": "FX math from caller-supplied inputs: % change vs a prior spot, annualized carry (rate differential), and a real-FX proxy (spot x CPI ratio) with its % change."
    },
    {
      "name": "macro_stats",
      "method": "POST",
      "path": "/ma/macro_stats",
      "kind": "compute",
      "latency_class": "fast",
      "description": "Generic deterministic stats on a series: pct change, YoY, window z-score + percentile rank, max drawdown, CAGR. Caller supplies the series."
    },
    {
      "name": "rates_math",
      "method": "POST",
      "path": "/ma/rates_math",
      "kind": "compute",
      "latency_class": "fast",
      "description": "Rates math from two yields/tenors: implied forward rate, zero-coupon modified duration, and DV01 for $100 face. Yields in decimals, tenors in years."
    },
    {
      "name": "real_commodity",
      "method": "POST",
      "path": "/ma/real_commodity",
      "kind": "compute",
      "latency_class": "fast",
      "description": "Real (deflated) commodity price: price/cpi, real return vs a prior observation, and % off an all-time real peak. Caller supplies price + CPI."
    },
    {
      "name": "validate",
      "method": "POST",
      "path": "/ma/validate",
      "kind": "validate",
      "latency_class": "fast",
      "description": "Validate an input document against the canonical schema (series/curve/pairs/fx/commodity/rates) — correct the request before paying for compute."
    },
    {
      "name": "knowledge",
      "method": "POST",
      "path": "/ma/knowledge",
      "kind": "helper",
      "latency_class": "fast",
      "description": "Retrieve the service's methodology corpus (determinism contract, macro framework, release-calendar workflows, source registry)."
    },
    {
      "name": "sources",
      "method": "POST",
      "path": "/ma/sources",
      "kind": "helper",
      "latency_class": "fast",
      "description": "List the service's recommended (keyless) data sources and their reliability ratings, for the caller to acquire its own data."
    },
    {
      "name": "ma_ask",
      "method": "POST",
      "path": "/ma/ask",
      "kind": "assembly",
      "latency_class": "slow",
      "description": "One-call structured macro analysis. DeepSeek orchestrates the deterministic compute operations (supplying its own data) and returns a structured brief (bottom line, rates, inflation, growth, cross-asset, risks)."
    }
  ],
  "free_endpoints": [
    {
      "method": "GET",
      "path": "/ma/tools",
      "description": "list all operations with input schemas"
    },
    {
      "method": "GET",
      "path": "/macro-analyst/feedback",
      "description": "50 most recent feedback entries"
    },
    {
      "method": "POST",
      "path": "/macro-analyst/feedback",
      "description": "submit feedback"
    }
  ],
  "docs": {
    "llms": "https://macro-analyst.x402.press/llms.txt",
    "manifest": "https://macro-analyst.x402.press/.well-known/x402.json",
    "tools": "https://macro-analyst.x402.press/tools",
    "openapi": "https://macro-analyst.x402.press/openapi.json",
    "about": "https://macro-analyst.x402.press/about",
    "persona": "https://macro-analyst.x402.press/persona"
  },
  "hub_catalog": "https://x402.press/catalog.json"
}
