FRED
Federal Reserve Economic Data: macro series with point-in-time vintages, so a revised print never masquerades as the original.
Category
Walk the FRED category tree: child categories at a node, and the series that
/v1/finance:fred/categoryParameters
| Name | Type | In | Description |
|---|---|---|---|
| category | number | query | FRED category id. Omit for the root of the tree. |
| page | number | query | 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
Observations Vintage
Point-in-time observations — what a series looked like on the day it was
/v1/finance:fred/observations-vintageParameters
| Name | Type | In | Description |
|---|---|---|---|
| series | string | query | FRED series ids, comma-separated. A missing observation comes back as null, never 0. Default GDP. |
| vintages | string | query | Vintage dates, comma-separated, YYYY-MM-DD. List them with the `vintage-dates` endpoint. Series times vintages must not exceed 12. Defaults to the latest vintage. |
| from | string | query | First observation date, YYYY-MM-DD. |
| to | string | query | Last observation date, YYYY-MM-DD. |
| length | number | query | Observations to return, newest first (default 100, max 20000). |
Example response
{"project":"finance:fred", "data": {"to":"2019-12-31","from":"2019-07-01","count":2, "items": [ {"date":"2019-10-01", "values": {"GDP":21933.217 } }, {"date":"2019-07-01", "values": {"GDP":21717.171 } } ],"total":2, "series": [ "GDP" ], "columns": [ {"key":"GDP","column":"GDP_20260820","series":"GDP" } ],"dataset":"observations-vintage","missing":[],"provider":"fred","vintages":[] },"timestamp":"2026-08-20T15:00:47Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Release Dates
The US statistical release calendar — what is published on a given day, at what
/v1/finance:fred/release-datesParameters
| Name | Type | In | Description |
|---|---|---|---|
| from | string | query | First calendar date, YYYY-MM-DD. Defaults to today. |
| to | string | query | Last calendar date, YYYY-MM-DD. Defaults to `from`. |
| release | number | query | Restrict to one release id, from the `releases` endpoint. |
| year | number | query | Whole calendar year. Use with `release`; overrides `from`/`to`. |
| page | number | query | Page of the calendar, 50 entries each (default 1). |
Example response
{"project":"finance:fred", "data": {"to":"2026-08-21","from":"2026-08-17","page":1,"year":2026,"count":50, "items": [ {"url":"https://fred.stlouisfed.org/release?rid=18","date":"2026-01-02","name":"H.15 Selected Interest Rates","time":"3:15 pm","released":true,"releaseId":18 }, {"url":"https://fred.stlouisfed.org/release?rid=18","date":"2026-01-05","name":"H.15 Selected Interest Rates","time":"3:15 pm","released":true,"releaseId":18 }, {"url":"https://fred.stlouisfed.org/release?rid=18","date":"2026-01-06","name":"H.15 Selected Interest Rates","time":"3:15 pm","released":true,"releaseId":18 }, {"url":"https://fred.stlouisfed.org/release?rid=18","date":"2026-01-07","name":"H.15 Selected Interest Rates","time":"3:15 pm","released":true,"releaseId":18 }, {"url":"https://fred.stlouisfed.org/release?rid=18","date":"2026-01-08","name":"H.15 Selected Interest Rates","time":"3:15 pm","released":true,"releaseId":18 }, {"url":"https://fred.stlouisfed.org/release?rid=18","date":"2026-01-09","name":"H.15 Selected Interest Rates","time":"3:15 pm","released":true,"releaseId":18 } ],"total":null,"dataset":"release-dates","hasMore":true,"release":18,"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
Releases
The release catalogue — every statistical publication FRED redistributes,
/v1/finance:fred/releasesParameters
| Name | Type | In | Description |
|---|---|---|---|
| page | number | query | Catalogue page, 50 releases each (default 1). |
| query | string | query | Keep only releases whose name contains this text. |
Example response
{"project":"finance:fred", "data": {"page":1,"count":4, "items": [ {"url":"https://fred.stlouisfed.org/release?rid=131","name":"G.13 Selected Interest Rates","releaseId":131 }, {"url":"https://fred.stlouisfed.org/release?rid=18","name":"H.15 Selected Interest Rates","releaseId":18 }, {"url":"https://fred.stlouisfed.org/release?rid=484","name":"Key ECB Interest Rates","releaseId":484 }, {"url":"https://fred.stlouisfed.org/release?rid=94","name":"Survey of Secondary Market Prices and Yields, and Interest Rates for Home Loans","releaseId":94 } ],"query":"interest rates","total":null,"dataset":"releases","hasMore":false,"nextPage":null,"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
Series Observations
FRED observations — any economic series the St. Louis Fed publishes, by id.
/v1/finance:fred/series-observationsParameters
| Name | Type | In | Description |
|---|---|---|---|
| series | string | query | FRED series ids, comma-separated, up to 12 — the upstream drops the 13th silently. A missing observation comes back as null, never 0. Default DGS10. |
| from | string | query | First observation date, YYYY-MM-DD. Applied to every series. |
| to | string | query | Last observation date, YYYY-MM-DD. Applied to every series. |
| transformation | enum | query | Server-side transform: lin (level), chg, ch1, pch, pc1 (year-over-year %), pca, cch, cca, log. Default lin. One of lin, chg, ch1, pch, pc1, pca, cch, cca, log. |
| frequency | enum | query | Resample a higher-frequency series down to Daily, Weekly, Biweekly, Monthly, Quarterly, Semiannual or Annual. One of Daily, Weekly, Biweekly, Monthly, Quarterly, Semiannual, Annual. |
| aggregation | enum | query | How `frequency` collapses each bucket: avg, sum or eop (end of period). Default avg. One of avg, sum, eop. |
| length | number | query | Observations to return, newest first (default 100, max 20000). |
Example response
{"project":"finance:fred", "data": {"to":"2026-08-01","from":"2024-01-01","count":100, "items": [ {"date":"2026-07-31", "values": {"DFII10":2.47 } }, {"date":"2026-07-30", "values": {"DFII10":2.41 } }, {"date":"2026-07-29", "values": {"DFII10":2.41 } }, {"date":"2026-07-28", "values": {"DFII10":2.41 } }, {"date":"2026-07-27", "values": {"DFII10":2.44 } }, {"date":"2026-07-24", "values": {"DFII10":2.43 } } ],"total":674, "series": [ "DFII10" ],"dataset":"series-observations","missing":[],"provider":"fred", "resolved": [ "DFII10" ],"transformation":"lin" },"timestamp":"2026-08-20T15:00:47Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Series Search
Free-text search across the FRED catalogue — the way to turn "10-year real
/v1/finance:fred/series-searchParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Free text. Matches series titles, notes and tags. Required. Required. |
| page | number | query | Result page (default 1, upstream stops at 30). |
| sort | enum | query | Result ordering. Default relevance. One of relevance, popularity, title, frequency, units, seasonality, updated, start, end. |
Example response
{"project":"finance:fred", "data": {"page":1,"count":6, "items": [ {"url":"https://fred.stlouisfed.org/series/DFII10","title":"Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis, Inflation-Indexed","units":"Percent","series":"DFII10","frequency":"Daily","description":"View data of the inflation-adjusted interest rates on 10-year Treasury securities with a constant maturity.","observationEnd":"2026-08-18","observationStart":"2003-01-02","seasonalAdjustment":"Not Seasonally Adjusted" }, {"url":"https://fred.stlouisfed.org/series/DFII5","title":"Market Yield on U.S. Treasury Securities at 5-Year Constant Maturity, Quoted on an Investment Basis, Inflation-Indexed","units":"Percent","series":"DFII5","frequency":"Daily","description":"H.15 Statistical Release notes (https://www.federalreserve.gov/releases/h15/default.htm) and the Treasury Yield Curve Methodology (https://home.treasury.gov/policy-issues/financing…","observationEnd":"2026-08-18","observationStart":"2003-01-02","seasonalAdjustment":"Not Seasonally Adjusted" }, {"url":"https://fred.stlouisfed.org/series/DFII30","title":"Market Yield on U.S. Treasury Securities at 30-Year Constant Maturity, Quoted on an Investment Basis, Inflation-Indexed","units":"Percent","series":"DFII30","frequency":"Daily","description":"H.15 Statistical Release notes (https://www.federalreserve.gov/releases/h15/default.htm) and the Treasury Yield Curve Methodology (https://home.treasury.gov/policy-issues/financing…","observationEnd":"2026-08-18","observationStart":"2010-02-22","seasonalAdjustment":"Not Seasonally Adjusted" } ],"query":"real yield","total":null,"dataset":"series-search","hasMore":false,"nextPage":null,"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
Series
Metadata for one FRED series — units, frequency, seasonal adjustment, the
/v1/finance:fred/seriesParameters
| Name | Type | In | Description |
|---|---|---|---|
| series | string | query | One FRED series id. Case-insensitive. Default DGS10. |
Example response
{"project":"finance:fred", "data": {"url":"https://fred.stlouisfed.org/series/DFII10","notes":"For further information regarding treasury constant maturity data, please refer to the H.15 Statistical Release notes and the Treasury Yield Curve Methodology . For questions on the data, please contact the data source . For questions on FRED functionality, please contact us here .","title":"Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis, Inflation-Indexed","units":"Percent","series":"DFII10","source":"Board of Governors of the Federal Reserve System (US)","dataset":"series","license":"https://fred.stlouisfed.org/legal/#copyright-public-domain", "release": {"name":"H.15 Selected Interest Rates","releaseId":18 }, "keywords": [ "tips", "10-year", "maturity", "h15", "treasury", "securities" ],"provider":"fred","frequency":"Daily","copyrighted":false,"description":"View data of the inflation-adjusted interest rates on 10-year Treasury securities with a constant maturity.","lastUpdated":"2026-08-19T15:16:00-05:00", "categoryPath": [ {"name":"Money, Banking, & Finance","categoryId":32991 }, {"name":"Interest Rates","categoryId":22 }, {"name":"Treasury Inflation-Indexed Securities","categoryId":82 }, {"name":"Treasury Constant Maturity","categoryId":115 } ],"nextReleaseDate":"2026-08-20","seasonalAdjustment":"Not Seasonally Adjusted","lastObservationDate":"2026-08-18","lastObservationValue":2.41,"lastObservationPeriod":"2026-08-18" },"timestamp":"2026-08-20T15:00:47Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Sources
The publishers behind the catalogue — statistical agencies, central banks and
/v1/finance:fred/sourcesParameters
| Name | Type | In | Description |
|---|---|---|---|
| page | number | query | Catalogue page, 50 sources each (default 1). |
| query | string | query | Keep only sources whose name contains this text. |
Example response
{"project":"finance:fred", "data": {"page":1,"count":12, "items": [ {"url":"https://fred.stlouisfed.org/source?soid=1","name":"Board of Governors of the Federal Reserve System (US)","sourceId":1 }, {"url":"https://fred.stlouisfed.org/source?soid=91","name":"Federal Reserve Bank of Atlanta","sourceId":91 }, {"url":"https://fred.stlouisfed.org/source?soid=54","name":"Federal Reserve Bank of Chicago","sourceId":54 }, {"url":"https://fred.stlouisfed.org/source?soid=90","name":"Federal Reserve Bank of Cleveland","sourceId":90 }, {"url":"https://fred.stlouisfed.org/source?soid=89","name":"Federal Reserve Bank of Dallas","sourceId":89 }, {"url":"https://fred.stlouisfed.org/source?soid=46","name":"Federal Reserve Bank of Kansas City","sourceId":46 } ],"query":"federal reserve","total":null,"dataset":"sources","hasMore":false,"nextPage":null,"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
Vintage Dates
Every vintage ALFRED holds for one series — the dates on which that series was
/v1/finance:fred/vintage-datesParameters
| Name | Type | In | Description |
|---|---|---|---|
| series | string | query | One FRED/ALFRED series id. Case-insensitive. Default GDP. |
| length | number | query | Vintage dates to return, newest first (default 50, max 2000). |
Example response
{"project":"finance:fred", "data": {"count":50, "items": [ "2026-07-30", "2026-06-25", "2026-05-28", "2026-04-30", "2026-04-09", "2026-03-13" ],"total":413,"series":"GDP","dataset":"vintage-dates","provider":"fred","firstVintage":"1991-12-04","latestVintage":"2026-07-30" },"timestamp":"2026-08-20T15:00:47Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:fred", "category", { category: 115, page: 1 });
FRED
Federal Reserve Economic Data: macro series with point-in-time vintages, so a revised print never masquerades as the original.
Walk the FRED category tree: child categories at a node, and the series that
/v1/…fred/categoryTry it
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 });