宏观历史时间序列

已暴露为 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 拉序列。两种查询模式：

Recent 模式 —— 传 limit（默认 60）取最近 N 个 observation。
Range 模式 —— 传 start_date + end_date 取一个固定窗口。

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。

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 个月。需要更长就提到 500 或改用 Range 模式。热门指标重复查询通常更快。

Recent 与 Range 模式互斥。 要么单传 limit，要么同时传 start_date + end_date。只传一个 date 返回 400。

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

直接调用

HTTP / SDK 示例

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

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

// 2b) 或取一个明确的日期范围
{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_history",
    "arguments": {
      "indicator": "us.cpi.headline",
      "start_date": "2020-01-01",
      "end_date": "2026-03-01"
    }
  }
}

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={"q": "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?q=cpi&category=Inflation" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

# 2) Recent 模式
curl "https://api.llmquantdata.com/api/macro/historical?indicator=us.cpi.headline&limit=60" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

# 2b) Range 模式
curl "https://api.llmquantdata.com/api/macro/historical?indicator=us.cpi.headline&start_date=2020-01-01&end_date=2026-03-01" \
  -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

Range 模式。ISO 日期 YYYY-MM-DD。必须与 end_date 同时使用。

string

Range 模式。ISO 日期 YYYY-MM-DD。必须与 start_date 同时使用。

number

default:60

Recent 模式返回条数。范围 1–500。Range 模式下被忽略。

宏观指标目录

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

宏观指标快照

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

快速开始

接入

个人 Context

知识数据

Crypto 行情

预测市场

美股行情

ETF

宏观指标

SEC 申报文件

News

SEC Form 13F

宏观历史时间序列

它为 Agent 做什么

Agent flow

返回值

说明

直接调用

完整参数参考

相关接口

宏观指标目录

宏观指标快照

​它为 Agent 做什么

​Agent flow

​返回值

​说明

​直接调用

​完整参数参考

​相关接口

宏观指标目录

宏观指标快照

它为 Agent 做什么

Agent flow

返回值

说明

直接调用

完整参数参考

相关接口