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(newFinanceNetConfiguration{HttpTimeout=5,// seconds (default: 20)HttpRetryCount=3,// default: 10HttpRetrySleepTime=5,// seconds, base for exponential back-off; capped at 30s per attempt, plus jitter (default: 5)AlphaVantageApiKey="ALPHA_VANTAGE__API_KEY"});Example: Retrieve historical and real-time data for Tesla (TSLA):
publicasyncTaskRun(IYahooFinanceServiceyahooService){varsymbol="TSLA";varstartDate=newDateTime(2020,1,1);varrecords=awaityahooService.GetRecordsAsync(symbol,startDate);foreach(varrecordinrecords){Console.WriteLine($"Date={record.Date}: {record.Open} / {record.Close}");}varquote=awaityahooService.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 |
publicasyncTaskRun(IYahooFinanceServiceyahooService){// Retrieve all instrumentsvarinstruments=awaityahooService.GetInstrumentsAsync();// Retrieve only stock instrumentsvarstockInstruments=awaityahooService.GetInstrumentsAsync(EInstrumentType.Stock);foreach(varinstrumentinstockInstruments){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 ... |
publicasyncTaskRun(IYahooFinanceServiceyahooService){varprofile=awaityahooService.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. | 200.00 |
publicasyncTaskRun(IYahooFinanceServiceyahooService){// Retrieve the summary for Apple Inc.varsummary=awaityahooService.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 |
publicasyncTaskRun(IYahooFinanceServiceyahooService){// Retrieve financial reports for Apple Inc.varfinancialReports=awaityahooService.GetFinancialsAsync("AAPL");foreach(varlabelinfinancialReports.Keys){varreport=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 |
publicasyncTaskRun(IYahooFinanceServiceyahooService){// Retrieve historical records for Apple Inc. for the last 30 daysvarstartDate=DateTime.UtcNow.AddDays(-30);varendDate=DateTime.UtcNow;varrecords=awaityahooService.GetRecordsAsync("AAPL",startDate,endDate);foreach(varrecordinrecords){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 (Environmental, Social, Governance) data is populated. | 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" |
publicasyncTaskDisplayQuote(IYahooFinanceServiceyahooService){// Retrieve a quote for Apple Inc.varquote=awaityahooService.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 (Environmental, Social, Governance) data is populated. | 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" |
publicasyncTaskRun(IYahooFinanceServiceyahooService){// Retrieve quotes for Apple, Microsoft, and Googlevarsymbols=newList<string>{"AAPL","MSFT","GOOGL"};varquotes=awaityahooService.GetQuotesAsync(symbols);foreach(varquoteinquotes){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(newFinanceNetConfiguration{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. | "2025-01-10" |
publicasyncTaskRun(IAlphaVantageServicealphaVantageService){// Retrieve the overview for Apple Inc.varoverview=awaitalphaVantageService.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 |
publicasyncTaskRun(IAlphaVantageServicealphaVantageService){// Retrieve historical records for Apple Inc. (AAPL)varrecords=awaitalphaVantageService.GetRecordsAsync("AAPL",DateTime.Now.AddDays(-7),DateTime.Now);foreach(varrecordinrecords){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 |
publicasyncTaskRun(IAlphaVantageServicealphaVantageService){// Retrieve historical forex records for USD to EURvarforexRecords=awaitalphaVantageService.GetForexRecordsAsync("USD","EUR",DateTime.Now.AddDays(-7));foreach(varrecordinforexRecords){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 |
publicasyncTaskRun(IAlphaVantageServicealphaVantageService){// Retrieve intraday stock records for AAPL with a 15-minute intervalvarintradayRecords=awaitalphaVantageService.GetIntradayRecordsAsync("AAPL",DateTime.Now.AddDays(-1),DateTime.Now,EInterval.Interval_15Min);foreach(varrecordinintradayRecords){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. |
publicasyncTaskRun(IDataHubServicedatahubService){varinstruments=awaitdatahubService.GetNasdaqInstrumentsAsync();foreach(varitemininstruments){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 |
publicasyncTaskRun(IDataHubServicedatahubService){varinstruments=awaitdatahubService.GetSp500InstrumentsAsync();foreach(varitemininstruments){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 |
publicasyncTaskRun(IXetraServicexetraService){varinstruments=awaitxetraService.GetInstrumentsAsync();foreach(varitemininstruments){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.
If you encounter any issues or bugs, please report them here.