# S&P 500 Constituents API > The current members of the S&P 500 stock index as an API — the reference a stock screener, portfolio tool or research dashboard needs. For each of the ~500 constituents: its ticker symbol, the company name, its GICS sector and sub-industry, the headquarters location, the date it was added to the index, its SEC Central Index Key (CIK, ready for EDGAR look-ups) and the year it was founded. Look a constituent up by symbol or name, list every company in a GICS sector, search across symbols, names, sub-industries and headquarters, or list the whole index with a per-sector breakdown. This is the index-membership and sector-classification reference — not live prices (finance-api), SEC filings (edgar-api) or the global legal-entity register (companies-api). Served from memory — always fast. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/sp500-api/..." ``` ## Pricing - **Free** (Free) — 15,000 calls/Mo, 3 req/s - **Starter** ($9/Mo) — 180,000 calls/Mo, 10 req/s - **Pro** ($27/Mo) — 900,000 calls/Mo, 25 req/s - **Mega** ($65/Mo) — 4,500,000 calls/Mo, 60 req/s ## Endpoints ### Lookup #### `GET /v1/company` — Constituent by symbol or name **Parameters:** - `symbol` (query, optional, string) — Ticker symbol Example: `AAPL` - `name` (query, optional, string) — Company name Example: `Apple` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/sp500-api/v1/company?symbol=AAPL&name=Apple" ``` **Response:** ```json { "data": { "company": { "cik": "0000320193", "name": "Apple Inc.", "sector": "Information Technology", "symbol": "AAPL", "founded": "1977", "date_added": "1982-11-30", "headquarters": "Cupertino, California", "sub_industry": "Technology Hardware, Storage & Peripherals" } }, "meta": { "timestamp": "2026-06-08T18:25:09.457Z", "request_id": "9a96f560-a200-4b5e-8b88-0af2c71b085c" }, "status": "ok", "message": "Company retrieved successfully", "success": true } ``` ### Sector #### `GET /v1/sector` — Companies in a GICS sector **Parameters:** - `sector` (query, required, string) — GICS sector Example: `Information Technology` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/sp500-api/v1/sector?sector=Information+Technology" ``` **Response:** ```json { "data": { "count": 72, "sector": "information technology", "companies": [ { "cik": "0000320193", "name": "Apple Inc.", "sector": "Information Technology", "symbol": "AAPL", "founded": "1977", "date_added": "1982-11-30", "headquarters": "Cupertino, California", "sub_industry": "Technology Hardware, Storage & Peripherals" }, { "cik": "0001467373", "name": "Accenture", "sector": "Information Technology", "symbol": "ACN", "founded": "1989", "date_added": "2011-07-06", "headquarters": "Dublin, Ireland", "sub_industry": "IT Consulting & Other Services" }, { "cik": "0000796343", "name": "Adobe Inc.", "sector": "Information Technology", "symbol": "ADBE", "founded": "1982", "date_added": "1997-05-05", "headquarters": "San Jose, California", "sub_industry": "Application Software" }, { "cik": "0000006281", "name": "Analog Devices", "sector": "Information Technology", "symbol": "ADI", "founded": "1965", " …(truncated, see openapi.json for full schema) ``` ### Search #### `GET /v1/search` — Search constituents **Parameters:** - `q` (query, required, string) — Search query (min 2 chars) Example: `bank` - `limit` (query, optional, string) — Max results (1-100) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/sp500-api/v1/search?q=bank&limit=25" ``` **Response:** ```json { "data": { "count": 25, "query": "bank", "total": 32, "companies": [ { "cik": "0000820027", "name": "Ameriprise Financial", "sector": "Financials", "symbol": "AMP", "founded": "1894", "date_added": "2005-10-03", "headquarters": "Minneapolis, Minnesota", "sub_industry": "Asset Management & Custody Banks" }, { "cik": "0001858681", "name": "Apollo Global Management", "sector": "Financials", "symbol": "APO", "founded": "1990", "date_added": "2024-12-23", "headquarters": "New York City, New York", "sub_industry": "Asset Management & Custody Banks" }, { "cik": "0001176948", "name": "Ares Management", "sector": "Financials", "symbol": "ARES", "founded": "1977", "date_added": "2025-12-11", "headquarters": "Los Angeles, California", "sub_industry": "Asset Management & Custody Banks" }, { "cik": "0000070858", "name": "Bank of America", "sector": "Financials", "symbol": "BAC", "founded": "1998 (1923 / 1874)", …(truncated, see openapi.json for full schema) ``` ### List #### `GET /v1/list` — List constituents **Parameters:** - `limit` (query, optional, string) — Page size (1-510) Example: `50` - `offset` (query, optional, string) — Offset Example: `0` - `sector` (query, optional, string) — Filter by GICS sector Example: `Energy` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/sp500-api/v1/list?limit=50&offset=0§or=Energy" ``` **Response:** ```json { "data": { "count": 21, "total": 21, "companies": [ { "cik": "0001841666", "name": "APA Corporation", "sector": "Energy", "symbol": "APA", "founded": "1954", "date_added": "1997-07-28", "headquarters": "Houston, Texas", "sub_industry": "Oil & Gas Exploration & Production" }, { "cik": "0001701605", "name": "Baker Hughes", "sector": "Energy", "symbol": "BKR", "founded": "2017", "date_added": "2017-07-07", "headquarters": "Houston, Texas", "sub_industry": "Oil & Gas Equipment & Services" }, { "cik": "0001163165", "name": "ConocoPhillips", "sector": "Energy", "symbol": "COP", "founded": "2002", "date_added": "1957-03-04", "headquarters": "Houston, Texas", "sub_industry": "Oil & Gas Exploration & Production" }, { "cik": "0000093410", "name": "Chevron Corporation", "sector": "Energy", "symbol": "CVX", "founded": "1879", "date_added": "1957-03-04", "headquarters": "Houston, Texas", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata + sector breakdown **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/sp500-api/v1/meta" ``` **Response:** ```json { "data": { "sectors": { "Energy": 21, "Materials": 26, "Utilities": 31, "Financials": 76, "Health Care": 59, "Industrials": 80, "Real Estate": 31, "Consumer Staples": 36, "Communication Services": 23, "Consumer Discretionary": 48, "Information Technology": 72 }, "service": "sp500-api", "endpoints": { "GET /v1/list": "List constituents (limit, offset, sector= to filter).", "GET /v1/meta": "This document.", "GET /v1/search": "Search constituents by symbol, name, sub-industry or HQ (q=).", "GET /v1/sector": "Companies in a GICS sector (sector=, e.g. Industrials).", "GET /v1/company": "Constituent by ticker symbol (symbol=, e.g. AAPL) or name (name=, e.g. Apple)." }, "description": "S&P 500 index constituents: ticker symbol, company name, GICS sector & sub-industry, headquarters, date added, SEC CIK and year founded. Look up by symbol or name, filter by GICS sector, search, or list the index. Source: Wikipedia/datasets S&P 500 constituents. No key.", "total_constituents": 503 }, "meta": { "timestamp": "2026-06-08T18:25:09.890Z", "request_id": "f473ebf9-fa1c-4d6a-b285-65a7fbd61968" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/sp500-api OpenAPI spec: https://www.oanor.com/api/sp500-api/openapi.json