S&P 500 constituents (membership metadata)

GET

/api/v1/equities/sp500/constituents

Last modified:2026-10-11 19:16:11

Maintainer:Not configured

OperationId:equities_sp500_constituents

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 cases: filter the earnings calendar by SPX members; cross-reference 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).

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/equities/sp500/constituents?sector=undefined&sub_industry=undefined' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

Filtered S&P 500 constituents with provenance.

Bodyapplication/json

Example

{
    "data": {
        "constituents": [
            {
                "ticker": "AAPL",
                "name": "Apple Inc.",
                "gics_sector": "Information Technology",
                "gics_sub_industry": "Technology Hardware, Storage & Peripherals",
                "date_added": "string",
                "cik": "0000320193"
            }
        ],
        "count": 503,
        "as_of_date": "2026-05-23",
        "data_source": "blob_wikipedia",
        "parse_status": "string",
        "methodology": "string",
        "license_attribution": "string"
    },
    "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",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Modified at 2026-10-11 19:16:11

One country's historical TIC holdings timeseries

Earnings event study (market-model CAR)