{"uid":"cap_FZWxfD_FNEWgwXe-3gazW","slug":"stationfx-ice-bofa-us-high-yield-index-option-adjusted-spread-6921a8f1","name":"StationFX ICE BofA US High-Yield Index Option-Adjusted Spread","description":"Yield spread between high-yield (junk) bonds and equivalent Treasuries. The premier measure of credit stress and risk appetite in lower-quality debt. Spikes sharply in recessions and crises. Use for risk-off detection, credit cycle timing, and recession probability models. Daily frequency.","url":"https://stationfx.com/economic-data/credit-spreads/ice-bofa-us-high-yield-index-option-adjusted-spread?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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 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"}}}}},"responseSchema":{"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":"D","source_key":"BAMLH0A0HYM2"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pltU0neX_A1pWCnGzevqu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves daily time-series data for the ICE BofA US High-Yield Index Option-Adjusted Spread — the yield premium junk bonds pay over equivalent Treasuries — with derived statistics including z-scores, percentile ranks, and rolling averages.","exampleAgentPrompt":"Pull the ICE BofA high-yield option-adjusted spread from StationFX for the last 12 months and tell me where it stands today relative to its 5-year history — include the z-score and percentile rank in JSON format.","exampleUseCases":[{"title":"Recession probability model input","prompt":"I'm building a recession probability model — grab the ICE BofA high-yield OAS daily series from StationFX for January 2020 through today in JSON format, and include the z-score and percentile rank so I can see how stressed credit markets are relative to history."},{"title":"Real-time risk-off signal detection","prompt":"Check the current high-yield credit spread on StationFX and tell me if it's spiking — I want to know today's value, whether it's above the long-run trend, and how it compares to the past 5 years on a percentile basis."},{"title":"Credit cycle timing for portfolio rebalancing","prompt":"Pull the high-yield spread data from StationFX for the past two years in toon format so I can see the rolling 3-month and 12-month averages and figure out where we are in the credit cycle before I adjust my fixed income allocation."}],"resultDescription":"Returns a JSON array of daily observations, each containing the raw OAS value in basis points, month-over-month and year-over-year absolute and percentage changes, 12-month and 5-year z-scores, 5-year percentile rank, 3-month and 12-month rolling averages, and an above-trend binary flag. Compact 'toon' format available for agent-friendly consumption.","failureModes":["Date range outside available data history returns empty array or error","Invalid date format returns a 400-level error","Unsupported fmt enum value may return an error or default to JSON","Missing required method or type fields in input object returns validation error","Network timeout or upstream data provider outage returns 5xx error","Requesting future dates returns no data or the most recent available observation"],"whenToPreferThis":"Choose this endpoint when you need the canonical measure of junk bond credit stress with rich pre-computed statistics (z-scores, percentile ranks, rolling averages) rather than raw spread data alone. Prefer it for recession detection models, credit cycle timing, and risk-off signal generation where the high-yield spread's sensitivity to financial distress is specifically needed. Prefer the investment-grade spread sibling when monitoring higher-quality credit, and the yield curve endpoint when focused on rate expectations rather than credit risk.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:46:43.817Z","isFirstParty":false,"canonicalSlug":"stationfx-ice-bofa-us-high-yield-index-option-adjusted-spread-6921a8f1"}