agent-data
Start free
Catalog / FRED

FRED API

fred.stlouisfed.org

Read-only live access to Federal Reserve Economic Data (FRED): series metadata, observations, series search, top-level categories, and category details.

  • finance
  • fred
  • economic-data
  • time-series
Connect your agent Call over HTTP
5 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the FRED API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Search Series

Search keywords.

Optional parameters 1

One-based results page.

View call pricing
cURL · Series search
curl --request GET --get 'https://api.agent-data.dev/fred-stlouisfed-org/v1/series/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'query=inflation'

Endpoints

Inputs and response fields for every endpoint in this API.

GETSeries by series id/v1/series/{series_id}

Get Series

Input

series_idRequiredPath · string

FRED series identifier, such as GDP.

Example: GDP

Response

notesstring
titlestring
unitsstring
sourcestring
frequencystring
series_idstring
last_updatedstring
observation_endstring
observation_startstring
seasonal_adjustmentstring
GETSeries by series id observations/v1/series/{series_id}/observations

Get Series Observations

Input

series_idRequiredPath · string

FRED series identifier, such as GDP.

Example: GDP

end_dateOptionalQuery · string | null

Optional inclusive observation end date.

Example: 2020-12-31

frequencyOptionalQuery · string | null

Optional FRED frequency aggregation, such as q or m.

Example: q

start_dateOptionalQuery · string | null

Optional inclusive observation start date.

Example: 2020-01-01

transformationOptionalQuery · "lin" | "chg" | "ch1" | "pch" | "pc1" | "pca" | "cch" | "cca" | "log" | null

Optional observation transformation.

Example: lin

Response

countinteger
series_idstring
observationsobject[]
observations[].datestring
observations[].valuestring
GETCategories/v1/categories

Get Categories

Input

No input parameters.

Response

itemsobject[]
items[].namestring
items[].category_idinteger
GETCategories by category id/v1/categories/{category_id}

Get Category

Input

category_idRequiredPath · integer, min: 1

Numeric FRED category ID.

Example: 1

Response

namestring
seriesobject[]
series[].titlestring
series[].series_idstring
category_idinteger
subcategoriesobject[]
subcategories[].namestring
subcategories[].category_idinteger

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.