Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ooples/ooplesfinance.yahoofinanceapi

A .NET API wrapper for Yahoo Finance that allows users to get top trending stocks, historical stock data, stock splits, dividends, capital gains, and much much more!
https://github.com/ooples/ooplesfinance.yahoofinanceapi

rest-api stock stock-data stock-market stock-market-analysis stockprice stockprices stocks trending yahoo yahoo-api yahoo-finance yahoo-finance-api yahoo-finance-apis yahoo-finance-data

Last synced: 14 days ago
JSON representation

A .NET API wrapper for Yahoo Finance that allows users to get top trending stocks, historical stock data, stock splits, dividends, capital gains, and much much more!

Awesome Lists containing this project

README 

        
![Nuget](https://img.shields.io/nuget/dt/OoplesFinance.YahooFinanceAPI?style=plastic)

![Nuget (with prereleases)](https://img.shields.io/nuget/vpre/OoplesFinance.YahooFinanceAPI?style=plastic)

![github](https://img.shields.io/github/license/ooples/OoplesFinance.YahooFinanceAPI?style=plastic)

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/147ed8075c6048ffb3b335b445e83738)](https://app.codacy.com/gh/ooples/OoplesFinance.YahooFinanceAPI?utm_source=github.com&utm_medium=referral&utm_content=ooples/OoplesFinance.YahooFinanceAPI&utm_campaign=Badge_Grade_Settings)



## .Net Yahoo Finance API Library



This is a library for downloading free data using Yahoo Finance that is completely open source (Apache 2.0 license) and very easy to use. 

This library currently supports downloading 39 different types of stock market data at the time of this writing: 

historical/daily prices, stock splits, dividends, capital gains, stock recommendations, insider holders, key stats, financial data, 

insider transactions, fund ownership, major direct holders, top trending stock information, and much much more! 

Instead of listing everything, I decided it would be easier to provide examples below of every possible data type and how to use them. 

We support getting daily, weekly, or monthly data as well as many other options.



### UPDATE For EU Users

After some research, I was able to confirm that cookies aren't working for EU users since Yahoo requires that consent is given before the proper cookie can be created. I'm looking into possible workarounds for this issue at the moment and will give updates if I find an answer.



### How to use this library



Here is an example to show how easy it is to use this library to get various stock market info:



```cs

using OoplesFinance.YahooFinanceAPI;

using OoplesFinance.YahooFinanceAPI.Enums;



var startDate = DateTime.Now.AddYears(-1);

var symbol = "AAPL";

var fundSymbol = "VSMPX";

var symbols = new string[] { symbol, "MSFT", "NFLX", "TSLA", "YHOO", "SPY", "A", "AA", "GOOG", "F", "UBER", "LYFT" };



var yahooClient = new YahooClient();

var historicalDataList = await yahooClient.GetHistoricalDataAsync(symbol, DataFrequency.Daily, startDate);

var capitalGainList = await yahooClient.GetCapitalGainDataAsync(symbol, DataFrequency.Monthly, startDate);

var dividendList = await yahooClient.GetDividendDataAsync(symbol, DataFrequency.Weekly, startDate);

var stockSplitList = await yahooClient.GetStockSplitDataAsync(symbol, DataFrequency.Monthly, startDate);

var topTrendingList = await yahooClient.GetTopTrendingStocksAsync(Country.UnitedStates, 10);

var recommendedList = await yahooClient.GetStockRecommendationsAsync(symbol);

var keyStatsList = await yahooClient.GetKeyStatisticsAsync(symbol);

var summaryDetailsList = await yahooClient.GetSummaryDetailsAsync(symbol);

var insiderHoldersList = await yahooClient.GetInsiderHoldersAsync(symbol);

var insiderTransactionsList = await yahooClient.GetInsiderTransactionsAsync(symbol);

var financialDataList = await yahooClient.GetFinancialDataAsync(symbol);

var institutionOwnershipList = await yahooClient.GetInstitutionOwnershipAsync(symbol);

var fundOwnershipList = await yahooClient.GetFundOwnershipAsync(symbol);

var majorDirectHoldersList = await yahooClient.GetMajorDirectHoldersAsync(symbol);

var secFilingsList = await yahooClient.GetSecFilingsAsync(symbol);

var insightsList = await yahooClient.GetInsightsAsync(symbol);

var majorHoldersBreakdownList = await yahooClient.GetMajorHoldersBreakdownAsync(symbol);

var upgradeDowngradeHistoryList = await yahooClient.GetUpgradeDowngradeHistoryAsync(symbol);

var esgScoresList = await yahooClient.GetEsgScoresAsync(symbol);

var recommendationTrendList = await yahooClient.GetRecommendationTrendAsync(symbol);

var indexTrendList = await yahooClient.GetIndexTrendAsync(symbol);

var sectorTrendList = await yahooClient.GetSectorTrendAsync(symbol);

var earningsTrendList = await yahooClient.GetEarningsTrendAsync(symbol);

var assetProfileList = await yahooClient.GetAssetProfileAsync(symbol);

var fundProfileList = await yahooClient.GetFundProfileAsync(fundSymbol);

var calendarEventsList = await yahooClient.GetCalendarEventsAsync(symbol);

var earningsList = await yahooClient.GetEarningsAsync(symbol);

var balanceSheetHistoryList = await yahooClient.GetBalanceSheetHistoryAsync(symbol);

var cashflowStatementHistoryList = await yahooClient.GetCashflowStatementHistoryAsync(symbol);

var incomeStatementHistoryList = await yahooClient.GetIncomeStatementHistoryAsync(symbol);

var earningsHistoryList = await yahooClient.GetEarningsHistoryAsync(symbol);

var quoteTypeList = await yahooClient.GetQuoteTypeAsync(symbol);

var priceList = await yahooClient.GetPriceInfoAsync(symbol);

var netSharePurchaseActivityList = await yahooClient.GetNetSharePurchaseActivityAsync(symbol);

var incomeStatementHistoryQuarterlyList = await yahooClient.GetIncomeStatementHistoryQuarterlyAsync(symbol);

var cashflowStatementHistoryQuarterlyList = await yahooClient.GetCashflowStatementHistoryQuarterlyAsync(symbol);

var balanceSheetHistoryQuarterlyList = await yahooClient.GetBalanceSheetHistoryQuarterlyAsync(symbol);

var chartInfoList = await yahooClient.GetChartInfoAsync("GOOG", TimeRange._1Year, TimeInterval._1Day);

var sparkChartInfoList = await yahooClient.GetSparkChartInfoAsync(symbols, TimeRange._1Month, TimeInterval._1Day);

var realTimeQuoteList = await yahooClient.GetRealTimeQuotesAsync(symbols);

var marketSummaryList = await yahooClient.GetMarketSummaryAsync();

var autoCompleteList = await yahooClient.GetAutoCompleteInfoAsync("Google");

var topGainersList = await yahooClient.GetTopGainersAsync(10);

var topLosersList = await yahooClient.GetTopLosersAsync(10);

var smallCapGainersList = await yahooClient.GetSmallCapGainersAsync(10);

var mostActiveStocksList = await yahooClient.GetMostActiveStocksAsync(10);

var aggressiveSmallCapsList = await yahooClient.GetAggressiveSmallCapStocksAsync(10);

var conservativeForeignFundsList = await yahooClient.GetConservativeForeignFundsAsync(10);

var growthTechStocksList = await yahooClient.GetGrowthTechnologyStocksAsync(10);

var highYieldBondsList = await yahooClient.GetHighYieldBondsAsync(10);

var mostShortedStocksList = await yahooClient.GetMostShortedStocksAsync(10);

var portfolioAnchorsList = await yahooClient.GetPortfolioAnchorsAsync(10);

var solidLargeGrowthFundsList = await yahooClient.GetSolidLargeGrowthFundsAsync(10);

var solidMidcapGrowthFundsList = await yahooClient.GetSolidMidcapGrowthFundsAsync(10);

var topMutualFundsList = await yahooClient.GetTopMutualFundsAsync(10);

var undervaluedGrowthStocksList = await yahooClient.GetUndervaluedGrowthStocksAsync(10);

var undervaluedLargeCapsList = await yahooClient.GetUndervaluedLargeCapStocksAsync(10);

var undervaluedWideMoatStocksList = await yahooClient.GetUndervaluedWideMoatStocksAsync(10);

var morningstarFiveStarStocksList = await yahooClient.GetMorningstarFiveStarStocksAsync(10);

var strongUndervaluedStocksList = await yahooClient.GetStrongUndervaluedStocksAsync(10);

var analystStrongBuyStocksList = await yahooClient.GetAnalystStrongBuyStocksAsync(10);

var latestAnalystUpgradedStocksList = await yahooClient.GetLatestAnalystUpgradedStocksAsync(10);

var mostInstitutionallyBoughtLargeCapStocksList = await yahooClient.GetMostInstitutionallyBoughtLargeCapStocksAsync(10);

var mostInstitutionallyHeldLargeCapStocksList = await yahooClient.GetMostInstitutionallyHeldLargeCapStocksAsync(10);

var mostInstitutionallySoldLargeCapStocksList = await yahooClient.GetMostInstitutionallySoldLargeCapStocksAsync(10);

var stocksWithMostInstitutionalBuyersList = await yahooClient.GetStocksWithMostInstitutionalBuyersAsync(10);

var stocksWithMostInstitutionalSellersList = await yahooClient.GetStocksWithMostInstitutionalSellersAsync(10);

var stocksMostBoughtByHedgeFundsList = await yahooClient.GetStocksMostBoughtByHedgeFundsAsync(10);

var stocksMostBoughtByPensionFundsList = await yahooClient.GetStocksMostBoughtByPensionFundsAsync(10);

var stocksMostBoughtByPrivateEquityList = await yahooClient.GetStocksMostBoughtByPrivateEquityAsync(10);

var stocksMostBoughtBySovereignWealthFundsList = await yahooClient.GetStocksMostBoughtBySovereignWealthFundsAsync(10);

var topStocksOwnedByCathieWoodList = await yahooClient.GetTopStocksOwnedByCathieWoodAsync(10);

var topStocksOwnedByGoldmanSachsList = await yahooClient.GetTopStocksOwnedByGoldmanSachsAsync(10);

var topStocksOwnedByWarrenBuffetList = await yahooClient.GetTopStocksOwnedByWarrenBuffetAsync(10);

var topStocksOwnedByRayDalioList = await yahooClient.GetTopStocksOwnedByRayDalioAsync(10);

var topBearishStocksRightNowList = await yahooClient.GetTopBearishStocksRightNowAsync(10);

var topBullishStocksRightNowList = await yahooClient.GetTopBullishStocksRightNowAsync(10);

var topUpsideBreakoutStocksList = await yahooClient.GetTopUpsideBreakoutStocksAsync(10);

```



### Support This Project



BTC: 36DRmZefJNW82q9pHY1kWYSZhLUWQkpgGq



ETH: 0x7D6e58754476189ffF736B63b6159D2647f74f34



USDC: 0x587Ae0709f45b970992bdD772bF693141D95CAED



DOGE: DF1nsK1nLASzmwHNAfNengBGS4w7bNyJ1e



SHIB: 0xCDe2355212764218355c9393FbE121Ae49B43382



Paypal: [https://www.paypal.me/cheatcountry](https://www.paypal.me/cheatcountry)



Patreon: [https://patreon.com/cheatcountry](https://patreon.com/cheatcountry)



### Support or Contact



Email me at [email protected] for any help or support or to let me know of ways to further improve this library.