KeyVex Economic Indicators API

The Economic Indicators API from KeyVex — 1 operation(s) for economic indicators.

GitHub OpenAPI

Operations 1

GET /v1/economic-indicators Returns observations of key US macro, energy, and fiscal indicators from four… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-economic-indicators-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

keyvex-com-economic-indicators-api-openapi.yml Raw ↑
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