Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
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

​
data
MacroSnapshot
required
​
meta.creditsUsed
number
Credits consumed (always 1).
​
meta.remainingCredits
number
Account credits remaining.
​
meta.sourceNotice
string
FRED API notice string.
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": 1,
    "remainingCredits": 99,
    "sourceNotice": "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 FRED has revised the most recent print, you’ll see the revised value. Check latest.realtime_start to see when the value was last published.
Snapshot is cheaper than macro_indicator_history only in token terms — both cost 1 credit. Reach for snapshot when the agent needs “what is it now?” and doesn’t need a series.
Allowlist only. ~50 curated U.S. indicators. Use macro_indicator_search to discover what’s available; arbitrary FRED IDs return 404.
Frequency-aware freshness: daily/weekly indicators refresh from upstream within 24 h; monthly/quarterly within 7 days. The snapshot may be a few hours behind the absolute latest FRED release.

​
Direct invocation

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

​
Full parameter reference

​
indicator
string
Platform alias (e.g. us.cpi.headline, us.rates.fed_funds, us.unemployment_rate). Use this OR series_id.
​
series_id
string
FRED series ID (e.g. UNRATE, FEDFUNDS). Use this OR indicator. Must be in the allowlist.

Macro Historical

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

Macro Indicators Catalog

Browse the ~50-indicator allowlist (free).