宏观指标目录

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

已上线免费 · 0 credits

它为 Agent 做什么

macro_indicator_search 返回 LLMQuant Data 支持的约 50 个美国宏观指标目录 —— 通胀（CPI / PCE）、利率（联邦基金利率、国债收益率）、就业（失业率、非农）、增长（GDP）、住房、流动性（M2、Fed 资产负债表）、金融条件、汇率等。它是 agent 的 catalog discovery 入口：在调用 macro_indicator_history / macro_indicator_snapshot 之前，先用它通过 category、frequency 或自由文本关键词浏览目录，确定要用哪个 indicator alias 或 series_id。它不暴露所有可能的宏观 series —— 只返回精选、已澄清署名的支持目录。不传任何参数 = 列出全部。

返回值

MacroIndicatorCatalogItem[]

required

Curated catalog 条目，每条对应一个支持的指标。

Show MacroIndicatorCatalogItem 字段

string

required

平台稳定 alias。传给 macro_indicator_history / macro_indicator_snapshot（如 us.cpi.headline、us.rates.fed_funds）。

string

required

Raw series ID（如 CPIAUCSL、FEDFUNDS）。history/snapshot 工具同样接收。

string

required

指标的可读标题。

string

required

主题分类：Growth、Consumption、Inflation、Labor、Housing、Rates、Inflation Expectations、Liquidity、Conditions、FX、Credit、Sentiment、Energy。

string

required

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

string

required

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

string

required

当前可用的最早 observation 日期（YYYY-MM-DD）。

string

required

当前可用的最近 observation 日期（YYYY-MM-DD）。

string

required

Public Domain: Citation requested 或 Copyrighted: Citation required。Pre-approval required 的 series 不会出现。

string

required

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

number

固定 0，catalog 浏览免费。

number

本次调用后余额剩余的 credits。

200 OK · macro_indicator_search

{
  "data": [
    {
      "indicator": "us.cpi.headline",
      "series_id": "CPIAUCSL",
      "title": "Consumer Price Index for All Urban Consumers: All Items in U.S. City Average",
      "category": "Inflation",
      "frequency": "Monthly",
      "units": "Index 1982-1984=100",
      "observation_start": "1947-01-01",
      "observation_end": "2026-03-01",
      "copyright_status": "Public Domain: Citation requested",
      "attribution": "Source: U.S. Bureau of Labor Statistics via FRED"
    },
    {
      "indicator": "us.unemployment_rate",
      "series_id": "UNRATE",
      "title": "Unemployment Rate",
      "category": "Labor",
      "frequency": "Monthly",
      "units": "Percent",
      "observation_start": "1948-01-01",
      "observation_end": "2026-03-01",
      "copyright_status": "Public Domain: Citation requested",
      "attribution": "Source: U.S. Bureau of Labor Statistics via FRED"
    }
  ],
  "meta": {
    "creditsUsed": 0,
    "remainingCredits": 500
  }
}

每条 catalog 条目在 data 里自带 attribution 来源说明（FRED 署名）—— 展示数据时一并显示。本目录使用 FRED® API，但未获 Federal Reserve Bank of St. Louis 背书或认证。

说明

两步检索：先调 macro_indicator_search（免费）确定 alias，再调 macro_indicator_history（1 credit）取时间序列，或 macro_indicator_snapshot（免费）取最新值。catalog 不消耗 credit，可以放心多调几次。

优先用平台 indicator alias（us.cpi.headline），不要用裸 series_id（CPIAUCSL）—— alias 在 raw series 命名变化时仍然稳定，agent trace 里也更清晰。

仅支持目录内。 大约 50 个美国宏观 series。目录之外的 series_id 返回 404。需要的指标不在列表里，请提 issue。

catalog 行不是实时：observation_end 反映 LLMQuant Data 当前可用的最后已知发布时间，不一定是今天。

直接调用

HTTP / SDK 示例

{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_search",
    "arguments": { "category": "Inflation", "limit": 10 }
  }
}

import os, requests

resp = requests.get(
    "https://api.llmquantdata.com/api/macro/indicators",
    headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
    params={"category": "Inflation", "limit": 10},
).json()
for item in resp["data"]:
    print(f"{item['indicator']}  ({item['series_id']})  {item['frequency']}")

curl "https://api.llmquantdata.com/api/macro/indicators?category=Inflation&limit=10" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

完整参数参考

macro_indicator_search — 请求参数

string

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

string

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

string

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

number

default:20

返回上限。范围 1–100。

宏观历史时间序列

单个指标的时间序列（Recent 或 Range 模式）。

宏观指标快照

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

快速开始

接入

个人 Context

知识数据

Crypto 行情

预测市场

美股行情

ETF

宏观指标

SEC 申报文件

News

SEC Form 13F

它为 Agent 做什么

返回值

说明

直接调用

完整参数参考

相关接口

宏观历史时间序列

宏观指标快照

​它为 Agent 做什么

​返回值

​说明

​直接调用

​完整参数参考

​相关接口

宏观历史时间序列

宏观指标快照

它为 Agent 做什么

返回值

说明

直接调用

完整参数参考

相关接口