Twinkle HubTwinkle Hub

美聯儲 FRED 經濟時序搜尋

us_search_fred_series

🇺🇸 États-Unislecture seule

關鍵字 / Keywords: 美聯儲 經濟數據 GDP 失業率 CPI 通膨 利率 時間序列 FRED Federal Reserve St Louis Fed economic time series macro unemployment inflation interest rate treasury monetary consumer price

Scope: US Federal Reserve Economic Data (FRED) · 816,000+ macro / monetary / financial time series curated by the St. Louis Fed.

Natural-language search across FRED series titles. Returns series_id + human-readable title + units + frequency + last observation date + popularity — the fields agents need to pick the right series before pulling observations.

Endpoint: https://api.stlouisfed.org/fred/series/search?search_text=…

Args: query: free-text query (e.g. "unemployment", "consumer price index", "10-year treasury", "federal funds rate"). limit: max hits to return (default 10, hard cap 100). order_by: FRED sort key. Common values: "search_rank" (default · text relevance), "popularity", "frequency", "observation_start", "observation_end", "last_updated".

Requires US_FRED_API_KEY environment variable (free from https://fred.stlouisfed.org/docs/api/api_key.html, ~1 min signup with email). Response includes license warning that FRED aggregates third-party series (OECD, Eurostat, ISM, …) which carry origin-jurisdiction copyright — check per-series copyright (surfaced in observations responses) before redistributing.

Paramètres

NomTypeDescription
query *string
limitinteger
order_bystring
Schéma JSON brut
{
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    },
    "order_by": {
      "default": "search_rank",
      "title": "Order By",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "us_search_fred_seriesArguments",
  "type": "object"
}

Comment appeler

Amorce — paramètres dans le tableau
us_search_fred_series({ query: "…" })