Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: KeyVex Economic Indicators API
version: 0.102.0
termsOfService: https://keyvex.com/terms
description: 'US public financial-disclosure data — congressional trades, insider filings (Form 4), lobbying, Treasury auctions, member profiles. Requires an API key — create a free one at https://keyvex.com and send it as the header `x-api-key: `. A free key returns most public-record datasets (one year of history; no market-price data and a few heavy datasets are on paid plans only), capped at 60 requests/day; paid plans raise the caps. The daily allowance resets at midnight Eastern.'
servers:
- url: https://api.keyvex.com
security:
- ApiKeyAuth: []
tags:
- name: Economic Indicators
paths:
/v1/economic-indicators:
get:
operationId: get_economic_indicators
summary: Returns observations of key US macro, energy, and fiscal indicators from four…
description: '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, jobless claims, Fed balance sheet, breakeven inflation, dollar index. ~26-series watchlist. Some daily (rates, dollar), weekly (Fed assets, jobless claims), monthly, quarterly. Mortgage rates, Moody''s corporate bond yields and University of Michigan consumer sentiment are NOT carried: their owners license them, and we do not hold a license. - 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, yield-curve inversion, money supply / M2, Fed balance sheet / QE / QT activity, GDP, housing starts, retail sales, 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, yield spread - 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 — no series at present (UMich sentiment needs a license) - 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.'
parameters:
- name: source
in: query
required: false
description: Filter to one source. Omit to query all four. BLS = canonical labor + price stats. FRED = rates, money, GDP, PCE inflation. EIA = energy prices + production. FiscalData = Treasury debt to the penny, MTS budget totals, avg interest rates on the debt.
schema:
type: string
enum:
- bls
- fred
- eia
- fiscaldata
- name: series_id
in: query
required: false
description: 'Exact series ID. BLS examples: ''LNS14000000'' (U-3), ''CES0000000001'' (payrolls), ''CUUR0000SA0'' (CPI). FRED examples: ''DFF'' (Fed Funds), ''DGS10'' (10Y Treasury), ''PCEPILFE'' (Core PCE), ''M2SL'' (M2), ''WALCL'' (Fed assets). FiscalData examples: ''FISCAL-DEBT-TOTAL-DAILY'' (daily national debt), ''FISCAL-MTS-DEFICIT-MONTHLY'' (monthly deficit/surplus).'
schema:
type: string
- name: category
in: query
required: false
description: Bucket filter.
schema:
type: string
enum:
- employment
- labor-force
- wages
- hours
- inflation
- productivity
- rates
- gdp
- activity
- money
- debt
- fiscal
- trade
- sentiment
- energy
- name: period_type
in: query
required: false
description: Cadence filter.
schema:
type: string
enum:
- monthly
- quarterly
- semiannual
- annual
- weekly
- daily
- name: since_year
in: query
required: false
description: Calendar-year lower bound (inclusive).
schema:
type: integer
- name: until_year
in: query
required: false
description: Calendar-year upper bound (inclusive).
schema:
type: integer
- name: latest_only
in: query
required: false
description: When true, return only the most-recent observation per series. Useful for 'current state' snapshots.
schema:
type: boolean
- name: sort_by
in: query
required: false
description: Default period (chronological).
schema:
type: string
enum:
- period
- value
- year
- name: sort_order
in: query
required: false
description: Default desc.
schema:
type: string
enum:
- desc
- asc
- name: limit
in: query
required: false
description: Default 50, max 500.
schema:
type: integer
responses:
'200':
description: 'JSON envelope: { results: [...], count, has_more }.'
'400':
description: Invalid parameter.
'401':
description: Missing or invalid API key.
'402':
description: This tool requires a higher plan (upgrade_required). Retrying will not help.
'429':
description: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.
tags:
- Economic Indicators
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key