Sign in

v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Economics

Get Macro Series

Fetch a single macro time-series from FRED.

country: ISO-2 lowercase code (us, eu, gb, jp) section: indicator key - see GET /api/macro/catalog for full list

Query parameters: start - observation start YYYY-MM-DD (activates range mode) end - observation end YYYY-MM-DD last_n - return N most recent observations (default: catalog default_last_n) limit - deprecated alias for last_n transform - comma-separated transforms; must match series unit_type: index/money: mom_pct, yoy_pct, qoq_ann_pct rate_pct daily: dod_bps, wow_bps rate_pct monthly: mom_pp, yoy_pp spread_pct: dod_bps, wow_bps count: mom_abs, yoy_abs Legacy aliases: mom → mom_pct, yoy → yoy_pct, 3m_ann → qoq_ann_pct order - "desc" (newest first, default) or "asc"

Mode semantics: last_n mode - returns the N most recent observations (default when no start given) range mode - returns all observations in [start, end] up to max_last_n cap

Response is cached in-memory (TTL by frequency): daily series - 6 hours monthly series - 24 hours quarterly series - 72 hours Anomalous results (mid-series nulls in monthly/quarterly) are not cached.

get/api/v1/macro/{country}/{section}

Path parameters

countrystring required

Country code (ISO 3166-1 alpha-2/alpha-3) or slug.

Country code (ISO 3166-1 alpha-2/alpha-3) or slug.

sectionstring required

Report section.

Report section.

Query parameters

startstring nullable

Start date (YYYY-MM-DD).

Start date (YYYY-MM-DD).

endstring nullable

End date (YYYY-MM-DD) or pagination end.

End date (YYYY-MM-DD) or pagination end.

last_ninteger nullable

Return last N observations per series.

Return last N observations per series.

limitinteger nullable

Maximum number of records to return.

Maximum number of records to return.

transformstring nullable

Data transformation (lin, chg, pch).

Data transformation (lin, chg, pch).

orderstring

Sort order.

Sort order.

Response

FRED macro time series for the given country and section with optional transforms.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}