FRED

Federal Reserve Economic Data: macro series with point-in-time vintages, so a revised print never masquerades as the original.

10 endpoints560 calls10/10 passing
Get API key

Walk the FRED category tree: child categories at a node, and the series that

GET/v1/…fred/category
passing · 1.0s6h cache

Try it

Checking your keys…

Parameters

category

number · query · optional

FRED category id. Omit for the root of the tree.

page

number · query · optional

Page of the series listing (default 1).

Example response

{"project":"finance:fred",  "data": {"page":1,"count":50,    "items": [      {"url":"https://fred.stlouisfed.org/series/DGS10","title":"Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis","units":"Percent","series":"DGS10","frequency":"Daily","observationEnd":"2026-08-18","observationStart":"1962-01-02","seasonalAdjustment":"Not Seasonally Adjusted"      },      {"url":"https://fred.stlouisfed.org/series/GS10","title":"Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis","units":"Percent","series":"GS10","frequency":"Monthly","observationEnd":"Jul 2026","observationStart":"Apr 1953","seasonalAdjustment":"Not Seasonally Adjusted"      },      {"url":"https://fred.stlouisfed.org/series/WGS10YR","title":"Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis","units":"Percent","series":"WGS10YR","frequency":"Weekly","observationEnd":"2026-08-14","observationStart":"1962-01-05","seasonalAdjustment":"Not Seasonally Adjusted"      }    ],"total":null,"dataset":"category","hasMore":true,"category":115,    "children": [      {"name":"Money, Banking, & Finance","categoryId":32991      },      {"name":"Interest Rates","categoryId":22      }    ],"nextPage":2,"provider":"fred"  },"timestamp":"2026-08-20T15:00:47Z"}

Errors

  • 401Missing or invalid x-api-key
  • 404Not found or private
  • 429Rate limit or monthly quota reached

Code

const data = await client.run(  "finance:fred",  "category",  { category: 115, page: 1 });