Loading...
Loading...
API gratuita de la Reserva Federal (FRED): 840K+ series macroeconómicas (GDP, CPI, tasas, empleo, M2, VIX, treasuries).
npx skill4agent add gauss314/skills fred-macrohttps://api.stlouisfed.org/fredimport os
API_KEY = os.getenv("FRED_API_KEY") # Recomendado
# o directamente para pruebas:
# API_KEY = "TU_API_KEY_AQUI"| Límite | Valor |
|---|---|
| Requests por minuto | 120 req/min |
| Requests por día | Ilimitado (sin límite diario explícito) |
| Máx observaciones por request | 100,000 |
| Máx series por request | Depende del endpoint (generalmente 1) |
| Costo | Completamente GRATIS |
observation_startobservation_end| Endpoint | Descripción | Auth |
|---|---|---|
| Valores históricos de una serie | API Key |
| Buscar series por texto | API Key |
| Metadatos de una serie | API Key |
| Categorías de una serie | API Key |
| Release asociado a una serie | API Key |
| Endpoint | Descripción |
|---|---|
| Información de una categoría |
| Subcategorías |
| Categorías relacionadas |
| Series en una categoría |
| Información de un release |
| Fechas de un release |
| Series en un release |
| Endpoint | Descripción |
|---|---|
| Buscar tags |
| Tags relacionados |
| Series con un tag específico |
| Tags de una serie |
| Endpoint | Descripción |
|---|---|
| Lista de fuentes de datos |
| Información de una fuente |
| Endpoint | Descripción |
|---|---|
| Series actualizadas recientemente |
| Opciones de ajuste estacional |
&file_type=json{
"realtime_start": "2026-06-01",
"realtime_end": "2026-06-01",
"observation_start": "1954-07-01",
"observation_end": "2026-06-01",
"units": "lin",
"count": 864,
"observations": [
{
"realtime_start": "2026-06-01",
"realtime_end": "2026-06-01",
"date": "1954-07-01",
"value": "."
},
{
"realtime_start": "2026-06-01",
"realtime_end": "2026-06-01",
"date": "1954-10-01",
"value": "126.8"
}
]
}Nota: valoresindican dato no disponible (N/A)."."
| ID | Categoría | Ejemplos |
|---|---|---|
| 0 | Todas las categorías (raíz) | — |
| 32991 | Population, Employment, & Labor Markets | UNRATE, PAYEMS, NFP |
| 32992 | National Income & Product Accounts | GDP, GDPC1, GNP |
| 32993 | Consumer Price Indexes (CPI) | CPIAUCSL, CPILFESL |
| 32994 | Producer Price Indexes (PPI) | PPIACO, PPIFIS |
| 32995 | Interest Rates | FEDFUNDS, DGS10, DGS2 |
| 32996 | Money, Banking, & Finance | M2SL, M1SL, TOTBKCR |
| 32997 | International Trade | BOPGSTB |
| 33000 | U.S. Regional Data | Estadísticas estatales |
| 33001 | Academic Data | Datos académicos |
import requests
API_KEY = "TU_API_KEY"
url = "https://api.stlouisfed.org/fred/series/observations"
params = {
"series_id": "GDP",
"api_key": API_KEY,
"file_type": "json",
"observation_start": "2020-01-01",
"observation_end": "2025-12-31"
}
r = requests.get(url, params=params)
data = r.json()
for obs in data["observations"]:
if obs["value"] != ".":
print(obs["date"], obs["value"])params = {
"api_key": API_KEY,
"file_type": "json",
"search_text": "inflation",
"search_type": "full_text", # o "series_id"
"limit": 10
}
r = requests.get("https://api.stlouisfed.org/fred/series/search", params=params)import pandas as pd
import requests
def fetch_fred(series_id, api_key, start="2020-01-01"):
url = "https://api.stlouisfed.org/fred/series/observations"
params = {"series_id": series_id, "api_key": api_key,
"file_type": "json", "observation_start": start}
r = requests.get(url, params=params)
df = pd.DataFrame(r.json()["observations"])
df["date"] = pd.to_datetime(df["date"])
df["value"] = pd.to_numeric(df["value"], errors="coerce")
return df.set_index("date")["value"]
gdp = fetch_fred("GDP", API_KEY)
cpi = fetch_fred("CPIAUCSL", API_KEY)
fedfunds = fetch_fred("FEDFUNDS", API_KEY)| Script | Descripción |
|---|---|
| fetch_series.py | Descarga una o más series FRED en CSV/JSON/Parquet |
| search_series.py | Busca series FRED por texto, categoría o tag |
| download_multiple.py | Descarga batches de series predefinidas por categoría |
| Serie | Descripción | Frecuencia |
|---|---|---|
| PIB Nominal (Billions $) | Trimestral |
| PIB Real (Billions chained $) | Trimestral |
| IPC General (CPI All Items) | Mensual |
| IPC Subyacente (Core CPI) | Mensual |
| PCE Subyacente (Core PCE) | Mensual |
| Tasa de Fondos Federales | Diaria |
| Tasa de Fondos Federales (efectiva) | Diaria |
| Treasury a 10 años | Diaria |
| Treasury a 2 años | Diaria |
| Spread 10y-2y (curva invertida) | Diaria |
| Tasa de Desempleo | Mensual |
| Nóminas no agrícolas (Nonfarm Payrolls) | Mensual |
| M2 Money Supply | Mensual |
| M1 Money Supply | Mensual |
| VIX (volatilidad S&P 500) | Diaria |
| Spread BAA - 10y (credit spread) | Diaria |
| Ventas Minoristas | Mensual |
| Producción Industrial | Mensual |
| Viviendas Iniciadas | Mensual |
| Tasa Hipoteca 30 años | Semanal |
file_type=jsonobservation_start"."FRED_API_KEY