Reference · News and economy
get_economy
U.S. economic indicators from FRED (inflation, jobs, growth, housing, rates, credit, markets, government debt). Without series_id: every indicator's latest and prior figure and next release date. With series_id: that indicator's history as date,value rows.
GET https://api.fundalyze.ai/api/public/v1/get_economyMCPget_economyParameters
| Parameter | Type | Default | Description |
|---|---|---|---|
series_id | string | — | One indicator's history, by FRED series id: CPIAUCSL, CPILFESL, PCEPI, PCEPILFE, PPIFIS, CUSR0000SAH1, GASREGW, DCOILWTICO, T5YIE, T10YIE, UNRATE, U6RATE, PAYEMS, ICSA, CCSA, JTSJOL, CIVPART, CES0500000003, A191RL1Q225SBEA, RSAFS, INDPRO, TCU, DGORDER, PCEC96, DSPIC96, PSAVERT, UMCSENT, BOPGSTB, HOUST, PERMIT, HSN1F, HPIPONM226S, MORTGAGE30US, DFF, SOFR, DPRIME, DGS3MO, DGS2, DGS5, DGS10, DGS30, T10Y2Y, T10Y3M, WALCL, M2SL, TOTALSL, DRCCLACBS, NFCI, VIXCLS, DTWEXBGS, GFDEBTN, GFDEGDQ188S, MTSDS133FMS, SAHMREALTIME. Omit for the latest value of every indicator. |
range | stringone of 1Y, 5Y, 10Y, MAX | 5Y | History window when series_id is given: 1Y, 5Y, 10Y or MAX. |
Example
A real call and its answer. Replace fdz_live_YOUR_KEY with your key, or set FUNDALYZE_API_KEY for the Python and JavaScript versions.
curl -H "Authorization: Bearer fdz_live_YOUR_KEY" "https://api.fundalyze.ai/api/public/v1/get_economy?series_id=UNRATE&range=1Y"import os
import requests
response = requests.get(
"https://api.fundalyze.ai/api/public/v1/get_economy",
params={
"series_id": "UNRATE",
"range": "1Y",
},
headers={"Authorization": f"Bearer {os.environ['FUNDALYZE_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
answer = response.json()
print(answer["text"])
print("Calls left today:", response.headers.get("X-Quota-Remaining"))const params = new URLSearchParams()
params.append("series_id", "UNRATE")
params.append("range", "1Y")
const response = await fetch(`https://api.fundalyze.ai/api/public/v1/get_economy?${params}`, {
headers: { Authorization: `Bearer ${process.env.FUNDALYZE_API_KEY}` },
})
const answer = await response.json()
if (!response.ok) throw new Error(`${response.status}: ${answer.detail}`)
console.log(answer.text)
console.log('Calls left today:', response.headers.get('X-Quota-Remaining'))The same call as an MCP tools/call: what an assistant sends.
{
"name": "get_economy",
"arguments": {
"series_id": "UNRATE",
"range": "1Y"
}
}Response
Generated from live data on Oct 7, 2026; figures change as filings arrive. Rows trimmed to the first 5 for the docs: points had 11.
What an assistant reads (and what MCP returns).
UNRATE · Unemployment rate · level · 1Y · resolution M · unit %
date,value
2025-11-01,4.5
2025-12-01,4.4
2026-01-01,4.3
2026-02-01,4.4
2026-03-01,4.3
... 6 more rows in the full answer (trimmed for the docs)
This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis.
More: https://fundalyze.ai/economy?open=UNRATEThe same content as JSON (REST).
{
"id": "UNRATE",
"label": "Unemployment rate",
"basis": "level",
"unit": {
"prefix": "",
"suffix": "%"
},
"range": "1Y",
"resolution": "M",
"points": [
{
"date": "2025-11-01",
"value": 4.5
},
{
"date": "2025-12-01",
"value": 4.4
},
{
"date": "2026-01-01",
"value": 4.3
},
{
"date": "2026-02-01",
"value": 4.4
},
{
"date": "2026-03-01",
"value": 4.3
}
],
"source_url": "https://fred.stlouisfed.org/series/UNRATE",
"citation": null,
"notice": "This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis."
}Fields of data
What each field of data means. rows[].field is a field of each row in the rows list.
| Field | Meaning |
|---|---|
as_of | Without series_id: date of the newest figure in the snapshot (ISO date). |
indicators | Without series_id: one row per indicator. |
indicators[].id | FRED series id (pass it as series_id for the history). |
indicators[].label | What the indicator measures. |
indicators[].basis | How the value is expressed: blank = the level, else the change named (year over year, month over month). |
indicators[].latest | The latest figure, formatted with its unit (e.g. 4.3%). |
indicators[].date | Date of the latest figure (ISO date). |
indicators[].prior | The figure before it, formatted the same way. |
indicators[].prior_date | Date of the prior figure (ISO date). |
indicators[].next_release | Next scheduled release date (ISO date), or null. |
citations | Citations some series require when shown (copyrighted sources). |
notice | FRED's notice that it does not endorse Fundalyze; show it with the data. |
id | With series_id: the FRED series id. |
label | With series_id: what the indicator measures. |
basis | With series_id: level, or the change the values express. |
unit | With series_id: {prefix, suffix} to print around each value, e.g. suffix % for a rate, prefix $ for a price. |
range | With series_id: the window returned (1Y, 5Y, 10Y or MAX). |
resolution | With series_id: spacing of the points, FRED's frequency code: D daily, W weekly, M monthly, Q quarterly (beyond 1Y, daily and weekly series keep each month's last observation and report M). |
points | With series_id: the history, oldest first. |
points[].date | Observation date (ISO date). |
points[].value | The value on that date, in the series' unit. |
source_url | With series_id: the series on fred.stlouisfed.org. |
citation | With series_id: the required citation for a copyrighted series, else null. |
The link
Every answer ends with More: <link>, and REST returns the same URL as link: the fundalyze.ai page where the figures can be checked (here, fundalyze.ai/economy?open=UNRATE). Cite it when you show the data to others, as the attribution rules ask.
Errors
A bad parameter is a 400 naming it, an unknown ticker a 404, a busy key or a used-up day a 429. Every status and message: Errors.
This page as Markdown, for language models and scripts: /developers/md/reference/get_economy