---
title: "Returns observations of key US macro, energy, and fiscal indicators from four sources: - BLS (Bureau of Labor Statistics): the canonical labor + price statistics"
method: GET
path: "/v1/economic-indicators"
---

# Returns observations of key US macro, energy, and fiscal indicators from four sources: - BLS (Bureau of Labor Statistics): the canonical labor + price statistics

`GET /v1/economic-indicators`

## Request

- Base URL: `https://api.keyvex.com`
- URL: `https://api.keyvex.com/v1/economic-indicators`
- Auth: API key in header `x-api-key`

Returns observations of key US macro, energy, and fiscal indicators from four sources:   - BLS (Bureau of Labor Statistics): the canonical labor + price     statistics. ~20-series watchlist covering unemployment, payrolls,     wages, CPI, PPI, productivity. Most monthly, ECI/productivity     quarterly.   - FRED (Federal Reserve Economic Data, St Louis Fed): rates, money     supply, GDP, PCE inflation, mortgage rates, jobless claims, Fed     balance sheet, breakeven inflation, dollar index, consumer     sentiment. ~30-series watchlist. Some daily (rates, dollar),     weekly (mortgage, Fed assets, jobless claims), monthly, quarterly.   - EIA (Energy Information Administration): WTI + Brent crude oil     spot prices, Henry Hub natural gas, US gasoline retail price, US     crude oil production. Unique energy data not in BLS or FRED.     Mostly weekly cadence.   - FiscalData (Treasury Bureau of the Fiscal Service): total public     debt outstanding TO THE PENNY, daily, 1993→present (split into     debt held by the public vs intragovernmental); Monthly Treasury     Statement gross receipts / outlays / deficit-or-surplus; average     interest rate actually paid on each Treasury security class     (Bills/Notes/Bonds/TIPS/FRN + nonmarketable, 2001→present).  Filter to one source via `source: 'bls' | 'fred' | 'eia' | 'fiscaldata'`. Default returns all four unified — `series_id` disambiguates across catalogs.  Use this when the user asks about: unemployment rate, jobs report, nonfarm payrolls, CPI / PCE / inflation, Fed Funds rate, Treasury yields, mortgage rates, yield-curve inversion, money supply / M2, Fed balance sheet / QE / QT activity, GDP, housing starts, retail sales, consumer sentiment, jobless claims, trade balance, dollar strength, national debt / debt ceiling levels, monthly federal deficit, interest cost on the debt, or general macro context for cross-source analysis.  Categories (for filtering):   - rates          — Fed Funds, Treasury yields, mortgage, corporate bonds   - gdp            — Real + nominal GDP, GDP growth rate   - activity       — Industrial production, housing starts, retail sales   - inflation      — CPI/PPI (BLS) + PCE/Core PCE/breakevens (FRED)   - employment     — Unemployment rates (U-3, U-6), payrolls, jobless claims   - labor-force    — Labor force participation rate   - wages          — Average hourly earnings, employment cost index   - hours          — Average weekly hours   - productivity   — Nonfarm productivity, unit labor costs   - money          — M2, Fed total assets, overnight reverse repo   - debt           — Federal debt (FRED quarterly + FiscalData daily to-the-penny),                     Treasury general account   - fiscal         — MTS monthly receipts, outlays, deficit/surplus (positive =                     deficit, negative = surplus, per Treasury's sign convention)   - trade          — Trade balance, trade-weighted dollar index   - sentiment      — U Michigan Consumer Sentiment   - energy         — WTI/Brent crude, Henry Hub natural gas, retail gasoline,                     US crude production (EIA)  Period format is fixed-width per cadence so lexicographic sort = chronological:   - 2026M04 (April 2026), 2026Q01 (Q1 2026), 2026A01 (annual 2026),     2026W18 (week 18 of 2026), 2026D258 (day-of-year 258).  Set `latest_only=true` to get one record per series (the most-recent observation) — useful for 'where are things now' snapshot questions. Daily series under latest_only return only the latest day per series (deduped client-side); without it you can pull arbitrary history.  Pure-publisher posture: the unit on each series is documented in the `unit` field; we do not compute year-over-year deltas, seasonally adjust differently, or derive 'real' vs 'nominal' versions — agents do those calculations on top.

## Query parameters

- `source` 'bls' | 'fred' | 'eia' | 'fiscaldata'
- `series_id` string
- `category` 'employment' | 'labor-force' | 'wages' | 'hours' | 'inflation' | 'productivity' | 'rates' | 'gdp' | 'activity' | 'money' | 'debt' | 'fiscal' | 'trade' | 'sentiment' | 'energy'
- `period_type` 'monthly' | 'quarterly' | 'semiannual' | 'annual' | 'weekly' | 'daily'
- `since_year` integer
- `until_year` integer
- `latest_only` boolean
- `sort_by` 'period' | 'value' | 'year'
- `sort_order` 'desc' | 'asc'
- `limit` integer

## Response `200`

JSON envelope: { results: [...], count, has_more }.

## Other responses

- `400`: Invalid parameter.
- `401`: Missing or invalid API key.
- `402`: This tool requires a higher plan (upgrade_required). Retrying will not help.
- `429`: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.

---

[API](https://skmtc.dev/keyvex/apis/keyvex-api.md) · [All operations](https://skmtc.dev/keyvex/apis/keyvex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/keyvex/apis/keyvex-api/revisions/01c0210c19cd?raw)