January Sale! Get over 30% off when you subscribe to an annual plan!

S&P 500 API

The S&P 500 API provides information about companies in the S&P 500 index, including ticker, name, sector, and the date the company was added to the index.

(4.7)

From 9,505 users

2,000+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
289ms301ms386ms641ms959ms

Didn't find what you were looking for? Suggest an improvement

/v1/sp500 GET

https://api.api-ninjas.com/v1/sp500

Returns a list of S&P 500 companies. All parameters are optional. If no parameters are provided, data for all companies will be returned (may be slow in poor network conditions).

Parameters

  • ticker  optional

    Stock ticker symbol (e.g. AAPL).

  • name  optional

    Company name (full or partial match).

  • sector  optional

    GICS Sector. Possible values are:

    • energy

    • materials

    • industrials

    • utilities

    • health_care

    • financials

    • consumer_discretionary

    • consumer_staples

    • information_technology

    • communication_services

    • real_estate

  • min_date_added  optional

    Earliest date company was added to the S&P 500 (format: YYYY-MM-DD).

  • max_date_added  optional

    Latest date company was added to the S&P 500 (format: YYYY-MM-DD).

  • limit  optional

    Maximum number of results to return.

  • offset  optional

    Number of results to skip (for pagination).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

  • ticker

    Stock ticker symbol.

  • company_name

    Company name.

  • sector

    GICS Sector.

  • date_added

    Date the company was added to the S&P 500 (format: YYYY-MM-DD).

  • cik

    Company CIK number.

  • sub_industry

    Company sub-industry.

  • headquarters

    Company headquarters location.

Sample Request Live Demo!

ticker
name
sector
limit
offset

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/sp500?limit=10

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/sp500" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.