--- name: web-production-60258.up.railway.app description: This host provides structured access to US macroeconomic data sourced from FRED and BEA, covering snapshot values, period-over-period deltas, derived indicators, and recent data release discovery. All endpoints return discrete point-in-time or period-comparison values for major US macro series. No real-time streaming, intraday, or non-US data is available. host: web-production-60258.up.railway.app --- # web-production-60258.up.railway.app This host serves agents that need structured US macroeconomic context — inflation, labor market, interest rates, GDP, and money supply — without building FRED API integrations directly. It offers four complementary endpoints: a broad snapshot, a change/delta view, a derived-indicators view, and a release-discovery feed. It is narrowly scoped to US macro fundamentals and is not a general financial data or market-data provider. ## When to use this host Use this host when an agent needs structured, point-in-time US macroeconomic data — current indicator levels, period-over-period changes, derived signals, or recent FRED release discovery — in a single call without managing FRED API credentials or series IDs directly. Do not use this host for historical time-series queries spanning multiple periods; it returns only the latest or a single prior-period comparison. Do not use it for non-US macro data, real-time or intraday market feeds, equity or commodity prices, or raw Federal Reserve series data. For historical FRED series retrieval, a direct FRED API integration or a host exposing /macro/series endpoints would be more appropriate. For market pricing or asset-level data, route to a dedicated market-data host. ## Capabilities ### Current Macro State Provides the latest observed values across the full set of tracked US macro indicators, giving agents a single-call baseline of economic conditions. - **`fetch-macro-snapshot`** — Returns the latest values for 13 key US macroeconomic indicators including GDP, CPI, PCE, unemployment, payrolls, Fed Funds Rate, Treasury yields, yield curve spread, TIPS real yield, and M2 money supply. ### Derived and Computed Indicators Returns pre-computed indicators such as real yields, breakeven inflation, yield curve spread, wage growth, and real GDP growth rate that require combining raw series. - **`fetch-macro-derived-indicators`** — Returns computed U.S. macroeconomic indicators: 10Y real yield (TIPS), 10Y breakeven inflation, 10Y-2Y yield curve spread, average hourly earnings, and BEA real GDP growth rate. ### Period-Over-Period Change Analysis Enables comparison of current vs. prior-period values and percentage changes for key macro series over a configurable lookback window. - **`fetch-macro-delta`** — Returns period-over-period change (current value, previous value, and % change) for up to 8 key macroeconomic indicators including CPI, unemployment, payrolls, Fed Funds rate, 10Y yield, yield curve, and M2 money supply. ### Release Discovery Identifies which FRED macro datasets have been updated in the last 30 days, allowing agents to prioritize fresh data before querying specific series. - **`fetch-macro-releases`** — Returns a deduplicated list of FRED economic data releases from the last 30 days, sorted by recency, with release ID, name, and publication date. ## Workflows ### Fresh-Data-First Macro Briefing *Use when an agent needs to build a current macroeconomic briefing and wants to confirm which indicators have been recently updated before pulling values.* 1. **`fetch-macro-releases`** — Discover which FRED series have been published or revised in the last 30 days to identify the freshest indicators. 2. **`fetch-macro-snapshot`** — Pull the latest observed values for all 13 tracked indicators to populate the briefing with current data. 3. **`fetch-macro-derived-indicators`** — Augment the briefing with computed indicators — real yields, breakeven inflation, yield curve spread, and GDP growth — that require cross-series calculation. ### Macro Trend and Context Analysis *Use when an agent needs to assess both the current level and the directional change of key macro indicators, such as when evaluating monetary policy stance or inflation trajectory.* 1. **`fetch-macro-snapshot`** — Establish the current absolute values for all tracked indicators as a baseline. 2. **`fetch-macro-delta`** — Retrieve period-over-period changes and percentage moves for targeted series to identify direction and magnitude of shifts. 3. **`fetch-macro-derived-indicators`** — Cross-check derived signals — real yield, breakeven inflation, yield curve shape — to contextualize the raw changes. ## Skill reference ### `fetch-macro-snapshot` **Macro Snapshot** — Returns the latest values for 13 key US macroeconomic indicators including GDP, CPI, PCE, unemployment, payrolls, Fed Funds Rate, Treasury yields, yield curve spread, TIPS real yield, and M2 money supply. *Use when:* Use when an agent needs a current, structured overview of US macroeconomic conditions across GDP, inflation, labor market, interest rates, and money supply in a single call. *Not for:* Do not use for historical time-series data or trend analysis across multiple periods; this returns only the single latest observed value per indicator. Not suitable for non-US macro data. **Returns:** Returns a JSON object with 13 macro indicator entries (GDP, CPI, PCE, unemployment, payrolls, Fed Funds Rate, 2Y/10Y Treasury yields, yield curve spread, TIPS real yield, M2), each with seriesId, label, latest value, observation date, and unit. **Example:** `GET https://web-production-60258.up.railway.app/macro/snapshot` --- ### `fetch-macro-releases` **Macro Releases** — Returns a deduplicated list of FRED economic data releases from the last 30 days, sorted by recency, with release ID, name, and publication date. *Use when:* Use when an agent needs to discover which macroeconomic datasets have been updated recently before querying specific series or snapshot endpoints, or when building a list of fresh indicators to analyze. *Not for:* Do not use to retrieve the actual data values for a series; use /macro/series or /macro/snapshot instead. Not suitable for releases older than 30 days. **Returns:** Returns a JSON object with asOf timestamp, count of 37, and a releases array listing each FRED release by ID, name, and publication date over the last 30 days. **Example:** `GET https://web-production-60258.up.railway.app/macro/releases` --- ### `fetch-macro-delta` **Macro Delta** — Returns period-over-period change (current value, previous value, and % change) for up to 8 key macroeconomic indicators including CPI, unemployment, payrolls, Fed Funds rate, 10Y yield, yield curve, and M2 money supply. *Use when:* Use when an agent needs to compare current vs. prior-period values and percentage changes for major US macroeconomic series, such as when analyzing inflation trends, labor market shifts, or monetary policy changes over a configurable lookback window. *Not for:* Do not use for real-time streaming price feeds or intraday market data; this endpoint returns discrete period-over-period snapshots of macro indicators, not tick-level or high-frequency data. **Inputs:** - `series` (string) — Series name or FRED ID to diff (e.g. "inflation", "CPIAUCSL"). Omit to receive all 8 default key series. - `periods` (integer) — Number of periods to look back for comparison. Minimum 1, maximum 24, default 4. **Returns:** Returns an array of 8 macro series delta objects (CPI, Core CPI, Unemployment, Payrolls, Fed Funds, 10Y Yield, Yield Curve, M2), each with current and previous period observations and a percentage change value. **Example:** `GET https://web-production-60258.up.railway.app/macro/delta?periods=4` --- ### `fetch-macro-derived-indicators` **Macro Derived Indicators** — Returns computed U.S. macroeconomic indicators: 10Y real yield (TIPS), 10Y breakeven inflation, 10Y-2Y yield curve spread, average hourly earnings, and BEA real GDP growth rate. *Use when:* Use when an agent needs a single-call snapshot of key derived macro indicators for economic analysis, modeling, or market context — specifically real yields, inflation expectations, yield curve shape, wage data, and GDP growth. *Not for:* Do not use for raw Federal Reserve or BEA series data; this endpoint returns only pre-computed derived indicators. Not suitable for historical time-series queries or non-U.S. macro data. **Returns:** Returns a data object with five derived macro indicators: real GDP growth (latest and prior quarter), 10Y TIPS real yield, 10Y breakeven inflation, 10Y-2Y yield curve spread, and average hourly earnings, each with value, date, unit, and description fields. **Example:** `GET https://web-production-60258.up.railway.app/macro/derived` ---