# StationFX 10Y-2Y Treasury Yield Curve Spread > StationFX 10Y-2Y Treasury Yield Curve Spread is a paid API for AI agents from stationfx.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-02). Returns the daily spread between 10-year and 2-year U.S. Treasury yields — the most widely watched yield curve recession indicator — with pre-computed statistical enrichments. ## Facts - Endpoint: GET https://stationfx.com/economic-data/cross-signal/10y-2y-treasury-spread-yield-curve?utm_source=zero.xyz - Price: $0.008/call - Payment: x402 - Status: unknown - Last checked: 2026-10-02 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/stationfx-10y-2y-treasury-yield-curve-spread-7d9ddce2 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m86ySFbskv99cdiyyG5Bg Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability stationfx-10y-2y-treasury-yield-curve-spread-7d9ddce2 ``` Example prompt: Pull the latest 10Y-2Y Treasury yield spread from StationFX and tell me if the curve is currently inverted, plus where today's spread ranks on a 5-year percentile basis. ## When to prefer this Choose this endpoint when you need the canonical U.S. yield curve inversion indicator with pre-enriched statistical context (z-scores, percentile ranks, rolling averages) rather than computing the spread yourself from raw FRED data. It is ideal for macro dashboards, recession-monitoring agents, or fixed-income strategy signals where the 10Y-2Y spread is a primary input. If you need raw individual Treasury yields (DGS10 or DGS2 separately), prefer the sibling endpoints for those series. For credit risk rather than rate risk, prefer the corporate or high-yield spread endpoints on the same platform. ## Known failure modes - Date range outside available history returns empty data array - Invalid date format (non-YYYY-MM-DD) may return 400 error - Requesting future dates returns no data or the most recent available observation - Payment not included or insufficient USDC balance results in 402 Payment Required - Invalid fmt enum value may cause a 400 or unrecognized response format - Very narrow date ranges (single day) may return one record or none if that day is a weekend/holiday (Treasury markets closed) ## How this service works Spread between 10-year and 2-year Treasury yields. The most widely watched yield curve indicator — inversion has preceded every U.S. recession since 1955 with a 6-18 month lead. Positive = normal curve, negative = inverted (recession warning). Pre-computed daily from DGS10 and DGS2. ## Output Returns a time-series array of daily 10Y-2Y Treasury spread observations. Each record includes the raw spread value (in percentage points, where negative = inverted), month-over-month and year-over-year absolute and percentage changes, trailing 12-month and 5-year z-scores, 5-year percentile rank, 3-month and 12-month rolling averages, and a flag indicating whether the spread is above long-run trend. Data is pre-computed daily from FRED DGS10 and DGS2 series. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http", "description": "Always \"http\" for HTTP endpoints" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string", "description": "HTTP method. Always GET for StationFX query endpoints" }, "queryParams": { "type": "object", "properties": { "fmt": { "enum": [ "json", "toon" ], "type": "string", "description": "Response format. Use toon for compact agent-friendly output." }, "fields": { "type": "string", "description": "Comma-separated metric names" }, "date_to": { "type": "string", "description": "End date YYYY-MM-DD" }, "date_from": { "type": "string", "description": "Start date YYYY-MM-DD" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string", "description": "Response format. Always \"json\" (or \"toon\" if fmt=toon was requested)" }, "example": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "Observation date YYYY-MM-DD" }, "value": { "type": "number", "description": "Raw observed value in series units" }, "mom_pct": { "type": "number", "description": "Month-over-month % change" }, "yoy_pct": { "type": "number", "description": "Year-over-year % change" }, "zscore_5y": { "type": "number", "description": "Z-score relative to trailing 5 years" }, "mom_change": { "type": "number", "description": "Month-over-month absolute change" }, "yoy_change": { "type": "number", "description": "Year-over-year absolute change" }, "zscore_12m": { "type": "number", "description": "Z-score relative to trailing 12 … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "Observation date YYYY-MM-DD" }, "value": { "type": "number", "description": "Raw observed value in series units" }, "mom_pct": { "type": "number", "description": "Month-over-month % change" }, "yoy_pct": { "type": "number", "description": "Year-over-year % change" }, "zscore_5y": { "type": "number", "description": "Z-score relative to trailing 5 years" }, "mom_change": { "type": "number", "description": "Month-over-month absolute change" }, "yoy_change": { "type": "number", "description": "Year-over-year absolute change" }, "zscore_12m": { "type": "number", "description": "Z-score relative to trailing 12 months" }, "above_trend": { "type": "integer", "description": "1 if value is above long-run trend, else 0" }, "pct_rank_5y": { "type": "number", "description": "Percentile rank over trailing 5 years (0-100)" }, "rolling_3m_avg": { "type": "number", "description": "3-month rolling average" }, "rolling_12m_avg": { "type": "number", "description": "12-month rolling average" }, "trend_direction": { "type": "integer", "description": "Trend: 1 rising, -1 falling, 0 flat" } } }, "description": "Observations ordered by date ascending" }, "meta": { "type": "object", "description": "Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields" } }, "description": "Station f(x) response with metadata and pre-computed derived metrics" }, "example": { "data": [ { "date": "2024-01-01", "value": 5.33, "mom_pct": 0, "yoy_change": 0.5, "zscore_12m": 1.2, "trend_direction": 1 } ], "meta": { "frequency": "M", "source_key": "SERIES_ID" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stationfx-10y-2y-treasury-yield-curve-spread-7d9ddce2/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from stationfx.com](https://www.zero.xyz/host/stationfx.com/llms.txt)