mostlyrightmd-economy

Economic-indicator data for the mostlyright Python SDK — CPI, PPI, nonfarm payrolls (NFP), unemployment, GDP, jobless claims, and Fed decisions — sourced from FRED/ALFRED, BLS, BEA, DOL, and the Federal Reserve, joined to Kalshi and Polymarket economy markets with publication vintages attached. Agency sources are fetched directly; their addresses resolve through the hosted manifest catalog, which requires an API key supplied by mostlyright.configure(api_key=...) or the MOSTLYRIGHT_API_KEY environment variable (subscriptions at https://app.mostlyright.md; both routes in docs/api-key.md). Imports as mostlyright.economy.

The public API includes economy.series() for historical releases, economy.snapshot() for the settlement-grade value knowable at a cutoff (the first print, never a later revision), economy.releases() for the release calendar, and economy.training_table() for joined market and release rows. series() and snapshot() exclude revisions published after the requested cutoff; training_table(as_of=...) instead raises LeakageError when a later-published row would enter the join. See docs/economy-vertical.md for every method and parameter.

Install

pip install mostlyrightmd-economy          # brings mostlyrightmd transitively

Data sources & required notices

This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. This product uses the Bureau of Economic Analysis (BEA) Data API but is not endorsed or certified by BEA. BLS, BEA, DOL, and Federal Reserve Board data are US-government works in the public domain; citations to the source agencies are appreciated. Per the BLS Terms of Service, when you publish results derived from BLS data retrieved via this SDK, cite the retrieval date and state: "BLS.gov cannot vouch for the data or analyses derived from these data after the data have been retrieved from BLS.gov." Nothing in this package is endorsed by, or implies endorsement by, any source agency or Reserve Bank.

The default path makes no FRED call (the agency sources need no key of their own; the SDK's own key — mostlyright.configure(api_key=...) or MOSTLYRIGHT_API_KEY — addresses only the manifest catalog). The FRED/ALFRED vintage path is opt-in via your own free FRED_API_KEY and is governed by the FRED® API Terms of Use (which, among other things, prohibits storing/caching FRED content and using it in ML training) — your key, your acceptance. The weekly jobless-claims fetcher also transports its bytes through FRED (ICSA/ICNSA) because DOL's machine-readable path is bot-walled. See the data-sources & licensing section for the per-source table.

Docs

See https://mostlyright.md/docs/sdk/ for quickstart and the full API reference.