Macro
GET /v1/macro/{series}One official macro series as a single document. We include a series only when its source’s own terms clearly allow resale. Today that’s two series from the U.S. Bureau of Labor Statistics.
curl -H "X-API-Key: $BELFORT_API_KEY" \ https://belfort-data-api.vercel.app/v1/macro/cpi_u_all_items_saseries |
BLS series | What it is |
|---|---|---|
cpi_u_all_items_sa |
CUSR0000SA0 |
Consumer Price Index for All Urban Consumers, all items, seasonally adjusted |
unemployment_rate_sa |
LNS14000000 |
Unemployment rate, seasonally adjusted |
Any other series name gets a 404. The route takes no query parameters.
The document
Section titled “The document”| Field | Meaning |
|---|---|
series, series_id |
Our name for the series, and the BLS series ID. |
title, unit |
What it measures, and in what unit. |
seasonal_adjustment, revision_status |
Whether it’s seasonally adjusted, and its revision status. |
keep_vintages |
false: see below. |
source_url, fetched_at |
Where we read it, and when. |
points |
The readings: each with date, value, unit, source_url, fetched_at, seasonal_adjustment and revision_status. |
What to expect
Section titled “What to expect”- Latest readings only. CPI and unemployment are revised after they’re first published. We keep the latest published reading for each date, not the earlier versions.
- Cite the source. BLS data is in the public domain, and BLS asks that you cite the Bureau of Labor Statistics as the source.
- Other series are left out on purpose. We read the U.S. Treasury’s daily yield curve and the New York Fed’s effective federal funds rate, but their terms don’t clearly allow resale, so they aren’t served.