v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Funds & ETFs

Sector SPDR relative-strength leaderboard for one window

Cross-sector ranking of US sector SPDR ETFs by trailing return over a configurable window. Walks the 11 canonical S&P GICS sector SPDRs (XLB, XLC, XLY, XLP, XLE, XLF, XLV, XLI, XLRE, XLK, XLU), extracts the matching returns_<window> field from each ETF's latest B5 snapshot (or a dated snapshot via ?date=YYYY-MM-DD), and ranks DESC. Sectors missing a return (delisted, snapshot blob absent, or ETF history shorter than the window) are surfaced in missing_symbols with a structured reason and do not contribute to leader / laggard / spread / median. Use case: UC-3 Sector Rotation Detector - capital rotation signal without N round-trips.

get/api/v1/etf/sectors/relative-strength

Query parameters

windowstring

Trailing-return window. One of: 1m, ytd, 1y, 3y, 5y, 10y. Defaults to 1m.

Trailing-return window. One of: 1m, ytd, 1y, 3y, 5y, 10y. Defaults to 1m.

datestring nullable

Optional dated snapshot (YYYY-MM-DD). Defaults to the latest cycle.

Optional dated snapshot (YYYY-MM-DD). Defaults to the latest cycle.

Response

Sector relative-strength leaderboard payload.

Example response

{
  "data": {
    "window": "1m",
    "snapshot_date": "2026-05-19",
    "sectors": [
      {
        "symbol": "XLK",
        "sector_canonical": "technology",
        "name": "Technology Select Sector SPDR Fund",
        "return_pct": 2.45,
        "rank": 1,
        "percentile": 100
      }
    ],
    "data_source": "cboe_quotes+sec_nport",
    "returns_source": "sugra_finance_historical",
    "as_of": "2026-05-23T22:30:18Z"
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}