Fynance 1.0.1

Fynance is a wrapper for stack market data based on .Net Standard. It is current working with Yahoo Finance but new providers can be added in the next versions.

Install-Package Fynance -Version 1.0.1
dotnet add package Fynance --version 1.0.1
<PackageReference Include="Fynance" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Fynance --version 1.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Fynance

Fynance is a handy wrapper to get stock market quotes written in .Net Standard. It is currently support the Yahoo Finance but it can be extended to other APIs.

Fynance Project Status

Build Status
NuGet
NuGet Downloads
GitHub Stars
GitHub Issues
Apache License

Installation - Nuget Package

This is available on nuget package.

Install-Package Fynance

To update the package to the last version use the following nuget statement:

Update-Package Fynance

Fynance Examples

What data you can get with Fynance:

  • Get Security Info
  • Get Quotes
  • Get Events
    • Get Dividends
    • Get Splits
General Usage

First you have to add the Fynance namespace to make the types available on your code:

using Fynance;

The Fynance implements a fluent interface to read data from a stock market api. Given it, a instance of Ticker is a representation of a security on the stock market. Then you can make an instance of Ticker and use all the methods to configure what you want to have until call the Get method. There is a async version of this method called GetAsync. The following code is a sample of use:

var result = await Ticker.Build()
                         .SetSymbol("MSFT")
                         .SetPeriod(Period.OneMonth)
                         .SetInterval(Interval.OneDay)
                         .GetAsync();

The Build method instance the Ticker object and all these Set methods configure what information you want to get from the available APIs.

To the the events as we call dividends or splits you can use SetDividends and SetEvents to define it:

var result = await Ticker.Build()
                         .SetSymbol("MSFT")
                         .SetPeriod(Period.OneMonth)
                         .SetInterval(Interval.OneDay)
                         .SetDividends(true)
                         .SetEvents(true)
                         .GetAsync();

Alternatively, you can use the method .SetEvents(true) and it will set Dividends and Splits.

When you call the Get methods, you get a instance of FyResult. It contains all the data following the methods configured over the Ticker. The FyResult can contain all the information from the Security, the OLHC history, dividends and splits.

Results

There are many information you can read from the security, see some samples available:

var currenty = result.Currency;
var symbol = result.Symbol;
var symbol = result.ExchangeName;

Reading all the OLHC history:

foreach (var item in result.Quotes)
{
   var period = item.Period; // DateTime
   var open = item.Open; // Double 
   var low = item.Low; // Double 
   var high = item.High; // Double 
   var close = item.Close; // Double 
   var close = item.Close; // Double 
   var adjClose = item.AdjClose; // Double 
   var volume = item.Volume; // Double 
}

Reading the dividends:

foreach (var item in result.Dividends)
{
   var date = item.Date; // DateTime: Payment date 
   var value = item.value; // Double: Payment value
}

Reading the splits:

foreach (var item in result.Splits)
{
   var date = item.Date; // DateTime: Date 
   var numerator = item.Numberator; // Double: Numerator of splits
   var denominator = item.Denominator; // Double: Denominator of split
}

Issue Reports

If you find any issue, please report them using the GitHub issue tracker. Would be great if you provide a sample of code or a repository with a sample project.

Licenses

This software is distributed under the terms of the Apache License 2.0. Please, read the LICENSE file available on this repository.

Credits

This project is a collab of @FelipeOriani and @EduVencovsky.

Many thanks for the Newtonsoft.Json packaged used as a dependency of this project.

Fynance

Fynance is a handy wrapper to get stock market quotes written in .Net Standard. It is currently support the Yahoo Finance but it can be extended to other APIs.

Fynance Project Status

Build Status
NuGet
NuGet Downloads
GitHub Stars
GitHub Issues
Apache License

Installation - Nuget Package

This is available on nuget package.

Install-Package Fynance

To update the package to the last version use the following nuget statement:

Update-Package Fynance

Fynance Examples

What data you can get with Fynance:

  • Get Security Info
  • Get Quotes
  • Get Events
    • Get Dividends
    • Get Splits
General Usage

First you have to add the Fynance namespace to make the types available on your code:

using Fynance;

The Fynance implements a fluent interface to read data from a stock market api. Given it, a instance of Ticker is a representation of a security on the stock market. Then you can make an instance of Ticker and use all the methods to configure what you want to have until call the Get method. There is a async version of this method called GetAsync. The following code is a sample of use:

var result = await Ticker.Build()
                         .SetSymbol("MSFT")
                         .SetPeriod(Period.OneMonth)
                         .SetInterval(Interval.OneDay)
                         .GetAsync();

The Build method instance the Ticker object and all these Set methods configure what information you want to get from the available APIs.

To the the events as we call dividends or splits you can use SetDividends and SetEvents to define it:

var result = await Ticker.Build()
                         .SetSymbol("MSFT")
                         .SetPeriod(Period.OneMonth)
                         .SetInterval(Interval.OneDay)
                         .SetDividends(true)
                         .SetEvents(true)
                         .GetAsync();

Alternatively, you can use the method .SetEvents(true) and it will set Dividends and Splits.

When you call the Get methods, you get a instance of FyResult. It contains all the data following the methods configured over the Ticker. The FyResult can contain all the information from the Security, the OLHC history, dividends and splits.

Results

There are many information you can read from the security, see some samples available:

var currenty = result.Currency;
var symbol = result.Symbol;
var symbol = result.ExchangeName;

Reading all the OLHC history:

foreach (var item in result.Quotes)
{
   var period = item.Period; // DateTime
   var open = item.Open; // Double 
   var low = item.Low; // Double 
   var high = item.High; // Double 
   var close = item.Close; // Double 
   var close = item.Close; // Double 
   var adjClose = item.AdjClose; // Double 
   var volume = item.Volume; // Double 
}

Reading the dividends:

foreach (var item in result.Dividends)
{
   var date = item.Date; // DateTime: Payment date 
   var value = item.value; // Double: Payment value
}

Reading the splits:

foreach (var item in result.Splits)
{
   var date = item.Date; // DateTime: Date 
   var numerator = item.Numberator; // Double: Numerator of splits
   var denominator = item.Denominator; // Double: Denominator of split
}

Issue Reports

If you find any issue, please report them using the GitHub issue tracker. Would be great if you provide a sample of code or a repository with a sample project.

Licenses

This software is distributed under the terms of the Apache License 2.0. Please, read the LICENSE file available on this repository.

Credits

This project is a collab of @FelipeOriani and @EduVencovsky.

Many thanks for the Newtonsoft.Json packaged used as a dependency of this project.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
1.0.1 139 6/11/2020
1.0.0 73 6/1/2020