An easy-to-use .NET library for accessing and aggregating financial data from multiple sources.
This library enables developers to retrieve financial data via APIs and HTML scraping from a variety of providers. It's ideal for building analytical tools, dashboards, or financial applications that require access to market data.
- Retrieve Instruments: Get tradable ticker symbols and associated details.
- Fundamentals: Access key financial metrics and company fundamentals.
- Historical Records: Fetch historical data for analysis or charting.
- Real-Time Quotes: Receive live updates on stock prices and market data.
This section guides you through installing Finance.NET, configuring services, and basic data retrieval.
Install via NuGet:
dotnet add package Finance.NETAdd Finance.NET to your service collection for dependency injection:
services.AddFinanceNet();Optional: Configure with custom settings.
services.AddFinanceNet(new FinanceNetConfiguration
{
HttpTimeout = 5,
HttpRetryCount = 3,
AlphaVantageApiKey = "ALPHA_VANTAGE__API_KEY"
});Example: Retrieve historical and real-time data for Tesla (TSLA):
public async Task Run(IYahooFinanceService yahooService)
{
var symbol = "TSLA";
var startDate = new DateTime(2020, 1, 1);
var records = await yahooService.GetRecordsAsync(symbol, startDate);
foreach (var record in records)
{
Console.WriteLine($"Date={record.Date}: {record.Open} / {record.Close}");
}
var quote = await yahooService.GetQuoteAsync(symbol);
Console.WriteLine($"Bid={quote.Bid}, Ask={quote.Ask}");
}Finance.NET exposes modular service interfaces for accessing diverse financial data through a consistent API. Each interface corresponds to a specific provider and supports its unique features.
Provides market data, company fundamentals, historical records, and real-time quotes.
GetInstrumentsAsync
Retrieves a collection of financial instruments.
EInstrumentType? filterByType: An optional filter to specify the type of asset. If not provided, all asset types will be included. Possible values:Stock: Most active stocks.ETF: Most active exchange-traded funds (ETFs)Forex: Available currencies (foreign exchange).Crypto: Available cryptocurrencies.Index: Available world indices.
CancellationToken token: (Optional) Cancellation token to cancel the operation if needed.
A task that resolves to an IEnumerable<Instrument> containing the following properties for each item:
| Property | Type | Description | Example |
|---|---|---|---|
Symbol |
string? |
The ticker symbol of the instrument. | AAPL |
InstrumentType |
EInstrumentType? |
The type of the financial instrument. | Stock |
public async Task Run(IYahooFinanceService yahooService)
{
// Retrieve all instruments
var instruments = await yahooService.GetInstrumentsAsync();
// Retrieve only stock instruments
var stockInstruments = await yahooService.GetInstrumentsAsync(EInstrumentType.Stock);
foreach (var instrument in stockInstruments)
{
Console.WriteLine($"Symbol: {instrument.Symbol}, Type: {instrument.InstrumentType}");
}
}GetProfileAsync
Retrieves the profile of a specific entity based on its symbol.
string symbol: The symbol of the quote (e.g.,"AAPL"for Apple).CancellationToken token: (Optional) Cancellation token to cancel the operation if needed.
A task that resolves to a Profile containing the following properties:
| Property | Type | Description | Example |
|---|---|---|---|
Adress |
string? |
The address. | One Apple Park Way, Cupertino, CA 95014 |
Phone |
string? |
The phone number. | +1-800-MY-APPLE |
Website |
string? |
The website URL. | https://www.apple.com |
Sector |
string? |
The sector in which the entity operates. | Technology |
Industry |
string? |
The industry the entity belongs to. | Consumer Electronics |
CntEmployees |
long? |
The number of employees. | 164000 |
Description |
string? |
A brief description. | Apple designs and ... |
public async Task Run(IYahooFinanceService yahooService)
{
var profile = await yahooService.GetProfileAsync("AAPL");
Console.WriteLine($"Address: {profile.Adress}");
Console.WriteLine($"Sector: {profile.Sector}");
Console.WriteLine($"Industry: {profile.Industry}");
Console.WriteLine($"Description: {profile.Description}");
}GetSummaryAsync
Retrieves the summary of a specific asset based on its symbol.
string symbol: The symbol of the quote (e.g.,"AAPL"for Apple).CancellationToken token: (Optional) Cancellation token to cancel the operation if needed.
A task that resolves to a Summary containing the following properties:
| Property | Type | Description | Example |
|---|---|---|---|
Name |
string? |
Name of the asset. | Apple Inc. |
MarketTimeNotice |
string? |
Notice of market status. | Market Closed |
PreviousClose |
decimal? |
Previous closing price. | 180.14 |
Open |
decimal? |
Opening price of the stock. | 182.20 |
Bid |
decimal? |
Current bid price. | 180.00 |
Ask |
decimal? |
Current ask price. | 181.00 |
DaysRange_Min |
decimal? |
Minimum price today. | 179.50 |
DaysRange_Max |
decimal? |
Maximum price today. | 183.00 |
WeekRange52_Min |
decimal? |
Minimum price in 52 weeks. | 130.20 |
WeekRange52_Max |
decimal? |
Maximum price in 52 weeks. | 190.50 |
Volume |
decimal? |
Total volume traded today. | 25,000,000 |
AvgVolume |
decimal? |
Average daily volume. | 30,000,000 |
MarketCap_Intraday |
decimal? |
Market cap in the current session. | 2.85T |
Beta_5Y_Monthly |
decimal? |
5-year beta (monthly data). | 1.20 |
PE_Ratio_TTM |
decimal? |
Price-to-earnings ratio (TTM). | 28.90 |
EPS_TTM |
decimal? |
Earnings per share (TTM). | 6.22 |
EarningsDate |
DateTime? |
Date of the next earnings report. | 2025-02-15 |
Forward_Dividend |
decimal? |
Expected forward dividend. | 0.88 |
Forward_Yield |
decimal? |
Forward dividend yield. | 0.49% |
Ex_DividendDate |
DateTime? |
Ex-dividend date. | 2025-01-10 |
OneYearTargetEst |
decimal? |
One-year target price estimate. |
public async Task Run(IYahooFinanceService yahooService)
{
// Retrieve the summary for Apple Inc.
var summary = await yahooService.GetSummaryAsync("AAPL");
Console.WriteLine($"Name: {summary.Name}");
Console.WriteLine($"Previous Close: {summary.PreviousClose}");
Console.WriteLine($"Open: {summary.Open}");
Console.WriteLine($"Bid: {summary.Bid}");
Console.WriteLine($"Ask: {summary.Ask}");
Console.WriteLine($"Average Volume: {summary.AvgVolume}");
Console.WriteLine($"EPS (TTM): {summary.EPS_TTM}");
}GetFinancialsAsync
Retrieves the financial reports for a specified asset identified by its symbol.
string symbol: The symbol of the quote (e.g.,"AAPL"for Apple).CancellationToken token: (Optional) Cancellation token to cancel the operation if needed.
A task that resolves to a Dictionary<string, FinancialReport> where the key is the label (e.g., "Annual Report 2024") and the value is a FinancialReport containing the following properties:
| Property | Type | Description | Example |
|---|---|---|---|
TickerSymbol |
string? |
The company's stock symbol. | AAPL |
TotalRevenue |
decimal? |
Total revenue generated. | 394,328,000,000 |
CostOfRevenue |
decimal? |
Direct costs of goods/services sold. | 213,459,000,000 |
GrossProfit |
decimal? |
Gross profit (Revenue - Cost of Revenue). | 180,869,000,000 |
OperatingExpense |
decimal? |
Operating expenses incurred. | 34,152,000,000 |
OperatingIncome |
decimal? |
Operating income (Gross Profit - Operating Expenses). | 146,717,000,000 |
NetNonOperatingInterestIncomeExpense |
decimal? |
Net non-operating interest income/expense. | 2,500,000,000 |
OtherIncomeExpense |
decimal? |
Other non-core income/expenses. | -1,200,000,000 |
PretaxIncome |
decimal? |
Pretax income before taxes. | 148,017,000,000 |
TaxProvision |
decimal? |
Income taxes provisioned. | 25,000,000,000 |
NetIncomeCommonStockholders |
decimal? |
Net income for common stockholders. | 123,017,000,000 |
DilutedNIAvailableToComStockholders |
decimal? |
Diluted net income for common stockholders. | 120,517,000,000 |
BasicEPS |
decimal? |
Basic earnings per share. | 6.25 |
DilutedEPS |
decimal? |
Diluted earnings per share. | 6.15 |
BasicAverageShares |
decimal? |
Basic average shares for EPS. | 19,700,000,000 |
DilutedAverageShares |
decimal? |
Diluted average shares for EPS. | 19,600,000,000 |
TotalOperatingIncomeAsReported |
decimal? |
Reported total operating income. | 146,700,000,000 |
TotalExpenses |
decimal? |
Total expenses incurred. | 247,611,000,000 |
NetIncomeFromContinuingAndDiscontinuedOperation |
decimal? |
Net income from all operations. | 123,017,000,000 |
NormalizedIncome |
decimal? |
Normalized income adjusted for irregularities. | 125,500,000,000 |
InterestIncome |
decimal? |
Interest income earned. | 5,000,000,000 |
InterestExpense |
decimal? |
Interest expense incurred. | 2,500,000,000 |
NetInterestIncome |
decimal? |
Net interest income (Income - Expense). | 2,500,000,000 |
EBIT |
decimal? |
Earnings Before Interest and Taxes. | 148,217,000,000 |
EBITDA |
decimal? |
Earnings Before Interest, Taxes, Depreciation, and Amortization. | 151,217,000,000 |
ReconciledCostOfRevenue |
decimal? |
Adjusted cost of revenue. | 212,000,000,000 |
ReconciledDepreciation |
decimal? |
Adjusted depreciation expense. | 3,000,000,000 |
NetIncomeFromContinuingOperationNetMinorityInterest |
decimal? |
Net income from continuing operations. | 121,017,000,000 |
TotalUnusualItemsExcludingGoodwill |
decimal? |
Total unusual items, excluding goodwill. | -2,000,000,000 |
TotalUnusualItems |
decimal? |
Total unusual items, including goodwill. | -2,000,000,000 |
NormalizedEBITDA |
decimal? |
Adjusted EBITDA for unusual items. | 153,217,000,000 |
TaxRateForCalcs |
decimal? |
Tax rate used in calculations. | 16.9% |
TaxEffectOfUnusualItems |
decimal? |
Tax effect of unusual items. | -500,000,000 |
public async Task Run(IYahooFinanceService yahooService)
{
// Retrieve financial reports for Apple Inc.
var financialReports = await yahooService.GetFinancialsAsync("AAPL");
foreach (var label in financialReports.Keys)
{
var report = financialReports[label];
Console.WriteLine($"Label: {label}");
Console.WriteLine($"Ticker Symbol: {report.TickerSymbol}");
Console.WriteLine($"Total Revenue: {report.TotalRevenue}");
Console.WriteLine($"Cost of Revenue: {report.CostOfRevenue}");
Console.WriteLine($"Gross Profit: {report.GrossProfit}");
Console.WriteLine($"Operating Income: {report.OperatingIncome}");
Console.WriteLine($"Net Income: {report.NetIncomeCommonStockholders}");
Console.WriteLine();
}
}GetRecordsAsync
Retrieves historical stock market data records for a specified asset identified by its symbol. Users can specify an optional date range.
string symbol: The symbol of the quote (e.g.,"AAPL"for Apple).DateTime? startDate: (Optional) Start date for retrieving historical records. Defaults to 7 days before the current date if not provided.DateTime? endDate: (Optional) End date for retrieving historical records. Defaults to the current date if not provided.CancellationToken token: (Optional) Cancellation token to cancel the operation if needed.
A task that resolves to an IEnumerable<Record>, where each Record represents a historical data point with the following properties:
| Property | Type | Description | Example |
|---|---|---|---|
Date |
DateTime |
The date of the record. | 2025-01-01 |
Open |
decimal? |
The opening price. | 150.25 |
High |
decimal? |
The highest price during the trading session. | 155.00 |
Low |
decimal? |
The lowest price during the trading session. | 148.50 |
Close |
decimal? |
The closing price at the end of the trading session. | 152.75 |
AdjustedClose |
decimal? |
The adjusted closing price, accounting for stock splits and dividends. | 153.00 |
Volume |
long? |
The trading volume (number of shares traded). | 10,000,000 |
public async Task Run(IYahooFinanceService yahooService)
{
// Retrieve historical records for Apple Inc. for the last 30 days
var startDate = DateTime.UtcNow.AddDays(-30);
var endDate = DateTime.UtcNow;
var records = await yahooService.GetRecordsAsync("AAPL", startDate, endDate);
foreach (var record in records)
{
Console.WriteLine($"Date: {record.Date:yyyy-MM-dd}");
Console.WriteLine($"Open: {record.Open:C}");
Console.WriteLine($"Close: {record.Close:C}");
Console.WriteLine();
}
}GetQuoteAsync
Retrieves detailed information about a specific financial quote, identified by its symbol. This API is useful for accessing comprehensive data about a stock, ETF, or other traded financial instruments.
string symbol: The symbol of the quote (e.g.,"AAPL"for Apple).CancellationToken token: (Optional) A cancellation token that can be used to cancel the operation if needed.
A task that resolves to a Quote object. The Quote record contains detailed information about the requested financial instrument, as described in the table below.
| Property | Type | Description | Example |
|---|---|---|---|
Language |
string? |
The language of the quote. | "en" |
Region |
string? |
The region of the quote. | "US" |
QuoteType |
string? |
The type of the quote. | "equity" |
TypeDisp |
string? |
The display type of the quote. | "STOCK" |
QuoteSourceName |
string? |
The source of the quote. | "Yahoo Finance" |
CustomPriceAlertConfidence |
string? |
The confidence level of a custom price alert. | "HIGH" |
Currency |
string? |
The currency in which the stock is traded. | "USD" |
Exchange |
string? |
The exchange on which the stock is listed. | "NASDAQ" |
ShortName |
string? |
The short name of the symbol. | "AAPL" |
LongName |
string? |
The full name of the symbol. | "Apple Inc." |
ExchangeTimezoneName |
string? |
The time zone of the exchange. | "America/New_York" |
ExchangeTimezoneShortName |
string? |
The abbreviated time zone of the exchange. | "EST" |
GmtOffSetMilliseconds |
long? |
The GMT offset in milliseconds. | -18000000 |
Market |
string? |
The market the instrument is listed on. | "Equity" |
EsgPopulated |
bool? |
Indicates if ESG. | true |
RegularMarketChangePercent |
double? |
The percentage change in the regular market price. | 2.35 |
RegularMarketPrice |
double? |
The regular market price of the stock. | 145.67 |
MarketState |
string? |
The market state (e.g., open or closed). | "OPEN" |
FullExchangeName |
string? |
The full name of the exchange. | "NASDAQ Stock Market" |
FinancialCurrency |
string? |
The financial currency used for the quote. | "USD" |
RegularMarketOpen |
double? |
The opening price of the regular market. | 143.50 |
AverageDailyVolume3Month |
long? |
The average volume over the last 3 months. | 1500000 |
AverageDailyVolume10Day |
long? |
The average volume over the last 10 days. | 2000000 |
FiftyTwoWeekLowChange |
double? |
The change in the 52-week low price. | 10.00 |
FiftyTwoWeekLowChangePercent |
double? |
The percentage change in the 52-week low price. | 7.5 |
FiftyTwoWeekRange |
string? |
The 52-week price range. | "120.00 - 160.00" |
FiftyTwoWeekHighChange |
double? |
The change in the 52-week high price. | -5.00 |
FiftyTwoWeekHighChangePercent |
double? |
The percentage change in the 52-week high price. | -3.12 |
FiftyTwoWeekLow |
double? |
The price at its 52-week low. | 120.00 |
FiftyTwoWeekHigh |
double? |
The price at its 52-week high. | 160.00 |
FiftyTwoWeekChangePercent |
double? |
The percentage change in the 52-week price. | 5.0 |
EarningsDate |
DateTime? |
The earnings date. | 2025-02-01 |
DividendRate |
double? |
The current dividend rate. | 0.22 |
DividendDate |
DateTime? |
The date of the next dividend payment. | 2025-04-15 |
TrailingAnnualDividendYield |
double? |
The trailing annual dividend yield. | 1.5 |
MarketCap |
long? |
The market capitalization of the company. | 2450000000000 |
ForwardPe |
double? |
The forward PE ratio. | 28.9 |
PriceToBook |
double? |
The price-to-book ratio. | 12.5 |
AverageAnalystRating |
string? |
The average analyst rating. | "Buy" |
Tradeable |
bool? |
Indicates whether the instrument is tradeable. | true |
HasPrePostMarketData |
bool? |
Has the quote pre/post-market data. | true |
FirstTradeDate |
DateTime? |
The date of the first trade. | 1980-12-12 |
DisplayName |
string? |
The display name of the stock. | "Apple Inc." |
Symbol |
string? |
The symbol (ticker) of the stock. | "AAPL" |
public async Task DisplayQuote(IYahooFinanceService yahooService)
{
// Retrieve a quote for Apple Inc.
var quote = await yahooService.GetQuoteAsync("AAPL");
Console.WriteLine($"Symbol: {quote.Symbol}");
Console.WriteLine($"Name: {quote.ShortName}");
Console.WriteLine($"Market Price: {quote.RegularMarketPrice:C}");
Console.WriteLine($"52-Week High: {quote.FiftyTwoWeekHigh:C}");
Console.WriteLine($"52-Week Low: {quote.FiftyTwoWeekLow:C}");
Console.WriteLine($"Market Cap: {quote.MarketCap:N0}");
Console.WriteLine($"Currency: {quote.Currency}");
}GetQuotesAsync
Retrieves quote data for multiple financial instruments identified by their symbols. The data includes detailed information about each instrument, such as pricing, market performance, and other financial metrics.
List<string> symbols: A list of symbols for which to retrieve data (e.g.,["AAPL", "MSFT", "GOOGL"]).CancellationToken token: (Optional) Cancellation token to cancel the operation if needed.
A task that resolves to an IEnumerable<Quote>, where each Quote provides comprehensive data about a specific instrument.
| Property | Type | Description | Example |
|---|---|---|---|
Language |
string? |
The language of the quote. | "en" |
Region |
string? |
The region of the quote. | "US" |
QuoteType |
string? |
The type of the quote. | "equity" |
TypeDisp |
string? |
The display type of the quote. | "STOCK" |
QuoteSourceName |
string? |
The source of the quote. | "Yahoo Finance" |
CustomPriceAlertConfidence |
string? |
The confidence level of a custom price alert. | "HIGH" |
Currency |
string? |
The currency in which the stock is traded. | "USD" |
Exchange |
string? |
The exchange on which the stock is listed. | "NASDAQ" |
ShortName |
string? |
The short name of the symbol. | "AAPL" |
LongName |
string? |
The full name of the symbol. | "Apple Inc." |
ExchangeTimezoneName |
string? |
The time zone of the exchange. | "America/New_York" |
ExchangeTimezoneShortName |
string? |
The abbreviated time zone of the exchange. | "EST" |
GmtOffSetMilliseconds |
long? |
The GMT offset in milliseconds. | -18000000 |
Market |
string? |
The market the instrument is listed on. | "Equity" |
EsgPopulated |
bool? |
Indicates if ESG. | true |
RegularMarketChangePercent |
double? |
The percentage change in the regular market price. | 2.35 |
RegularMarketPrice |
double? |
The regular market price of the stock. | 145.67 |
MarketState |
string? |
The market state (e.g., open or closed). | "OPEN" |
FullExchangeName |
string? |
The full name of the exchange. | "NASDAQ Stock Market" |
FinancialCurrency |
string? |
The financial currency used for the quote. | "USD" |
RegularMarketOpen |
double? |
The opening price of the regular market. | 143.50 |
AverageDailyVolume3Month |
long? |
The average volume over the last 3 months. | 1500000 |
AverageDailyVolume10Day |
long? |
The average volume over the last 10 days. | 2000000 |
FiftyTwoWeekLowChange |
double? |
The change in the 52-week low price. | 10.00 |
FiftyTwoWeekLowChangePercent |
double? |
The percentage change in the 52-week low price. | 7.5 |
FiftyTwoWeekRange |
string? |
The 52-week price range. | "120.00 - 160.00" |
FiftyTwoWeekHighChange |
double? |
The change in the 52-week high price. | -5.00 |
FiftyTwoWeekHighChangePercent |
double? |
The percentage change in the 52-week high price. | -3.12 |
FiftyTwoWeekLow |
double? |
The price at its 52-week low. | 120.00 |
FiftyTwoWeekHigh |
double? |
The price at its 52-week high. | 160.00 |
FiftyTwoWeekChangePercent |
double? |
The percentage change in the 52-week price. | 5.0 |
EarningsDate |
DateTime? |
The earnings date. | 2025-02-01 |
DividendRate |
double? |
The current dividend rate. | 0.22 |
DividendDate |
DateTime? |
The date of the next dividend payment. | 2025-04-15 |
TrailingAnnualDividendYield |
double? |
The trailing annual dividend yield. | 1.5 |
MarketCap |
long? |
The market capitalization of the company. | 2450000000000 |
ForwardPe |
double? |
The forward PE ratio. | 28.9 |
PriceToBook |
double? |
The price-to-book ratio. | 12.5 |
AverageAnalystRating |
string? |
The average analyst rating. | "Buy" |
Tradeable |
bool? |
Indicates whether the instrument is tradeable. | true |
HasPrePostMarketData |
bool? |
Has the quote pre/post-market data. | true |
FirstTradeDate |
DateTime? |
The date of the first trade. | 1980-12-12 |
DisplayName |
string? |
The display name of the stock. | "Apple Inc." |
Symbol |
string? |
The symbol (ticker) of the stock. | "AAPL" |
public async Task Run(IYahooFinanceService yahooService)
{
// Retrieve quotes for Apple, Microsoft, and Google
var symbols = new List<string> { "AAPL", "MSFT", "GOOGL" };
var quotes = await yahooService.GetQuotesAsync(symbols);
foreach (var quote in quotes)
{
Console.WriteLine($"Symbol: {quote.Symbol}");
Console.WriteLine($"Name: {quote.DisplayName}");
Console.WriteLine($"Price: {quote.RegularMarketPrice:C}");
Console.WriteLine($"52-Week High: {quote.FiftyTwoWeekHigh:C}");
Console.WriteLine($"52-Week Low: {quote.FiftyTwoWeekLow:C}");
Console.WriteLine($"Market Cap: {quote.MarketCap:N0}");
Console.WriteLine($"Dividend Yield: {quote.DividendYield:P}");
Console.WriteLine($"Earnings Date: {quote.EarningsDate:yyyy-MM-dd}");
Console.WriteLine();
}
}Offers stock, forex, and cryptocurrency data including intraday and historical records.
To get started, obtain a free API key from Alpha Vantage.
After acquiring your API key, configure it in your service collection:
services.AddFinanceNet(new FinanceNetConfiguration
{
AlphaVantageApiKey = "API_KEY"
});GetOverviewAsync
Retrieves an instrument overview for a specified stock symbol.
string symbol: The symbol of the asset (e.g.,"AAPL"for Apple).CancellationToken token: (Optional) A token to cancel the operation if needed.
A task that resolves to an InstrumentOverview?. The InstrumentOverview contains the following properties that provide key information about the company:
| Property | Type | Description | Example |
|---|---|---|---|
Symbol |
string? |
The stock symbol. | "AAPL" |
AssetType |
string? |
The type of asset (e.g., stock, ETF). | "Equity" |
Name |
string? |
The name of the ticker or company. | "Apple Inc." |
Description |
string? |
A brief company description. | "Designs ... ." |
CIK |
string? |
The Central Index Key (CIK) of the company. | "0000320193" |
Exchange |
string? |
The exchange where the company is listed. | "NASDAQ" |
Currency |
string? |
The currency used for financials. | "USD" |
Country |
string? |
The country where the company is located. | "United States" |
Sector |
string? |
The company's sector (e.g., Technology). | "Technology" |
Industry |
string? |
The industry the company operates in. | "Consumer Electronics" |
Address |
string? |
The company's headquarters address. | "Cupertino, CA" |
OfficialSite |
string? |
The official website of the company. | "https://www.apple.com" |
FiscalYearEnd |
string? |
The fiscal year end date. | "September 30" |
LatestQuarter |
string? |
The most recent available quarter. | "Q3 2024" |
MarketCapitalization |
long? |
The market capitalization. | 2320000000000 |
EBITDA |
string? |
EBITDA. | "11200000000" |
PERatio |
string? |
The Price-to-Earnings ratio. | "27.5" |
PEGRatio |
string? |
The Price/Earnings-to-Growth ratio. | "1.4" |
BookValue |
string? |
The company's book value. | "10.52" |
DividendPerShare |
string? |
The dividend per share. | "0.82" |
DividendYield |
string? |
The dividend yield. | "1.5%" |
EPS |
string? |
Earnings per share. | "5.26" |
RevenuePerShareTTM |
string? |
Revenue per share for the trailing twelve months. | "30.5" |
ProfitMargin |
string? |
Profit margin. | "25%" |
OperatingMarginTTM |
string? |
Operating margin for the trailing twelve months. | "22%" |
ReturnOnAssetsTTM |
string? |
Return on assets for the trailing twelve months. | "14%" |
ReturnOnEquityTTM |
string? |
Return on equity for the trailing twelve months. | "40%" |
RevenueTTM |
string? |
Revenue for the trailing twelve months. | "386000000000" |
GrossProfitTTM |
string? |
Gross profit for the trailing twelve months. | "160000000000" |
DilutedEPSTTM |
string? |
Diluted earnings per share for the trailing twelve months. | "5.10" |
QuarterlyEarningsGrowthYOY |
string? |
Quarterly earnings growth year-over-year. | "15%" |
QuarterlyRevenueGrowthYOY |
string? |
Quarterly revenue growth year-over-year. | "10%" |
AnalystTargetPrice |
string? |
Analyst target price for the stock. | "175.00" |
AnalystRatingStrongBuy |
string? |
Percentage of analysts recommending a strong buy. | "60%" |
AnalystRatingBuy |
string? |
Percentage of analysts recommending a buy. | "30%" |
AnalystRatingHold |
string? |
Percentage of analysts recommending a hold. | "10%" |
AnalystRatingSell |
string? |
Percentage of analysts recommending a sell. | "0%" |
AnalystRatingStrongSell |
string? |
Percentage of analysts recommending a strong sell. | "0%" |
TrailingPE |
string? |
Trailing Price-to-Earnings ratio. | "28" |
ForwardPE |
string? |
Forward Price-to-Earnings ratio. | "25" |
PriceToSalesRatioTTM |
string? |
Price-to-Sales ratio for the trailing twelve months. | "6.5" |
PriceToBookRatio |
string? |
Price-to-Book ratio. | "4.3" |
EVToRevenue |
string? |
Enterprise value-to-revenue ratio. | "8.2" |
EVToEBITDA |
string? |
Enterprise value-to-EBITDA ratio. | "14.5" |
Beta |
string? |
Beta value, measuring stock volatility. | "1.2" |
FiftySecondWeekHigh |
string? |
52-week high stock price. | "179.50" |
FiftySecondWeekLow |
string? |
52-week low stock price. | "120.10" |
FiftyDayMovingAverage |
string? |
50-day moving average. | "153.25" |
TwoHundredDayMovingAverage |
string? |
200-day moving average. | "157.80" |
SharesOutstanding |
string? |
Number of shares outstanding. | "5000000000" |
DividendDate |
string? |
Next dividend payment date. | "2025-02-01" |
ExDividendDate |
string? |
Ex-dividend date. |
public async Task Run(IAlphaVantageService alphaVantageService)
{
// Retrieve the overview for Apple Inc.
var overview = await alphaVantageService.GetOverviewAsync("AAPL");
if (overview != null)
{
Console.WriteLine($"Symbol: {overview.Symbol}");
Console.WriteLine($"Name: {overview.Name}");
Console.WriteLine($"Sector: {overview.Sector}");
Console.WriteLine($"Market Capitalization: {overview.MarketCapitalization}");
Console.WriteLine($"Dividend Yield: {overview.DividendYield}");
Console.WriteLine($"P/E Ratio: {overview.PERatio}");
Console.WriteLine($"Revenue (TTM): {overview.RevenueTTM}");
}
}GetRecordsAsync
Retrieves historical daily stock records for a given symbol within an optional date range.
string symbol: The stock symbol (e.g.,"AAPL"for Apple).DateTime? startDate: (Optional) Start date for the records. Defaults to 7 days ago.DateTime? endDate: (Optional) End date for the records. Defaults to current date.CancellationToken token: (Optional) A token to cancel the operation.
A task that resolves to an IEnumerable<Record>, with the following properties:
| Property | Type | Description | Example |
|---|---|---|---|
Date |
DateTime |
The date of the record. | "2024-12-15" |
Open |
double? |
The opening price of the asset. | 150.25 |
Low |
double? |
The lowest price of the asset on that date. | 148.75 |
High |
double? |
The highest price of the asset on that date. | 153.50 |
Close |
double? |
The closing price of the asset. | 151.00 |
AdjustedClose |
double? |
The adjusted closing price, considering stock splits and dividends. | 150.80 |
Volume |
long? |
The trading volume of the asset on that date. | 1000000 |
SplitCoefficient |
double? |
The stock split coefficient, if any, for the given date. | 1.0 |
public async Task Run(IAlphaVantageService alphaVantageService)
{
// Retrieve historical records for Apple Inc. (AAPL)
var records = await alphaVantageService.GetRecordsAsync("AAPL", DateTime.Now.AddDays(-7), DateTime.Now);
foreach (var record in records)
{
Console.WriteLine($"Date: {record.Date.ToShortDateString()}");
Console.WriteLine($"Open: {record.Open}");
Console.WriteLine($"High: {record.High}");
Console.WriteLine($"Low: {record.Low}");
Console.WriteLine($"Close: {record.Close}");
Console.WriteLine($"Adjusted Close: {record.AdjustedClose}");
Console.WriteLine($"Volume: {record.Volume}");
Console.WriteLine($"Split Coefficient: {record.SplitCoefficient}");
Console.WriteLine();
}
}GetForexRecordsAsync
Retrieves historical daily forex (foreign exchange) records for a given currency pair within a specified date range.
string currency1: The source currency (e.g.,"USD").string currency2: The target currency (e.g.,"EUR").DateTime startDate: The start date for the records.DateTime? endDate: (Optional) The end date for the records. Defaults to the current date.CancellationToken token: (Optional) A token to cancel the operation.
A task that resolves to an IEnumerable<ForexRecord>, with the following properties:
| Property | Type | Description | Example |
|---|---|---|---|
Date |
DateTime? |
The date of the forex record. | "2024-12-15" |
Open |
double? |
The opening price of the currency pair for that date. | 1.1215 |
High |
double? |
The highest price of the currency pair for that date. | 1.1250 |
Low |
double? |
The lowest price of the currency pair for that date. | 1.1180 |
Close |
double? |
The closing price of the currency pair for that date. | 1.1220 |
public async Task Run(IAlphaVantageService alphaVantageService)
{
// Retrieve historical forex records for USD to EUR
var forexRecords = await alphaVantageService.GetForexRecordsAsync("USD", "EUR", DateTime.Now.AddDays(-7));
foreach (var record in forexRecords)
{
Console.WriteLine($"Date: {record.Date}");
Console.WriteLine($"Open: {record.Open}");
Console.WriteLine($"Close: {record.Close}");
}
}GetIntradayRecordsAsync
Retrieves intraday stock records for a given symbol within a specified date range and time interval.
string symbol: The stock symbol (e.g.,"AAPL"for Apple).DateTime startDate: The start date for the records.DateTime? endDate: (Optional) The end date for the records. Defaults to the current date.EInterval interval: The time interval between data points. Default is 15 minutes. Possible values:Interval_1MinInterval_5MinInterval_15MinInterval_30MinInterval_60Min
CancellationToken token: (Optional) A token to cancel the operation.
A task that resolves to an IEnumerable<IntradayRecord>, with the following properties:
| Property | Type | Description | Example |
|---|---|---|---|
DateTime |
DateTime |
The date and time of the record. | "2024-12-15 09:30" |
Open |
double |
The opening price of the stock for that interval. | 145.32 |
High |
double |
The highest price of the stock for that interval. | 147.10 |
Low |
double |
The lowest price of the stock for that interval. | 144.98 |
Close |
double |
The closing price of the stock for that interval. | 146.30 |
Volume |
long |
The trading volume during that interval. | 1234567 |
public async Task Run(IAlphaVantageService alphaVantageService)
{
// Retrieve intraday stock records for AAPL with a 15-minute interval
var intradayRecords = await alphaVantageService.GetIntradayRecordsAsync("AAPL", DateTime.Now.AddDays(-1), DateTime.Now, EInterval.Interval_15Min);
foreach (var record in intradayRecords)
{
Console.WriteLine($"DateTime: {record.DateTime}");
Console.WriteLine($"Open: {record.Open}");
Console.WriteLine($"Close: {record.Close}");
}
}Accesses datasets like Nasdaq and S&P 500 companies.
GetNasdaqInstrumentsAsync
Retrieves a collection of more than 4,000 Nasdaq instruments.
CancellationToken token: (Optional) Cancellation token.
A task that resolves to an IEnumerable<NasdaqInstrument> containing the following properties for each item:
| Property | Type | Description | Example |
|---|---|---|---|
Symbol |
string? |
The ticker symbol of the instrument. | TSLA |
Name |
string? |
The company name associated with the instrument. | Tesla, Inc. |
public async Task Run(IDataHubService datahubService)
{
var instruments = await datahubService.GetNasdaqInstrumentsAsync();
foreach (var item in instruments)
{
Console.WriteLine($"Symbol: {item.Symbol}, Name: {item.Name}");
}
}GetSp500InstrumentsAsync
Retrieves a collection of S&P 500 instruments.
CancellationToken token: (Optional) Cancellation token.
A task that resolves to an IEnumerable<Sp500Instrument> containing the following properties for each item:
| Property | Type | Description | Example |
|---|---|---|---|
Symbol |
string? |
Ticker symbol of the instrument. | TSLA |
Name |
string? |
Name of the instrument/company. | Tesla, Inc. |
Sector |
string? |
Sector of the instrument. | Automobile Manufacturers |
Price |
double? |
Current price of the instrument. | 345.16 |
PriceEarnings |
double? |
Price-to-earnings ratio. | 94.31 |
DividendYield |
double? |
Dividend yield. | 0.89 |
EarningsShare |
double? |
Earnings per share. | 3.66 |
FiftyTwoWeekLow |
double? |
52-week low price. | 338.8 |
FiftyTwoWeekHigh |
double? |
52-week high price. | 361.93 |
MarketCap |
long? |
Market capitalization. | 1107284384000 |
EBITDA |
long? |
EBITDA value. | 13244000256 |
PriceSales |
double? |
Price-to-sales ratio. | 11.41 |
PriceBook |
double? |
Price-to-book ratio. | 15.82 |
public async Task Run(IDataHubService datahubService)
{
var instruments = await datahubService.GetSp500InstrumentsAsync();
foreach (var item in instruments)
{
Console.WriteLine($"Symbol: {item.Symbol}, Name: {item.Name}, Sector: {item.Sector}");
}
}A major European trading platform offering data on Xetra-listed instruments.
GetInstrumentsAsync
Retrieves a collection of more than 3,000 Xetra instruments.
CancellationToken token: (Optional) Cancellation token.
A task that resolves to an IEnumerable<Instrument> containing the following properties for each item:
| Property | Type | Description | Example |
|---|---|---|---|
Symbol |
string? |
Ticker symbol of the financial instrument. | TL0.DE |
InstrumentStatus |
string? |
Current status of the instrument. | Active |
InstrumentName |
string? |
Full name of the financial instrument. | TESLA INC. DL -,001 |
ISIN |
string? |
International Securities Identification Number. | US88160R1014 |
WKN |
string? |
German securities identification number. | 000A1CX3T |
Mnemonic |
string? |
Shorthand or mnemonic code for the instrument. | TL0 |
InstrumentType |
string? |
Type of financial instrument (e.g., CS, ETF, ETN). | CS |
Currency |
string? |
Currency in which the instrument is traded. | EUR |
public async Task Run(IXetraService xetraService)
{
var instruments = await xetraService.GetInstrumentsAsync();
foreach (var item in instruments)
{
Console.WriteLine($"Symbol: {item.Symbol}, Name: {item.InstrumentName}");
}
}We welcome contributions to Finance.NET! If you’d like to improve the project, please:
- Check out our contributing guidelines.
- Ideally, open an issue before starting work.
- Submit a pull request with your changes.
Thank you for helping make Finance.NET better!
Finance.NET is an open-source project using publicly accessible APIs and scraping techniques. It is intended for educational and research purposes.
For legal usage, refer to the terms of each data provider:
- Alpha Vantage: Terms of use
- DataHub: S&P 500 Companies Terms of Use, NASDAQ Listings Terms of Use
- Yahoo! Finance: API Terms of Use, Website Terms of Use, General Terms
- Xetra: Terms of use
For additional licensing and attribution details, see NOTICE.md and THIRD_PARTY_LICENSES.md.
If you encounter any issues or bugs, please report them here.