Macro Indicator Snapshot

Available as MCP tool: macro_indicator_snapshot — call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.

Live free · latest

What it does for your agent

macro_indicator_snapshot returns the latest observation for a U.S. macro indicator plus the previous value and the delta between them. Use it as a macro checkpoint: when an agent needs to answer “what’s the current Fed Funds rate?”, “is unemployment up or down vs last month?”, or tag the current macro regime — without pulling the full historical series. macro_indicator_snapshot({ indicator }) → latest, previous, delta_abs, delta_pct. That’s it. For the full series, use macro_indicator_history.

Response

MacroSnapshot

required

Show MacroSnapshot fields

string

required

Stable platform alias (e.g. us.rates.fed_funds).

string

required

Raw series ID (e.g. FEDFUNDS).

string

required

Human-readable indicator title.

string

required

Native cadence (Daily, Weekly, Monthly, Quarterly, Annual).

string

required

Unit string (e.g. Percent, Index 1982-1984=100).

object

required

Latest observation. null if no observations are available yet.

Show latest fields

string

required

Observation date (YYYY-MM-DD).

number

Reported value, or null.

string

required

First date this value was published.

string

required

Last date this value remained current.

object

required

Previous observation. null if only one print is available.

Show previous fields

string

required

Previous observation date.

number

Previous value.

number

required

latest.value − previous.value. null when either side is missing.

number

required

Percent change vs previous (i.e. delta_abs / previous.value * 100). null when either side is missing or previous.value == 0.

string

required

Required attribution string for display.

number

Always 0 — this endpoint is free.

number

Account credits remaining.

200 OK · macro_indicator_snapshot

{
  "data": {
    "indicator": "us.unemployment_rate",
    "series_id": "UNRATE",
    "title": "Unemployment Rate",
    "frequency": "Monthly",
    "units": "Percent",
    "latest": {
      "date": "2026-03-01",
      "value": 4.1,
      "realtime_start": "2026-04-04",
      "realtime_end": "2026-04-04"
    },
    "previous": {
      "date": "2026-02-01",
      "value": 4.0
    },
    "delta_abs": 0.1,
    "delta_pct": 2.5,
    "attribution": "Source: U.S. Bureau of Labor Statistics via FRED"
  },
  "meta": {
    "creditsUsed": 0,
    "remainingCredits": 99
  }
}

The snapshot carries its own attribution string (FRED source notice) under data — surface it when you display the data. This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis.

Notes

Revision-aware: snapshots return the latest vintage — not the value originally released. If a recent print has been revised, you’ll see the revised value. Check latest.realtime_start to see when the value was last published.

Snapshot returns far fewer tokens than macro_indicator_history, and this endpoint is free. Reach for snapshot when the agent needs “what is it now?” and doesn’t need a series.

Supported catalog only. ~50 curated U.S. indicators. Use macro_indicator_search to discover what’s available; arbitrary series_id values outside the catalog return 404.

Frequency-aware freshness: daily/weekly indicators refresh within 24 h; monthly/quarterly within 7 days. The snapshot may be a few hours behind the absolute latest release.

Direct invocation

HTTP / SDK examples

{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_snapshot",
    "arguments": { "indicator": "us.unemployment_rate" }
  }
}

import os, requests

resp = requests.get(
    "https://api.llmquantdata.com/api/macro/snapshot",
    headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
    params={"indicator": "us.unemployment_rate"},
).json()
d = resp["data"]
print(f"{d['indicator']}: {d['latest']['value']}{d['units'][:1]} "
      f"({d['delta_abs']:+.2f} vs prev)")

curl "https://api.llmquantdata.com/api/macro/snapshot?indicator=us.unemployment_rate" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

Full parameter reference

macro_indicator_snapshot — request parameters

string

Platform alias (e.g. us.cpi.headline, us.rates.fed_funds, us.unemployment_rate). Use this OR series_id.

string

Raw series ID (e.g. UNRATE, FEDFUNDS). Use this OR indicator. Must be in the supported catalog.

Macro Historical

Full latest-vintage time series for the same indicator (Recent or Range mode).

Macro Indicators Catalog

Browse the ~50-indicator catalog (free).

Getting Started

Connect

Personal Context

Knowledge Data

Crypto Prices

Prediction Markets

Equity Prices

ETF