Macro Indicators Catalog

Available as MCP tool: macro_indicator_search — call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.

Live free · 0 credits

What it does for your agent

macro_indicator_search returns the LLMQuant Data supported catalog of ~50 U.S. macro indicators — Inflation (CPI / PCE), Rates (Fed Funds, Treasury yields), Labor (UNRATE, payrolls), Growth (GDP), Housing, Liquidity (M2, Fed balance sheet), Financial Conditions, FX, and more. Use it as a catalog discovery step: when an agent needs to figure out which indicator alias or series_id to feed into macro_indicator_history / macro_indicator_snapshot, call this tool first to browse the catalog by category, frequency, or free-text keyword. It does not expose every possible macro series — only the curated, attribution-cleared supported catalog. Call with no parameters to list everything.

Response

MacroIndicatorCatalogItem[]

required

Curated catalog entries. Each entry is one supported indicator.

Show MacroIndicatorCatalogItem fields

string

required

Stable platform alias. Pass to macro_indicator_history / macro_indicator_snapshot (e.g. us.cpi.headline, us.rates.fed_funds).

string

required

Raw series ID (e.g. CPIAUCSL, FEDFUNDS). Also accepted by history/snapshot tools.

string

required

Human-readable indicator title.

string

required

Theme bucket: Growth, Consumption, Inflation, Labor, Housing, Rates, Inflation Expectations, Liquidity, Conditions, FX, Credit, Sentiment, Energy.

string

required

Native release cadence: Daily, Weekly, Monthly, Quarterly, Annual.

string

required

Unit string (e.g. Index 1982-1984=100, Percent, Thousands of Persons).

string

required

Earliest observation date currently available (YYYY-MM-DD).

string

required

Most recent observation date currently available (YYYY-MM-DD).

string

required

Either Public Domain: Citation requested or Copyrighted: Citation required. Pre-approval required series are not listed.

string

required

Required attribution string. Surface this when displaying the data.

number

Always 0 — catalog discovery is free.

number

Credits left on your balance after this call.

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
  }
}

Each catalog entry carries its own attribution string (FRED source notice) under data — surface it when you display the data. The catalog uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis.

Notes

Two-step pattern: call macro_indicator_search first (free) to find the right alias, then macro_indicator_history (1 credit) for time series or macro_indicator_snapshot (free) for the latest print. Catalog calls don’t burn credits, so call freely.

Prefer the platform indicator alias (us.cpi.headline) over raw series_id (CPIAUCSL) — aliases are stable across raw series naming changes and give clearer intent in agent traces.

Supported catalog only. Roughly 50 U.S. macro series. Arbitrary series_id values outside the catalog return 404. If you need a series that isn’t listed, file a request.

Catalog rows are not real-time: observation_end reflects the latest known release time available to LLMQuant Data, not necessarily today.

Direct invocation

HTTP / SDK examples

{
  "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"

Full parameter reference

macro_indicator_search — request parameters

string

Free-text keyword. Matches indicator alias, indicator title, and series_id.

string

Filter by theme. Values: Growth, Consumption, Inflation, Labor, Housing, Rates, Inflation Expectations, Liquidity, Conditions, FX, Credit, Sentiment, Energy.

string

Filter by release cadence. Values: Daily, Weekly, Monthly, Quarterly, Annual.

number

default:20

Max items returned. Range 1–100.

Macro Historical

Time-series observations for one indicator (Recent or Range mode).

Macro Snapshot

Latest print + previous value + delta for one indicator.

Getting Started

Connect

Personal Context

Knowledge Data

Crypto Prices

Prediction Markets

Equity Prices

ETF