AlgoSeek

US Equities Security Master File

The U.S. Equities Security Master dataset provides a comprehensive, centralized reference record for all listed and delisted U.S. equity securities from 2007 to the present. It serves as the authoritative foundation for security identification, classification, and lifecycle tracking across the U.S. equities universe. The dataset includes core descriptive attributes such as industry and sector classification, listing status, and security name and ticker history, enabling accurate tracking of secu

GET 

https://api.devalgoseek.com/api/v1/data/us-equity-ref/eq-sec-master#

The U.S. Equities Security Master dataset provides a comprehensive, centralized reference record for all listed and delisted U.S. equity securities from 2007 to the present. It serves as the authoritative foundation for security identification, classification, and lifecycle tracking across the U.S. equities universe. The dataset includes core descriptive attributes such as industry and sector classification, listing status, and security name and ticker history, enabling accurate tracking of securities through name and symbol changes. Each record is organized around algoseek’s Security ID (SecId), a stable internal identifier that remains unchanged across name and ticker updates. In addition, the Security Master provides cross-references to major industry identifiers, including FIGI and ISIN, supporting interoperability with third-party datasets and internal systems. The dataset is delivered as a single consolidated table and is updated daily to reflect new listings, delistings, and reference-data changes. Complementary Lookup Files are available to resolve tickers and other identifiers to SecId.

For more details, please refer to the dataset documentation: US Equities Security Master File Guide.

Advanced Filtering

You can provide one or multiple filter expressions based on the dataset's columns to narrow down the results. For example, StartDate.gt=2023-01-01&StartDate.lt=2023-12-31, Ticker=AAPL.

Please refer to the Advanced Filtering Guide for the extensive reference.

Request#

Query Parameters#

    sort Sort

    Sorting criteria for the results. Provide a column name with optional prefix '+' for ascending order, or prefix with '-' for descending order. Multiple sorting fields may be supported depending on the dataset. If sort prefix is not provided, the ascending order is applied.

    columns Columns

    A comma-separated list of columns to include in the response. Use this parameter to select only specific fields from the dataset. If not provided, all available columns will be returned.

    offset Offset

    Possible values: >= 0

    Number of records to skip before returning results. To be used with the limit parameter for pagination. If not provided, defaults to 0.

    Default value: 0
    Example: 100
    limit Limit

    Possible values: >= 0 and <= 100000

    Maximum number of records to return. Used to control response size and pagination. If not provided, a default limit is applied by the server.

    Default value: 10000
    Example: 100
    response_format ResponseFormat

    Possible values: [json, csv, csv_gzip]

    The type of the data to return

    Default value: json
    Examples:

    JSON format (default)

    Example: json

Responses#

JSON, CSV file, or gzip-compressed CSV file, depending on the value of response_format query parameter

Schema
    data object[]required
  • Array [
  • SecIdinteger

    A unique identifier for a security

    Example: 33849
    ASIDinteger

    A unique identifier for a security

    Example: 1010000000002542
    ListStatusstring

    Current list status (D = Delisted. L = Listed)

    Example: L
    SecurityDescriptionstring

    Current type of security

    Example: Equity Shares
    Sicinteger

    Current Standard Industrial Classification code

    Example: 6021
    Sectorstring

    Current SIC Sector

    Example: Finance Insurance And Real Estate
    Industrystring

    Current SIC Industry

    Example: National Commercial Banks
    SEDOLstring

    Current Stock Exchange Daily Official List

    Example: 2295677
    Tickerstring[]

    List of symbol names used

    Example: ["BAC"]
    TickerStartToEndDatestring[]

    Start and end dates for each ticker

    Example: ["20070103:29991231"]
    Namestring[]

    List of security names used

    Example: ["Bank Of America Corp."]
    NameStartToEndDatestring[]

    Start and end dates for each name

    Example: ["20070103:29991231"]
    ISINstring[]

    List of ISIN codes used

    Example: ["US0605051046"]
    ISINStartToEndDatestring[]

    Start and end dates for each ISIN

    Example: ["20070103:29991231"]
    USIdentifierstring[]

    List of USIdentifiers for US securities used

    Example: ["060505104"]
    USIdentifierStartToEndDatestring[]

    Start and end dates for each USIdentifier

    Example: ["20070103:29991231"]
    PrimaryExchangestring[]

    List of Primary Exchanges used

    Example: ["NYSE"]
    PrimaryExchangeStartToEndDatestring[]

    Start and end dates for each Primary Exchange

    Example: ["20070103:29991231"]
    FIGIstring[]

    List of Financial Instrument Global Identifier codes used

    Example: ["BBG000BCTLF6"]
  • ]
  • pagination objectrequired
    offsetinteger

    The number of records skipped to fetch the current page

    Default value: 0
    limitintegerrequired

    The maximum number of records in the current page

    next_offsetinteger

    The number of records to skip to fetch the next page

Authorization: X-API-KEY#

name: X-API-KEYtype: apiKeyin: header
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.devalgoseek.com/api/v1/data/us-equity-ref/eq-sec-master");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("X-API-KEY", "<X-API-KEY>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Request
Base URL
https://api.devalgoseek.com
Auth
Parameters
— query
— query
— query
— query
— query
Column Filters
Accept
Response

Click the Send API Request button above and see the response here!