API reference / US macro

US macro

Fed funds, GDP, money supply, inflation (CPI/PCE), the jobs market, market-signal series (VIX, yield-curve & credit spreads, recession odds), and the macro bundle.

9 endpoints. Pay per call in USDC via x402 with no account, or get unlimited calls for $99/mo. Every response is shaped { ticker, data, source, as_of }.

GET/api/v1/fed-funds$0.01

Effective federal funds rate (the Fed's policy rate), monthly, with recent history

The effective federal funds rate — the Fed's benchmark policy rate that anchors every other US interest rate — as a monthly average in percent, with the latest value, prior month, month-over-month and year-over-year change, and recent history. No ticker needed. The rate every rate-sensitive analysis starts from. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/fed-funds
Response type (TypeScript)
interface FedFundsResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: number;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-05-01T00:00:00.000Z",
  "series_id": "FEDFUNDS",
  "title": "Effective Federal Funds Rate",
  "unit": "percent",
  "frequency": "monthly",
  "latest": {
    "date": "2026-05-01",
    "value": 3.63
  },
  "prior": {
    "date": "2026-04-01",
    "value": 3.64
  },
  "change": -0.01,
  "change_percent": -0.27,
  "yoy_percent": -16.17,
  "history": [
    {
      "date": "2026-05-01",
      "value": 3.63
    },
    {
      "date": "2026-04-01",
      "value": 3.64
    },
    {
      "date": "2026-03-01",
      "value": 3.64
    },
    {
      "date": "2026-02-01",
      "value": 3.64
    },
    {
      "date": "2026-01-01",
      "value": 3.64
    },
    {
      "date": "2025-12-01",
      "value": 3.72
    },
    {
      "date": "2025-11-01",
      "value": 3.88
    },
    {
      "date": "2025-10-01",
      "value": 4.09
    },
    {
      "date": "2025-09-01",
      "value": 4.22
    },
    {
      "date": "2025-08-01",
      "value": 4.33
    },
    {
      "date": "2025-07-01",
      "value": 4.33
    },
    {
      "date": "2025-06-01",
      "value": 4.33
    },
    {
      "date": "2025-05-01",
      "value": 4.33
    },
    {
      "date": "2025-04-01",
      "value": 4.33
    },
    {
      "date": "2025-03-01",
      "value": 4.33
    },
    {
      "date": "2025-02-01",
      "value": 4.33
    },
    {
      "date": "2025-01-01",
      "value": 4.33
    },
    {
      "date": "2024-12-01",
      "value": 4.48
    },
    {
      "date": "2024-11-01",
      "value": 4.64
    },
    {
      "date": "2024-10-01",
      "value": 4.83
    },
    {
      "date": "2024-09-01",
      "value": 5.13
    },
    {
      "date": "2024-08-01",
      "value": 5.33
    },
    {
      "date": "2024-07-01",
      "value": 5.33
    },
    {
      "date": "2024-06-01",
      "value": 5.33
    }
  ]
}
GET/api/v1/gdp$0.01

US real GDP, quarterly, with quarter-over-quarter and year-over-year change

US real Gross Domestic Product, quarterly, in billions of chained 2017 dollars (seasonally adjusted annual rate), with the latest reading, prior quarter, quarter-over-quarter and year-over-year change, and recent history. No ticker needed. The broad measure of economic output for macro-aware analysis. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/gdp
Response type (TypeScript)
interface GdpResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: number;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-01-01T00:00:00.000Z",
  "series_id": "GDPC1",
  "title": "Real Gross Domestic Product",
  "unit": "billions_of_chained_2017_usd_saar",
  "frequency": "quarterly",
  "latest": {
    "date": "2026-01-01",
    "value": 24152.656
  },
  "prior": {
    "date": "2025-10-01",
    "value": 24055.749
  },
  "change": 96.907,
  "change_percent": 0.4,
  "yoy_percent": 2.57,
  "history": [
    {
      "date": "2026-01-01",
      "value": 24152.656
    },
    {
      "date": "2025-10-01",
      "value": 24055.749
    },
    {
      "date": "2025-07-01",
      "value": 24026.834
    },
    {
      "date": "2025-04-01",
      "value": 23770.976
    },
    {
      "date": "2025-01-01",
      "value": 23548.21
    },
    {
      "date": "2024-10-01",
      "value": 23586.542
    },
    {
      "date": "2024-07-01",
      "value": 23478.57
    },
    {
      "date": "2024-04-01",
      "value": 23286.508
    },
    {
      "date": "2024-01-01",
      "value": 23082.119
    },
    {
      "date": "2023-10-01",
      "value": 23033.78
    },
    {
      "date": "2023-07-01",
      "value": 22840.989
    },
    {
      "date": "2023-04-01",
      "value": 22580.499
    },
    {
      "date": "2023-01-01",
      "value": 22439.607
    },
    {
      "date": "2022-10-01",
      "value": 22278.345
    },
    {
      "date": "2022-07-01",
      "value": 22125.625
    },
    {
      "date": "2022-04-01",
      "value": 21967.045
    },
    {
      "date": "2022-01-01",
      "value": 21932.71
    },
    {
      "date": "2021-10-01",
      "value": 21988.737
    },
    {
      "date": "2021-07-01",
      "value": 21617.828
    },
    {
      "date": "2021-04-01",
      "value": 21440.929
    },
    {
      "date": "2021-01-01",
      "value": 21082.134
    },
    {
      "date": "2020-10-01",
      "value": 20791.917
    },
    {
      "date": "2020-07-01",
      "value": 20558.879
    },
    {
      "date": "2020-04-01",
      "value": 19077.992
    }
  ]
}
GET/api/v1/money-supply$0.01

US M2 money supply, monthly, with month-over-month and year-over-year change

US M2 money stock, monthly, in billions of dollars (seasonally adjusted), with the latest value, prior month, month-over-month and year-over-year change, and recent history. No ticker needed. A liquidity gauge watched for inflation and risk-asset context. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/money-supply
Response type (TypeScript)
interface MoneySupplyResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: number;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series_id": "M2SL",
  "title": "M2 Money Stock",
  "unit": "billions_of_usd",
  "frequency": "monthly",
  "latest": {
    "date": "2026-04-01",
    "value": 22804.5
  },
  "prior": {
    "date": "2026-03-01",
    "value": 22686.4
  },
  "change": 118.1,
  "change_percent": 0.52,
  "yoy_percent": 4.72,
  "history": [
    {
      "date": "2026-04-01",
      "value": 22804.5
    },
    {
      "date": "2026-03-01",
      "value": 22686.4
    },
    {
      "date": "2026-02-01",
      "value": 22627
    },
    {
      "date": "2026-01-01",
      "value": 22429.3
    },
    {
      "date": "2025-12-01",
      "value": 22353.5
    },
    {
      "date": "2025-11-01",
      "value": 22277.4
    },
    {
      "date": "2025-10-01",
      "value": 22245.1
    },
    {
      "date": "2025-09-01",
      "value": 22170.3
    },
    {
      "date": "2025-08-01",
      "value": 22086.9
    },
    {
      "date": "2025-07-01",
      "value": 22020
    },
    {
      "date": "2025-06-01",
      "value": 21938.8
    },
    {
      "date": "2025-05-01",
      "value": 21834
    },
    {
      "date": "2025-04-01",
      "value": 21775.7
    },
    {
      "date": "2025-03-01",
      "value": 21693.7
    },
    {
      "date": "2025-02-01",
      "value": 21613.5
    },
    {
      "date": "2025-01-01",
      "value": 21548.1
    },
    {
      "date": "2024-12-01",
      "value": 21485.9
    },
    {
      "date": "2024-11-01",
      "value": 21452.2
    },
    {
      "date": "2024-10-01",
      "value": 21331.9
    },
    {
      "date": "2024-09-01",
      "value": 21269.5
    },
    {
      "date": "2024-08-01",
      "value": 21186.8
    },
    {
      "date": "2024-07-01",
      "value": 21095.3
    },
    {
      "date": "2024-06-01",
      "value": 21068.4
    },
    {
      "date": "2024-05-01",
      "value": 21020.7
    }
  ]
}
GET/api/v1/inflation$0.02

US CPI inflation: headline and core index with year-over-year percent

US consumer price inflation from the Bureau of Labor Statistics: the latest headline CPI-U and core (ex food and energy) index levels with year-over-year percent change, plus recent monthly history. No ticker needed. Use for macro-aware analysis without leaving for a separate data source. Sourced from US BLS.

Example request
GET /api/v1/inflation
Response type (TypeScript)
interface InflationResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  headline: {
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  core: {
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  history: Array<{
    date: string;
    period_name: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_bls",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series": "cpi_u_us_city_average",
  "unit": "index_1982_84=100",
  "headline": {
    "latest_index": 333.02,
    "latest_month": "2026-04",
    "yoy_percent": 3.81
  },
  "core": {
    "latest_index": 335.803,
    "latest_month": "2026-04",
    "yoy_percent": 2.75
  },
  "history": [
    {
      "date": "2026-04",
      "period_name": "April",
      "value": 333.02
    },
    {
      "date": "2026-03",
      "period_name": "March",
      "value": 330.213
    },
    {
      "date": "2026-02",
      "period_name": "February",
      "value": 326.785
    },
    {
      "date": "2026-01",
      "period_name": "January",
      "value": 325.252
    },
    {
      "date": "2025-12",
      "period_name": "December",
      "value": 324.054
    },
    {
      "date": "2025-11",
      "period_name": "November",
      "value": 324.122
    },
    {
      "date": "2025-09",
      "period_name": "September",
      "value": 324.8
    },
    {
      "date": "2025-08",
      "period_name": "August",
      "value": 323.976
    },
    {
      "date": "2025-07",
      "period_name": "July",
      "value": 323.048
    },
    {
      "date": "2025-06",
      "period_name": "June",
      "value": 322.561
    },
    {
      "date": "2025-05",
      "period_name": "May",
      "value": 321.465
    },
    {
      "date": "2025-04",
      "period_name": "April",
      "value": 320.795
    },
    {
      "date": "2025-03",
      "period_name": "March",
      "value": 319.799
    }
  ]
}
GET/api/v1/pce$0.02

PCE inflation (the Fed's preferred gauge): headline and core index with year-over-year

US PCE (Personal Consumption Expenditures) price inflation — the Fed's preferred inflation gauge — with the latest headline and core (ex food and energy) index levels, each with year-over-year percent change, plus recent monthly history. No ticker needed. Complements the CPI endpoint with the measure the Fed actually targets. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/pce
Response type (TypeScript)
interface PceResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  headline: {
    series_id: string;
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  core: {
    series_id: string;
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series": "pce_price_index",
  "unit": "index_2017=100",
  "headline": {
    "series_id": "PCEPI",
    "latest_index": 130.902,
    "latest_month": "2026-04-01",
    "yoy_percent": 3.77
  },
  "core": {
    "series_id": "PCEPILFE",
    "latest_index": 129.63,
    "latest_month": "2026-04-01",
    "yoy_percent": 3.29
  },
  "history": [
    {
      "date": "2026-04-01",
      "value": 130.902
    },
    {
      "date": "2026-03-01",
      "value": 130.381
    },
    {
      "date": "2026-02-01",
      "value": 129.52
    },
    {
      "date": "2026-01-01",
      "value": 129.002
    },
    {
      "date": "2025-12-01",
      "value": 128.576
    },
    {
      "date": "2025-11-01",
      "value": 128.152
    },
    {
      "date": "2025-10-01",
      "value": 127.871
    },
    {
      "date": "2025-09-01",
      "value": 127.625
    },
    {
      "date": "2025-08-01",
      "value": 127.293
    },
    {
      "date": "2025-07-01",
      "value": 126.96
    },
    {
      "date": "2025-06-01",
      "value": 126.743
    },
    {
      "date": "2025-05-01",
      "value": 126.38
    },
    {
      "date": "2025-04-01",
      "value": 126.15
    },
    {
      "date": "2025-03-01",
      "value": 125.941
    },
    {
      "date": "2025-02-01",
      "value": 125.921
    },
    {
      "date": "2025-01-01",
      "value": 125.417
    },
    {
      "date": "2024-12-01",
      "value": 124.979
    },
    {
      "date": "2024-11-01",
      "value": 124.637
    },
    {
      "date": "2024-10-01",
      "value": 124.494
    },
    {
      "date": "2024-09-01",
      "value": 124.164
    },
    {
      "date": "2024-08-01",
      "value": 123.889
    },
    {
      "date": "2024-07-01",
      "value": 123.736
    },
    {
      "date": "2024-06-01",
      "value": 123.539
    },
    {
      "date": "2024-05-01",
      "value": 123.348
    }
  ]
}
GET/api/v1/labor-market$0.02

US labor market: unemployment, participation, payrolls, and wage growth

US labor-market headline indicators from the Bureau of Labor Statistics: the unemployment rate, labor force participation rate, total nonfarm payrolls, and average hourly earnings, each with its latest value and change from the prior month. No ticker needed. Sourced from US BLS.

Example request
GET /api/v1/labor-market
Response type (TypeScript)
interface LaborMarketResponse {
  source: string;
  as_of: string;
  series: string;
  metrics: Array<{
    metric: string;
    unit: string;
    latest_value: number;
    latest_month: string;
    prior_value: number;
    change: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_bls",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series": "us_labor_market_headline",
  "metrics": [
    {
      "metric": "unemployment_rate",
      "unit": "percent",
      "latest_value": 4.3,
      "latest_month": "2026-04",
      "prior_value": 4.3,
      "change": 0
    },
    {
      "metric": "labor_force_participation_rate",
      "unit": "percent",
      "latest_value": 61.8,
      "latest_month": "2026-04",
      "prior_value": 61.9,
      "change": -0.1
    },
    {
      "metric": "nonfarm_payrolls",
      "unit": "thousands_of_jobs",
      "latest_value": 158736,
      "latest_month": "2026-04",
      "prior_value": 158621,
      "change": 115
    },
    {
      "metric": "avg_hourly_earnings",
      "unit": "usd_per_hour",
      "latest_value": 37.41,
      "latest_month": "2026-04",
      "prior_value": 37.35,
      "change": 0.06
    }
  ]
}
GET/api/v1/treasury-yields$0.01

US Treasury par yield curve (1mo to 30yr) for the latest day or a date range

The daily US Treasury par yield curve (Constant Maturity Treasury rates) for every maturity from 1 month to 30 years, in percent. Defaults to the latest published day; pass `?limit=` for more recent days (max 250) and `?year=YYYY`. No ticker needed. Use for the risk-free rate, rate-sensitivity context, and yield-curve inversion in macro-aware analysis.

Example request
GET /api/v1/treasury-yields
Response type (TypeScript)
interface TreasuryYieldsResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  maturities: string[];
  count: number;
  rates: Array<{
    date: string;
    rates: {
      "1mo": number;
      "1.5mo": number;
      "2mo": number;
      "3mo": number;
      "4mo": number;
      "6mo": number;
      "1yr": number;
      "2yr": number;
      "3yr": number;
      "5yr": number;
      "7yr": number;
      "10yr": number;
      "20yr": number;
      "30yr": number;
    };
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-06-01T00:00:00.000Z",
  "series": "daily_treasury_par_yield_curve",
  "unit": "percent",
  "maturities": [
    "1mo",
    "1.5mo",
    "2mo",
    "3mo",
    "4mo",
    "6mo",
    "1yr",
    "2yr",
    "3yr",
    "5yr",
    "7yr",
    "10yr",
    "20yr",
    "30yr"
  ],
  "count": 1,
  "rates": [
    {
      "date": "2026-06-01",
      "rates": {
        "1mo": 3.72,
        "1.5mo": 3.71,
        "2mo": 3.73,
        "3mo": 3.78,
        "4mo": 3.8,
        "6mo": 3.79,
        "1yr": 3.83,
        "2yr": 4.05,
        "3yr": 4.09,
        "5yr": 4.18,
        "7yr": 4.32,
        "10yr": 4.47,
        "20yr": 4.99,
        "30yr": 4.99
      }
    }
  ]
}
GET/api/v1/fred/{series}$0.01

Key market-signal macro series from the Fed (FRED): VIX, yield-curve & credit spreads, breakevens, jobless claims, sentiment, mortgage rate, recession odds

Pull a key market-signal macro series from the Federal Reserve (FRED) by slug: vix, yield-curve-10y-2y, yield-curve-10y-3m, high-yield-spread, ig-spread, breakeven-10y, real-yield-10y, jobless-claims, consumer-sentiment, mortgage-30y, financial-conditions, recession-probability. Each returns the latest value, prior, change, year-over-year, and recent history. No ticker needed.

Example request
GET /api/v1/fred/vix
Response type (TypeScript)
interface FredSeriesResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: null;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-06-04T00:00:00.000Z",
  "series_id": "VIXCLS",
  "title": "CBOE Volatility Index (VIX)",
  "unit": "index",
  "frequency": "daily",
  "latest": {
    "date": "2026-06-04",
    "value": 15.4
  },
  "prior": {
    "date": "2026-06-03",
    "value": 16.06
  },
  "change": -0.66,
  "change_percent": -4.11,
  "yoy_percent": null,
  "history": [
    {
      "date": "2026-06-04",
      "value": 15.4
    },
    {
      "date": "2026-06-03",
      "value": 16.06
    },
    {
      "date": "2026-06-02",
      "value": 15.77
    },
    {
      "date": "2026-06-01",
      "value": 16.05
    },
    {
      "date": "2026-05-29",
      "value": 15.32
    },
    {
      "date": "2026-05-28",
      "value": 15.74
    },
    {
      "date": "2026-05-27",
      "value": 16.29
    },
    {
      "date": "2026-05-26",
      "value": 17.01
    },
    {
      "date": "2026-05-25",
      "value": 16.59
    },
    {
      "date": "2026-05-22",
      "value": 16.7
    },
    {
      "date": "2026-05-21",
      "value": 16.76
    },
    {
      "date": "2026-05-20",
      "value": 17.44
    },
    {
      "date": "2026-05-19",
      "value": 18.06
    },
    {
      "date": "2026-05-18",
      "value": 17.82
    },
    {
      "date": "2026-05-15",
      "value": 18.43
    },
    {
      "date": "2026-05-14",
      "value": 17.26
    },
    {
      "date": "2026-05-13",
      "value": 17.87
    },
    {
      "date": "2026-05-12",
      "value": 17.99
    },
    {
      "date": "2026-05-11",
      "value": 18.38
    },
    {
      "date": "2026-05-08",
      "value": 17.19
    },
    {
      "date": "2026-05-07",
      "value": 17.08
    },
    {
      "date": "2026-05-06",
      "value": 17.39
    },
    {
      "date": "2026-05-05",
      "value": 17.38
    },
    {
      "date": "2026-05-04",
      "value": 18.29
    }
  ]
}
GET/api/v1/macro$0.05

US macro dashboard in one call: Fed funds, CPI, PCE, jobs, GDP, and the Treasury yield curve

The US macro backdrop in one call: the federal funds rate, CPI and PCE inflation, the labor market (unemployment, payrolls, wages), real GDP, and the Treasury yield curve. No ticker needed. Replaces six macro calls (fed-funds + inflation + pce + labor-market + gdp + treasury-yields) at a lower combined price. Spans FRED, BLS, Treasury; sections degrade independently.

Example request
GET /api/v1/macro

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.