Module fred 

Macro-economic data sources: FRED API and US Treasury yield curve.

Requires the macro feature flag.

FRED (Federal Reserve Economic Data)

Access 800k+ macro time series (CPI, Fed Funds Rate, M2, GDP, etc.). Requires a free API key from https://fred.stlouisfed.org/docs/api/api_key.html.

Call init once at startup before using series.

US Treasury Yields

Daily yield curve data from the US Treasury Department. No key required. Use treasury_yields directly.

Quick Start

use finance_query::fred;

// FRED: initialize with API key, then query any series
fred::init("your-fred-api-key")?;
let cpi = fred::series("CPIAUCSL").await?;
println!("CPI observations: {}", cpi.observations.len());

// Treasury: no key required
let yields = fred::treasury_yields(2025).await?;
println!("Latest 10Y yield: {:?}", yields.last().and_then(|y| y.y10));

Re-exports

pub use models::MacroObservation;

pub use models::MacroSeries;

pub use models::TreasuryYield;

Modules

models

Data models for macro-economic sources (FRED, US Treasury).

Functions

init

Initialize the global FRED client with an API key.

init_with_timeout

Initialize the FRED client with a custom timeout.

series

Fetch all observations for a FRED data series.

treasury_yields

Fetch US Treasury yield curve data for the given year.