宏观历史时间序列

已暴露为 MCP 工具：macro_indicator_search + macro_indicator_history —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。

已上线 1 credit · history 免费 · search

它为 Agent 做什么

macro_indicator_history 返回单个支持的美国宏观指标（CPI、UNRATE、Fed Funds、10Y 收益率、GDP 等）的 latest-vintage 历史时间序列 —— 一组 { date, value, realtime_start, realtime_end } observation。它是 agent 的 宏观时间序列拉取器：要把过去 5 年通胀画图、要算收益率曲线斜率、要把 observation 喂下游模型时调它。 canonical 的 agent 流程是两步：先调 macro_indicator_search（免费）找到正确的 indicator alias，再调 macro_indicator_history 拉序列。时间边界可选：用 start_date 和/或 end_date 先过滤候选窗口，再用 limit 和 take_from 决定保留哪一端。返回顺序始终是旧到新。

Agent flow

返回值

MacroHistorical

required

指标元信息 + observations 数组。

Show MacroHistorical 字段

string

required

回显的平台稳定 alias（如 us.cpi.headline）。

string

required

Raw series ID（如 CPIAUCSL）。

string

required

指标的可读标题。

string

required

原生发布频率：Daily、Weekly、Monthly、Quarterly、Annual。

string

required

单位字符串（如 Index 1982-1984=100、Percent）。

MacroObservation[]

required

时间升序的 observation（旧 → 新）。

Show MacroObservation 字段

string

required

观测期起始日（YYYY-MM-DD）。

number

上报值。该周期缺失时为 null。

string

required

该值首次发布日（YYYY-MM-DD）。用来识别 revision。

string

required

该值的有效结束日。当前 latest vintage 通常等于 realtime_start。

string

required

展示数据时必须保留的署名字符串。

boolean

required

刷新失败、返回较旧可用数据时为 true。

number

固定 1。

number

账户剩余 credit。

string

仅在候选窗口内的数据多于实际返回条数时出现 —— 也就是结果被 limit 截断了。这句话提示 agent 缩小窗口或把查询拆成多次：More data exists in the requested window than the items returned; narrow the window or split the query to see more.

200 OK · macro_indicator_history

{
  "data": {
    "indicator": "us.cpi.headline",
    "series_id": "CPIAUCSL",
    "title": "Consumer Price Index for All Urban Consumers: All Items in U.S. City Average",
    "frequency": "Monthly",
    "units": "Index 1982-1984=100",
    "observations": [
      {
        "date": "2026-01-01",
        "value": 318.412,
        "realtime_start": "2026-02-12",
        "realtime_end": "2026-02-12"
      },
      {
        "date": "2026-02-01",
        "value": 319.082,
        "realtime_start": "2026-03-12",
        "realtime_end": "2026-03-12"
      },
      {
        "date": "2026-03-01",
        "value": 319.799,
        "realtime_start": "2026-04-10",
        "realtime_end": "2026-04-10"
      }
    ],
    "attribution": "Source: U.S. Bureau of Labor Statistics via FRED",
    "stale": false
  },
  "meta": {
    "creditsUsed": 1,
    "remainingCredits": 99
  }
}

每条 series 在 data 下都带有自己的 attribution 字符串（FRED 来源说明）—— 展示数据时请一并呈现。本产品使用 FRED® API，但未经 Federal Reserve Bank of St. Louis 背书或认证。

说明

Revision-aware：宏观 observation 会被修订。我们返回的是当前 latest vintage，不一定是当初首发的值。用 realtime_start / realtime_end 判断你是不是看到了修订后的版本。暂不支持 as-of vintage 历史回放。

默认 limit=60 大致覆盖月频最近 5 年、周频最近 1 年、日频最近 3 个月。用 start_date / end_date 限定窗口；需要窗口开头的 N 条时传 take_from=earliest。

take_from=earliest 需要 start_date。如果同时传两个日期边界，start_date 不能晚于 end_date。

仅支持目录内。 约 50 个精选美国指标，目录之外返回 400 invalid_request。用 macro_indicator_search 浏览可用列表。

直接调用

HTTP / SDK 示例

// 1) 找 alias
{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_search",
    "arguments": { "query": "cpi", "category": "Inflation" }
  }
}

// 2) 取最近的 history（默认 60）
{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_history",
    "arguments": { "indicator": "us.cpi.headline", "limit": 60 }
  }
}

// 2b) 或取一个日期窗口内最早的 12 条
{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_history",
    "arguments": {
      "indicator": "us.cpi.headline",
      "start_date": "2020-01-01",
      "end_date": "2026-03-01",
      "limit": 12,
      "take_from": "earliest"
    }
  }
}

import os, requests

base = "https://api.llmquantdata.com"
headers = {"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"}

# 1) 找 alias
catalog = requests.get(
    f"{base}/api/macro/indicators",
    headers=headers,
    params={"query": "cpi", "category": "Inflation"},
).json()["data"]

alias = catalog[0]["indicator"]  # 例如 us.cpi.headline

# 2) 取最近的 history
hist = requests.get(
    f"{base}/api/macro/historical",
    headers=headers,
    params={"indicator": alias, "limit": 60},
).json()
for obs in hist["data"]["observations"][-3:]:
    print(obs["date"], obs["value"])

# 1) 找 alias
curl "https://api.llmquantdata.com/api/macro/indicators?query=cpi&category=Inflation" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

# 2) 不传日期边界 —— 最近的观测
curl "https://api.llmquantdata.com/api/macro/historical?indicator=us.cpi.headline&limit=60" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

# 2b) 窗口内最早的 12 条
curl "https://api.llmquantdata.com/api/macro/historical?indicator=us.cpi.headline&start_date=2020-01-01&end_date=2026-03-01&limit=12&take_from=earliest" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

完整参数参考

macro_indicator_search — 请求参数

string

自由文本关键词，匹配 indicator alias、指标标题、series_id。

string

按主题过滤（Inflation、Rates、Labor、Growth、Housing、Liquidity、Conditions、FX、Credit、Sentiment、Energy、Inflation Expectations、Consumption）。

string

按发布频率过滤（Daily、Weekly、Monthly、Quarterly、Annual）。

number

default:20

返回上限。范围 1–100。

macro_indicator_history — 请求参数

string

平台 alias（如 us.cpi.headline、us.rates.fed_funds）。与 series_id 二选一。

string

Raw series ID（如 CPIAUCSL）。与 indicator 二选一。必须在支持目录内。

string

可选 inclusive 下边界，ISO 日期 YYYY-MM-DD。

string

可选 inclusive 上边界，ISO 日期 YYYY-MM-DD。

number

default:60

边界过滤后最多返回多少条 observation。范围 1–500。

string

default:"latest"

当过滤后候选超过 limit 时保留哪一端：latest 或 earliest。输出仍按时间正序。

宏观指标目录

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

宏观指标快照

只看最新值 + 涨跌（不返回完整序列）。

快速开始

接入

个人 Context

知识数据

Crypto 行情

预测市场

美股行情

ETF

宏观指标

SEC 申报文件

News

SEC Form 13F

宏观历史时间序列

它为 Agent 做什么

Agent flow

返回值

说明

直接调用

完整参数参考

相关接口

宏观指标目录

宏观指标快照