Query first prints and revisions for economic releases.

Fetch CPI, PPI, payrolls, unemployment, GDP, jobless claims, and Fed decisions. Choose the settlement first print or every revision. Each row keeps its unit, publication time, vintage, and agency source.

economic_series.py
 from mostlyright import economy

rows = economy.series(
    "cpi",
    "2024-01-01",
    "2025-06-01",
    vintages="all",
)

rows[[
    "period", "released_value",
    "knowledge_time", "source",
]] 

Economic series, release calendars, and as-of snapshots.

Read the release, inspect when it was published, and query the value that was available before a historical cutoff.

Economic series

Query CPI, PPI, payrolls, unemployment, GDP, jobless claims, and Fed decisions.

Release calendars

Read the period, scheduled UTC publication time, and agency for each release.

As-of snapshots

Return the qualifying first print available by a historical cutoff.

One schema for first prints and revisions.

Every row identifies the indicator, period, released value, unit, publication time, vintage, and agency source.

economy.series() published vintage
indicator cpi_yoy
period 2025-05
released_value 2.4
units percent
knowledge_time 2025-06-11T12:30Z
source bls
Indicator and period
indicator names the series; period states the month, quarter, or decision it describes.
Value and unit
released_value stays beside the documented unit used by the source.
Publication and vintage
release_datetime and knowledge_time record when each value became available.
Agency source
Every row identifies FRED, BLS, BEA, DOL, or the Federal Reserve as applicable.

First prints and revisions stay separate.

Request the qualifying first print or the complete revision history. A later value adds a new vintage instead of replacing the row your historical research used.

compare_vintages.py
 # One qualifying first print per period
first_prints = economy.series(
    "cpi", start, end,
    vintages="settlement",
)

# Every value published later
all_revisions = economy.series(
    "cpi", start, end,
    vintages="all",
)

then = economy.snapshot(
    "cpi", as_of=cutoff,
) 
  1. 01
    Settlement viewOne qualifying first print per period
  2. 02
    Revision historyEvery published update as a new row
  3. 03
    As-of snapshotThe value available by a UTC cutoff
  4. 04
    Release calendarPeriod, scheduled UTC time, and agency

From indicator to historical rows.

Choose the series and vintage policy. Receive the published values with the fields needed to reproduce a historical decision.

  1. 01

    Choose the indicator

    Start with inflation, employment, GDP, claims, or a Fed decision.

  2. 02

    Choose the vintage view

    Request the settlement first print, every revision, or an as-of snapshot.

  3. 03

    Use the returned rows

    Keep values, units, publication times, vintage times, and agency sources attached.

Query economic releases without losing revision history.

// contact

Talk to the team

Self-serve signup lives at app.mostlyright.md. This form is for everything it cannot do: procurement, invoicing, custom licensing, or anything you want to ask first. We reply by email.

I'm a

One email from the team. No spam.