Sign in

v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Equities Indices

S&P 500 constituents (membership metadata)

Returns the full S&P 500 constituent list (503 entries) with GICS sector + sub-industry classifications + date-added + SEC EDGAR CIK identifiers. Sourced from public Wikipedia (CC-BY-SA-4.0) membership announcements via daily auto-refresh blob; hardcoded 503-entry snapshot serves as defence-in-depth fallback when the blob is unavailable. Filter by ?sector=<GICS sector> or ?sub_industry=<GICS sub-industry> to narrow the list. Use case: UC-2 Earnings Whiplash Map filters earnings calendar by SPX members; UC-1 Institutional Footprint cross-references CIK to /sec/13f endpoints. The data_source field exposes whether the response was served from the Wikipedia blob (blob_wikipedia) or the hardcoded fallback (hardcoded_fallback).

get/api/v1/equities/sp500/constituents

Query parameters

sectorstring nullable

Optional GICS Level 1 sector filter. Case-sensitive. Returns 400 with the canonical 11-sector list when the value is not in the GICS taxonomy.

Example:Information Technology

Optional GICS Level 1 sector filter. Case-sensitive. Returns 400 with the canonical 11-sector list when the value is not in the GICS taxonomy.

sub_industrystring nullable

Optional GICS Level 4 sub-industry filter. Case-sensitive. Returns 400 with the observed catalog when the value is not present in the current data source.

Example:Semiconductors

Optional GICS Level 4 sub-industry filter. Case-sensitive. Returns 400 with the observed catalog when the value is not present in the current data source.

Response

Filtered S&P 500 constituents with provenance.

Example response

{
  "data": {
    "constituents": [
      {
        "ticker": "AAPL",
        "name": "Apple Inc.",
        "gics_sector": "Information Technology",
        "gics_sub_industry": "Technology Hardware, Storage & Peripherals",
        "date_added": "1982-11-30",
        "cik": "0000320193"
      }
    ],
    "count": 503,
    "as_of_date": "2026-05-23",
    "data_source": "blob_wikipedia",
    "parse_status": "ok"
  },
  "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"
    ]
  }
}