SecuritiesExchangeCommission.Edgar 7.0.0

dotnet add package SecuritiesExchangeCommission.Edgar --version 7.0.0
                    
NuGet\Install-Package SecuritiesExchangeCommission.Edgar -Version 7.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SecuritiesExchangeCommission.Edgar" Version="7.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SecuritiesExchangeCommission.Edgar" Version="7.0.0" />
                    
Directory.Packages.props
<PackageReference Include="SecuritiesExchangeCommission.Edgar" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SecuritiesExchangeCommission.Edgar --version 7.0.0
                    
#r "nuget: SecuritiesExchangeCommission.Edgar, 7.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=SecuritiesExchangeCommission.Edgar&version=7.0.0
                    
Install as a Cake Addin
#tool nuget:?package=SecuritiesExchangeCommission.Edgar&version=7.0.0
                    
Install as a Cake Tool

SecuritiesExchangeCommission.Edgar

.NET class library for accessing the Security Exchange Commission's EDGAR database. This library allows you to access over twenty years worth of financial data that has been reported to the SEC, mostly by publicly traded companies.

Make sure to Identify your Program!

The SEC requires all automated tools to declare their traffic by specifying a user agent in each HTTP request header. This library is designed to do that and will pass the User-Agent according to the SEC's expected format (AppName/1.0 (email)). This should be the first thing you do!

using SecuritiesExchangeCommission.Edgar;

IdentificationManager.Instance.AppName = "MyAppName";
IdentificationManager.Instance.AppVersion = "1.0.0";
IdentificationManager.Instance.Email = "email@gmail.com";

Be sure to follow this step before doing anything with this library! If you do not, it will likely fail to return any data!

Querying the SEC EDGAR Database

Use the EdgarSearch class to query the database for filings for any publicly traded company.
For example, requesting Microsoft's ($MSFT) latest 10-K filings:

EdgarSearch msft10ks = await EdgarSearch.CreateAsync("MSFT", "10-K");

The first parameter in the CreateAsync static method, stock_symbol, can be specified as either the company's public trading symbol (MSFT in this case) or the company's SEC-assigned CIK, or "Central Index Key". For example, Microsoft's CIK is 789019.
The EdgarSearch instance is going to place the results of your query into its Results property. The Results property contains the most recent results that suite your query, but is limited of the number of results it can fit in one return. To get the next page of results, you can do something like this:

EdgarSearch msft10ks = await EdgarSearch.CreateAsync("MSFT", "10-K");
if (msft10ks.NextPageAvailable())
{
    EdgarSearch next_page = await msft10ks.NextPageAsync();
}

Extracting Data from Filings

The Results property of the EdgarSearch instance we used to query the database will contain an array of EdgarSearchResult instances. These instances will contain some basic details about the filing and provide you with a method to access additional details about that particular filing.

NEW: Interface with SEC's Data API

Recently, the SEC created a REST API service that supplies data. You can find documentation for that API here.

This library also allows you to interface with the two most useful endpoints of the API: /companyconcept and companyfacts.

Company Facts

/companyfacts returns a list of every XBRL fact that the company has ever reported, and every discrete data point associated with each fact. It is a lot of data!

Below is an example of how to interface with the SEC's /companyfacts service:

IdentificationManager.Instance.AppName = "LApp";
IdentificationManager.Instance.AppVersion = "1.0";
IdentificationManager.Instance.Email = "chrisha@gmail.com";

CompanyFactsQuery cfq = await CompanyFactsQuery.QueryAsync(1655210); //Beyond Meat (BYND)
foreach (Fact f in cfq.Facts)
{
    Console.WriteLine("Fact: " + f.Tag);
    Console.WriteLine("Label: " + f.Label);
    Console.WriteLine("Description: " + f.Description);
    Console.WriteLine();
    Console.WriteLine("Data Points:");
    foreach (FactDataPoint fdp in f.DataPoints)
    {
        Console.WriteLine(fdp.End.ToShortDateString() + " - $" + fdp.Value.ToString("#,##0"));
    }

    Console.WriteLine();
    Console.Write("Press enter to continue onto the next fact...");
    Console.ReadLine();
    Console.WriteLine();
    Console.WriteLine();
}

Will result in, for example:

Fact: AdvertisingExpense
Label: Advertising Expense
Description: Amount charged to advertising expense for the period, which are expenses incurred with the objective of increasing revenue for a specified brand, product or product line.

Data Points:
12/31/2017 - $300,000
12/31/2018 - $62,000
12/31/2018 - $62,000
12/31/2019 - $300,000
12/31/2019 - $300,000
12/31/2019 - $300,000
12/31/2020 - $300,000
12/31/2020 - $300,000
12/31/2020 - $300,000
12/31/2021 - $12,100,000
12/31/2021 - $12,100,000
12/31/2021 - $12,100,000
12/31/2022 - $20,600,000
12/31/2022 - $20,600,000
12/31/2022 - $20,600,000
12/31/2023 - $17,200,000
12/31/2023 - $17,200,000
12/31/2024 - $8,500,000

Press enter to continue onto the next fact...

Company Concept

/companyconcept returns a list of discrete data that a company reported for a particular fact tag (i.e. AssetsCurrent).

We can interface with the /companyconcept service like so:

IdentificationManager.Instance.AppName = "LApp";
IdentificationManager.Instance.AppVersion = "1.0";
IdentificationManager.Instance.Email = "chrisha@gmail.com";

CompanyConceptQuery ccq = await CompanyConceptQuery.QueryAsync(1655210, "RevenueFromContractWithCustomerExcludingAssessedTax");

Console.WriteLine("Company Name: " + ccq.EntityName);
Console.WriteLine("Fact: " + ccq.Result.Tag);
Console.WriteLine("Label: " + ccq.Result.Label);
Console.WriteLine("Description: " + ccq.Result.Description);
Console.WriteLine();
Console.WriteLine("Data Points:");
foreach (FactDataPoint fdp in ccq.Result.DataPoints)
{
    if (fdp.Period == FiscalPeriod.FiscalYear) //Only show year-end values (on the 10-K), not quarterly
    {
        Console.WriteLine("Year End " + fdp.End.ToShortDateString() + " - $" + fdp.Value.ToString("#,##0"));
    }
}

Will result in:

Company Name: BEYOND MEAT, INC.
Fact: RevenueFromContractWithCustomerExcludingAssessedTax
Label: Revenue from Contract with Customer, Excluding Assessed Tax
Description: Amount, excluding tax collected from customer, of revenue from satisfaction of performance obligation by transferring promised good or service to customer. Tax collected from customer is tax assessed by governmental authority that is both imposed on and concurrent with specific revenue-producing transaction, including, but not limited to, sales, use, value added and excise.

Data Points:
Year End 12/31/2017 - $32,581,000
Year End 3/31/2018 - $12,776,000
Year End 6/30/2018 - $17,367,000
Year End 9/29/2018 - $26,277,000
Year End 12/31/2018 - $87,934,000
Year End 12/31/2018 - $87,934,000
Year End 12/31/2018 - $31,514,000
Year End 3/30/2019 - $40,206,000
Year End 3/30/2019 - $40,206,000
Year End 6/29/2019 - $67,251,000
Year End 6/29/2019 - $67,251,000
Year End 9/28/2019 - $91,961,000
Year End 9/28/2019 - $91,961,000
Year End 12/31/2019 - $297,897,000
Year End 12/31/2019 - $297,897,000
Year End 12/31/2019 - $297,897,000
Year End 12/31/2019 - $98,479,000
Year End 12/31/2019 - $98,479,000
Year End 3/28/2020 - $97,074,000
Year End 6/27/2020 - $113,338,000
Year End 9/26/2020 - $94,436,000
Year End 12/31/2020 - $406,785,000
Year End 12/31/2020 - $406,785,000
Year End 12/31/2020 - $406,785,000
Year End 12/31/2020 - $101,937,000
Year End 12/31/2021 - $464,700,000
Year End 12/31/2021 - $464,700,000
Year End 12/31/2021 - $464,700,000
Year End 12/31/2022 - $418,933,000
Year End 12/31/2022 - $418,933,000
Year End 12/31/2022 - $418,933,000
Year End 12/31/2023 - $343,376,000
Year End 12/31/2023 - $343,376,000
Year End 12/31/2024 - $326,452,000
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (6)

Showing the top 5 NuGet packages that depend on SecuritiesExchangeCommission.Edgar:

Package Downloads
Aletheia

Package Description

Luca

Financial statements simplified. Receive a financial statement for any publically traded company with one line of code.

TimHanewich.Investing

Investing toolkit creating by Tim Hanewich

EarningsAlley

Engine behind the Earnings Alley twitter account, @EarningsAlley.

EdgarCacheFramework

Minimizes external requests to Yahoo and SEC EDGAR XBRL filings by caching searched results in a code first, run-time generated SQLite database.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
7.0.0 99 6/22/2025
6.3.2 13,912 8/20/2022
6.3.1 16,390 7/3/2021
6.3.0 409 6/8/2021
6.2.3 5,838 5/21/2021
6.2.2 2,898 4/11/2021
6.2.1 388 4/11/2021
6.2.0 400 3/17/2021
6.1.0 421 3/16/2021
6.0.0 2,998 3/6/2021
5.1.1 1,730 2/17/2021
5.1.0 392 2/17/2021
5.0.0 489 2/17/2021
4.0.1 570 2/16/2021
4.0.0 1,743 2/5/2021
3.3.0 627 1/15/2021
3.2.0 2,592 1/7/2021
3.1.0 444 1/5/2021
3.0.0 459 1/5/2021
2.2.0 489 1/4/2021
2.1.0 461 1/3/2021
2.0.3 1,543 6/12/2020
2.0.2 539 6/12/2020
2.0.1 553 6/12/2020
2.0.0 1,656 5/7/2020
1.0.0 865 5/2/2020