Skip to main content
已暴露为 MCP 工具：macro_indicator_snapshot —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线   每次 1 credit

​
它为 Agent 做什么

macro_indicator_snapshot 返回某个美国宏观指标的最新 observation，加上前值和两者的差值。它是 agent 的 宏观 checkpoint：要回答 “现在联邦基金利率多少？”、“失业率比上月升了还是降了？”、“当前宏观 regime 是什么？” 时，不需要拉完整序列，调它一次就够。 macro_indicator_snapshot({ indicator }) → latest、previous、delta_abs、delta_pct。仅此而已。要完整时间序列，请用 macro_indicator_history。

​
返回值

​
data
MacroSnapshot
required
​
meta.creditsUsed
number
固定 1。
​
meta.remainingCredits
number
账户剩余 credit。
​
meta.sourceNotice
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."
  }
}

​
说明

Revision-aware：snapshot 返回的是当前 latest vintage —— 不是当初首发的值。如果最近一笔被修订，你看到的是修订后的值。看 latest.realtime_start 可以判断该值最后发布于哪天。
snapshot 与 macro_indicator_history 都是 1 credit，差别只在返回 token 体量。当 agent 只关心 “当前是多少” 时用 snapshot，不需要序列。
仅支持目录内。 约 50 个精选美国指标。先用 macro_indicator_search 浏览可用列表；目录之外的 ID 返回 404。
按频率刷新：日频/周频指标 24h 内更新；月频/季频 7 天内更新。snapshot 可能比当前最新发布滞后几个小时。

​
直接调用

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

​
完整参数参考

​
indicator
string
平台 alias（如 us.cpi.headline、us.rates.fed_funds、us.unemployment_rate）。与 series_id 二选一。
​
series_id
string
Raw series ID（如 UNRATE、FEDFUNDS）。与 indicator 二选一。必须在支持目录内。

​
相关接口

宏观历史时间序列

同一指标的完整 latest-vintage 时间序列（Recent 或 Range 模式）。

宏观指标目录

浏览约 50 个精选指标目录（免费）。