Skip to main content
The Macro Finance API serves a curated catalog of high-value FRED / ALFRED economic series — national accounts, inflation, labor, rates, money & credit, trade, housing, business activity, consumer, and commodities/markets. Every series carries point-in-time (ALFRED) vintages so you can ask for values as they were known on a given date with no look-ahead.
This catalog is fully enumerable at runtime. The table below is the curated front page, but the live source of truth is the API itself:
# List the whole catalog (ordered by popularity), no filters needed:
curl -H "Authorization: Bearer $GDELT_CLOUD_API_KEY" \
  "https://gdeltcloud.com/api/v2/macro/series"

# Or narrow by text / agency / frequency / country:
curl -H "Authorization: Bearer $GDELT_CLOUD_API_KEY" \
  "https://gdeltcloud.com/api/v2/macro/series?search=inflation&agency=BLS"
From the MCP server, call macro_search_series with no arguments to list the catalog, then pass a series_id to macro_get_series / macro_observations.
The Macro Finance endpoints are in admin-only internal preview — non-admin API keys receive a clean 403 ADMIN_REQUIRED. Copyrighted index series (e.g. S&P 500) are quarantined and never served. Cite FRED with its non-endorsement notice when redistributing values.

​
How to look up a series

If you request a series_id that is not in the catalog (or is quarantined), the API returns 404 NOT_FOUND with a message pointing back here and to the live GET /api/v2/macro/series endpoint.

​
Curated series

Total curated series: 85 across 10 categories. (Generated from the canonical MACRO_FEATURED_SERIES list — agency is the originating statistical source.)

​
National Accounts

series_idDescriptionAgency
GDPUS GDPBEA
GDPC1US Real GDPBEA
A191RL1Q225SBEAReal GDP Growth (% chg, annualized)BEA
PCEPersonal Consumption ExpendituresBEA
PCEC96Real Personal Consumption ExpendituresBEA
PCECC96Real PCE (chained, SAAR)BEA
GPDIGross Private Domestic InvestmentBEA
GCEGovernment Consumption & InvestmentBEA
NETEXPNet Exports of Goods & ServicesBEA

​
Prices & Inflation

series_idDescriptionAgency
CPIAUCSLUS CPI (All Items)BLS
CPILFESLCore CPI (ex Food & Energy)BLS
PCEPIPCE Price IndexBEA
PCEPILFECore PCE Price IndexBEA
PPIACOPPI: All CommoditiesBLS
PPIFISPPI: Final DemandBLS
CPIENGSLCPI: EnergyBLS
CUSR0000SAF11CPI: Food at HomeBLS
T10YIE10-Year Breakeven InflationFRB
T5YIFR5Y/5Y Forward Inflation ExpectationFRB

​
Labor Market

series_idDescriptionAgency
UNRATEUS Unemployment RateBLS
U6RATEU-6 Underemployment RateBLS
PAYEMSUS Nonfarm PayrollsBLS
CIVPARTLabor Force Participation RateBLS
EMRATIOEmployment-Population RatioBLS
ICSAInitial Jobless ClaimsDOL
CCSAContinued Jobless ClaimsDOL
JTSJOLJob Openings (JOLTS)BLS
JTSHILHires (JOLTS)BLS
JTSQULQuits (JOLTS)BLS
AHETPIAvg Hourly Earnings (Production/Nonsupervisory)BLS

​
Rates & Yields

series_idDescriptionAgency
FEDFUNDSFederal Funds Rate (monthly)FRB
DFFEffective Federal Funds Rate (daily)FRB
DGS1MO1-Month Treasury YieldTreasury
DGS3MO3-Month Treasury YieldTreasury
DGS11-Year Treasury YieldTreasury
DGS22-Year Treasury YieldTreasury
DGS55-Year Treasury YieldTreasury
DGS1010-Year Treasury YieldTreasury
DGS3030-Year Treasury YieldTreasury
T10Y2Y10Y minus 2Y Treasury SpreadFRB
T10Y3M10Y minus 3M Treasury SpreadFRB
MORTGAGE30US30-Year Fixed Mortgage RateFreddie Mac
DPRIMEBank Prime Loan RateFRB

​
Money & Credit

series_idDescriptionAgency
M1SLM1 Money StockFRB
M2SLM2 Money StockFRB
BOGMBASEMonetary BaseFRB
TOTALSLTotal Consumer CreditFRB
BUSLOANSCommercial & Industrial LoansFRB
REALLNReal Estate Loans, All BanksFRB
DRCCLACBSCredit Card Delinquency RateFRB
TOTBKCRBank Credit, All Commercial BanksFRB
WALCLFed Balance Sheet: Total AssetsFRB
NFCIChicago Fed National Financial Conditions IndexFRB

​
Trade & External

series_idDescriptionAgency
BOPGSTBTrade Balance: Goods & ServicesCensus
EXPGSExports of Goods & ServicesBEA
IMPGSImports of Goods & ServicesBEA
IEABCCurrent Account BalanceBEA
DTWEXBGSUSD Broad IndexFRB
DTWEXAFEGSUSD Index: Advanced Foreign EconomiesFRB

​
Housing

series_idDescriptionAgency
HOUSTHousing StartsCensus
PERMITBuilding PermitsCensus
USSTHPIUS House Price Index (All-Transactions)FHFA
MSPUSMedian Sales Price of Houses SoldCensus
HSN1FNew One-Family Houses SoldCensus
RHORUSQ156NHomeownership RateCensus

​
Business Activity

series_idDescriptionAgency
INDPROIndustrial Production IndexFRB
TCUCapacity UtilizationFRB
DGORDERDurable Goods OrdersCensus
AMTMNOManufacturers’ New Orders: TotalCensus
BUSINVTotal Business InventoriesCensus
ISRATIOInventories-to-Sales RatioCensus

​
Consumer

series_idDescriptionAgency
RSAFSAdvance Retail SalesCensus
RSXFSRetail Sales ex Food ServicesCensus
PCEDGPCE: Durable GoodsBEA
DSPIC96Real Disposable Personal IncomeBEA
PSAVERTPersonal Saving RateBEA
UMCSENTConsumer Sentiment (UMich)U. Michigan

​
Commodities & Markets

series_idDescriptionAgency
DCOILBRENTEUBrent Crude (Europe)EIA
DCOILWTICOWTI CrudeEIA
DHHNGSPHenry Hub Natural GasEIA
VIXCLSCBOE Volatility Index (VIX)CBOE
DEXUSEUUSD/EUR Exchange RateFRB
DEXCHUSCNY/USD Exchange RateFRB
DEXJPUSJPY/USD Exchange RateFRB
DEXUSUKUSD/GBP Exchange RateFRB
This page is generated from the canonical MACRO_FEATURED_SERIES list in the GDELT Cloud codebase (nextjs_/lib/macro/tables.ts). The catalog grows over time — always treat GET /api/v2/macro/series as the live, authoritative list.