AlgoSeek

US Equities Shares Outstanding Detailed

The U.S. Equities Shares Outstanding (Detailed) dataset provides a granular, event-level history of shares outstanding for U.S. exchange-listed equity securities. It extends the basic shares outstanding dataset by exposing additional metadata and change attribution, enabling deeper analysis of share count dynamics over time. In addition to core fields such as algoseek SecId, ticker symbol, effective date, and shares outstanding, the detailed dataset includes the security name, the change in shar

GET 
https://api.devalgoseek.com/api/v1/data/us-equity-ref/eq-shares-outst-detail#

The U.S. Equities Shares Outstanding (Detailed) dataset provides a granular, event-level history of shares outstanding for U.S. exchange-listed equity securities. It extends the basic shares outstanding dataset by exposing additional metadata and change attribution, enabling deeper analysis of share count dynamics over time. In addition to core fields such as algoseek SecId, ticker symbol, effective date, and shares outstanding, the detailed dataset includes the security name, the change in shares outstanding relative to the prior value, a unique event identifier for each update, the security’s listing date, and the current security status (e.g., active, in default, or inactive). The dataset is updated continuously throughout the trading day, providing timely visibility into newly reported or revised share count changes. It is designed to support valuation modeling, capitalization analysis, regulatory reporting, and research workflows that require event-level explainability and precise share count attribution.

For more details, please refer to the dataset documentation: US Equities Shares Outstanding Detailed 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: 2108727
    Tickerstring

    Symbol name

    Example: VOOG
    ASIDinteger

    A unique identifier for a security

    Example: 1010000000018709
    CreatedDatedate

    Trading date when SO event was created

    Example: 2023-08-03
    ChangedDatedate

    Trading date and version number (_n suffix) when SO event was changed

    Example: 2023-08-03
    Revisioninteger

    Version of the algoseek event report file

    Example: 0
    EffectiveDatedate

    Effective date of SO value change

    Example: 2023-08-02
    Namestring

    Company name

    Example: Vanguard S&P 500 Growth ETF
    SharesOutstandinginteger

    New shares outstanding figure

    Example: 31245972
    SharesOutstandingDiffinteger

    Change of SO, comparing with the previous figure

    Example: 400000
    EventIdinteger

    Unique Event Identifier of SO event

    Example: 5253292
    ListDatedate

    Date of Listing

    Example: 2010-09-09
    Statusstring

    Security Status

    Example: A
  • ]
    • 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-shares-outst-detail");
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!

← Previous
US Equities Trade Only
Next →
US Equities Trade and Quote Extended Minute Bar