logo
Sign InSign Up

S&P500 Constituents

Returns data from the [sp500] table.

Overview

This table provides the current and historical constituents of the S&P500 index.

For more information on the dataset and the available indicators, please review the sp500 table on the Data Explorer page.

The table is queried via the following endpoint

https://api.findl.com/v1.0/data/sp500?apiKey=test-api-key

The queries are authenticated and filtered using query parameters. A query parameter specifies a particular option or filter for the data to be returned. Examples of query parameter include the data format to be returned (format), the table columns to return (fields) or a filter to be applied (tablename). These are appended to the endpoint above, following a ?. The most important of these is your API key (apiKey) which is used to authenticate you. Without a valid API key, results will not be returned.

The sp500 table supports the following query parameters.

ParameterDescriptionDefaultExamples
formatThe format of the results to be returned.csvformat=json
fromSpecifies the filing date from which to return data.30 days agofrom=2023-08-01
toSpecifies the filing date to return data until.prior dayto=2023-08-31
fieldsThe fields (table columns) to return.allfields=date,ticker,action,contraticker
actionReturns results for the specified action.allaction=split
contratickerReturns the ticker for the company corresponding to a particular action (e.g. this will reflect the ticker for the company that was removed when viewing the record for a ticker that has been added to the sp500 table).allcontraticker=GE
tickerReturns results for the specified ticker. Multiple tickers should be separated with a comma(,).allticker=TSLA
limitThe number of records to return.10000limit=100000
skipThe number of results to skip before returning data.0skip=10000
sortThe field used to sort the data and the sort method (asc/desc).date.descsort=ticker.asc

Return the current S&P500 constituents

https://api.findl.com/v1.0/data/sp500?apiKey=test-api-key&format=csv&action=current

Return the S&P500 history for a specific ticker

https://api.findl.com/v1.0/data/sp500?apiKey=test-api-key&format=csv&ticker=AAPL

Set the table to return data from. [Required]

Limits the fields returned. Multiple fields should be separated with a comma (,). Leave blank to return all fields. [Optional]

Sort results by a specified field. Multiple fields should be separated with a comma (,). Indicate direction using [field].desc or [field].asc (e.g. date.desc, ticker.asc). [Optional]

Limit the number of items returned. Defaults to 10,000. Maximum data that can be returned in a single query is 100,000 items. [Optional]

Skip the first x number of results. Defaults to 0. [Optional]

Set the format of the returned data. Options include json and csv. [Default: csv].

logo

Radically accessible financial data

Contact Info

findl.com info@findl.com

Explore findl data

DocumentationSupport

Copyright © findl 2024. All rights reserved.

Terms & Use

Privacy Policy