FRED Economic Data API
Federal Reserve Economic Data — search series, get metadata, and pull time series observations with computed statistics.
GET
/api/fred/search
4 sats
Search FRED economic data series. Returns simplified metadata with human-readable frequency and units labels.
| Parameter | Type | Description |
|---|---|---|
query | string | Search query (e.g., "GDP", "unemployment rate") |
limit | int | Max results to return (default: 10, max: 100) |
curl "https://agent-commerce.store/api/fred/search?query=GDP&limit=5"
GET
/api/fred/series/{seriesId}
5 sats
Get series metadata and recent observations in a single call. Includes computed basic statistics.
| Parameter | Type | Description |
|---|---|---|
seriesId | string | FRED series ID (e.g., "GDP", "UNRATE", "CPIAUCSL") |
curl "https://agent-commerce.store/api/fred/series/UNRATE"
GET
/api/fred/series/{seriesId}/data
5 sats
Get time series observation data with optional date range. Computes min, max, average, and latest change.
| Parameter | Type | Description |
|---|---|---|
seriesId | string | FRED series ID (e.g., "GDP", "UNRATE") |
start | string | Start date in YYYY-MM-DD format (optional) |
end | string | End date in YYYY-MM-DD format (optional) |
curl "https://agent-commerce.store/api/fred/series/UNRATE/data?start=2020-01-01&end=2024-01-01"
Usage tips: Use the search endpoint first to find series IDs. Common series: GDP, UNRATE (unemployment rate), CPIAUCSL (CPI inflation), DFF (federal funds rate), SP500. Dates use YYYY-MM-DD format. Series IDs are case-sensitive and typically uppercase.
Value-Add
- Simplified series metadata with human-readable frequency and units labels
- Single-call series info + latest data points combined
- Computed basic statistics: min, max, average, latest change
- Consistent date formatting across all responses
- Missing values (FRED "." notation) filtered and handled
- Data source attribution included in every response
Upstream Source
FRED API — Federal Reserve Bank of St. Louis. API key required (managed by this service).