Skip to main content
← All datasets

Industry Macro Context

Public

Macro context series: rates, yield curve spreads, breakeven inflation, mortgage rates, unemployment, CPI and GDP.

About this dataset

Industry Macro Context is a Public dataset in the Industry & Macro group of the BankRegReports Data API. The response carries 14 documented fields, sourced from FRED + FFIEC; mortgage rates: Freddie Mac Primary Mortgage Market Survey.

One row per quarter end, OLDEST first. Default 20 quarters; max 200. Cached 24h, quarterly macro doesn't change intraday.

Endpoint

GET /api/v1/industry/macro/

Parameters

Name Required Description
quarters optional Number of recent quarters (default 20, max 200). e.g. 20

Response fields

Field Type Description
quarter_end string (date), nullable
fed_funds_rate string (decimal), nullable
sofr_rate string (decimal), nullable
yield_curve_10y2y string (decimal), nullable
yield_curve_10y3m string (decimal), nullable
breakeven_5y string (decimal), nullable
breakeven_10y string (decimal), nullable
mortgage_30y string (decimal), nullable
mortgage_15y string (decimal), nullable
unemployment_rate string (decimal), nullable
cpi_yoy_pct string (decimal), nullable
core_cpi_yoy_pct string (decimal), nullable
real_gdp_qoq_ann_pct string (decimal), nullable
nonfarm_payrolls_yoy_pct string (decimal), nullable

Example request

curl "https://api.bankregreports.com/api/v1/industry/macro/" \
  -H "Authorization: Bearer $BANKREG_API_TOKEN"

Responses are JSON in a {"data": ..., "meta": {...}} envelope. Get a token on the setup page.

Example response shape

A successful call returns HTTP 200 with a JSON body. Each row in data carries the fields below, shown with their documented types rather than sample values.

{
  "data": [
    {
      "quarter_end": "string (date)",
      "fed_funds_rate": "string (decimal)",
      "sofr_rate": "string (decimal)",
      "yield_curve_10y2y": "string (decimal)",
      "yield_curve_10y3m": "string (decimal)",
      "breakeven_5y": "string (decimal)",
      "breakeven_10y": "string (decimal)",
      "mortgage_30y": "string (decimal)"
      ... 6 more fields
    }
  ],
  "meta": { ... }
}

When to use it

Industry Macro Context sits in the Industry & Macro group of the Data API. Reach for it when your work needs this data straight from the API: it comes back as JSON you can load into a notebook, a spreadsheet or a scheduled pipeline, with the dataset key industry_macro naming it the same way in the REST path, the Python SDK and the OpenAPI document.

Access and authentication

This dataset is in the Public tier. Send your API token in the Authorization header as a Bearer token, using a GET request to the endpoint above. The Free plan is the first plan that includes it. Check the plan comparison for request limits, and the data update schedule for when new filings reach the API.

Related datasets

Keep going

Browse every dataset, follow the setup walkthrough to make a first call, use the Excel add-in for formulas, or connect an assistant through the MCP server.

Python SDK

Install with pip install bankregreports and set BANKREG_API_TOKEN to your key.

import bankregreports

brr = bankregreports.BankReg()  # reads BANKREG_API_TOKEN
result = brr.industry_macro()
Powered by BankRegReports API