phmatray/talibstandard

TaLib in C# for .NET Standard

TaLibStandard

A modern and robust C# Technical Analysis library based on the original open-source TA-Lib by Mario Fortier, using Generic Math and supporting Double, Float, and Decimal data types.

---

---

📝 Table of Contents

• TaLibStandard
  • 📝 Table of Contents
  • 📚 Introduction
  • 🎯 Goal
  • 🏁 Getting started
  • 📌 Features
    • Roadmap (next features)
  • 📄 Documentation
  • 📥 Installation
    • 📋 Prerequisites
    • 🚀 We use the latest C# features
    • 📦 NuGet Packages
    • 🧪 Tests Specifications
  • 💾 Installation
  • 📊 Code Quality
  • ❓ Issues and Feature Requests
  • 🤝 Contributing
  • 🌟 Contributors
  • ✉️ Contact
  • 📝 Release notes
  • 📜 License

📚 Introduction

TaLibStandard is a modern interpretation of the widely used TA-Lib, reimagined in C# 12. It is designed to be reliable, efficient, and user-friendly for developers performing financial market analysis. The addition of .NET's Generic Math feature allows for a richer, more flexible library that can handle a variety of number types.

🎯 Goal

The primary objective of TaLibStandard is to provide a comprehensive, feature-rich and accessible library for conducting technical analysis on financial market data.

🏁 Getting started

To get started with TaLibStandard, you can clone the repository and explore the examples provided in the examples directory. You can also refer to the list of available functions in the documentation for a comprehensive overview of the library's capabilities.

📌 Features

• Support for Double, Float, and Decimal data types, with the help of .NET's Generic Math
• With some basic tests (coverage: >= 80%)
• .NET Exception handling (BREAKING CHANGE)

Roadmap (next features)

• Comprehensive API documentation that is easy to understand
• High-Level API for common use cases
• Support for more data types
• Support for more functions
• More tests
• More examples
• Add a Benchmark project
• Create a gRPC server to expose the library as a service

📄 Documentation

TaLibStandard provides a COMPLETE DOCUMENTATION of the library.

All summaries are written in English. If you want to help us translate the documentation, please open an issue to discuss it.

Note: The documentation is generated using Doraku/DefaultDocumentation tool. It is generated automatically when the project is built.

📥 Installation

📋 Prerequisites

• .NET 8.0 (supported versions: 8.x)
• A C# IDE (Visual Studio, JetBrains Rider, etc.)
• A C# compiler (dotnet CLI, etc.)

🚀 We use the latest C# features

This library targets .NET 8.0 and uses the latest C# features. It is written in C# 12.0 and uses the new init properties, record types, switch expressions, using declarations and more.

I invite you to read the C# 12.0 documentation to learn more about these features.

📦 NuGet Packages

Package Name	NuGet Version Badge	NuGet Downloads Badge	Package Explorer
Atypical.TechnicalAnalysis.Candles			Explore
Atypical.TechnicalAnalysis.Functions			Explore
Atypical.TechnicalAnalysis.Core			Explore

This table is automatically updated regularly the latest developments and releases in the Atypical Technical Analysis suite.

🧪 Tests Specifications

• Target framework : .NET 8
• Language version : C# 12
• xUnit and FluentAssertions

💾 Installation

To install TaLibStandard, you can use the NuGet package manager. Run the following command in your terminal:

dotnet add package Atypical.TechnicalAnalysis.Candles
dotnet add package Atypical.TechnicalAnalysis.Functions

📊 Code Quality

We strive for the highest code quality in TaLibStandard, leveraging Codacy—an automated code analysis/quality tool. Codacy provides static analysis, cyclomatic complexity measures, duplication identification, and code unit test coverage changes for every commit and pull request.

View our Codacy metrics here.

❓ Issues and Feature Requests

For reporting bugs or suggesting new features, kindly submit these as an issue to the TaLibStandard Repository. We value your contributions, but before submitting an issue, please ensure it is not a duplicate of an existing one.

🤝 Contributing

We welcome contributions from the community! If you'd like to contribute to TaLibStandard, please fork the repository and submit a pull request. For major changes, please open an issue first to discuss what you would like to change.

🌟 Contributors

✉️ Contact

You can contact us by opening an issue on this repository.

📝 Release notes

Here is a list of recent notable changes to TaLibStandard.

• dotnet 8.0 support
• Generic Math support
• .NET Exception handling
• NuGet packages

📜 License

GNU General Public License v3.0 or later.

talibstandard's Issues

Not sure, but seems a bug to me

TaLibStandard/src/TechnicalAnalysis.Candles/Candle3WhiteSoldiers/Candle3WhiteSoldiers.cs

Line 75 in 6d23694

return new CandleIndicatorResult(Success, outBegIdx, outNBElement, outInteger);

I'm trying identify patterns right after market opens, in 5 minutes candles. For instance, when I run GetLookback() for Candle3WhiteSoldiers, I got 12, so What I understand is that I have to have 12 5 minute candles to be able to identify this pattern. In other words, I can only identify it after 60 minutes, and I wanted to identify it in the first 20 to 30 minutes. Is it possible to change it to a shorter interval?

The bug I think exists is:

If we don't have enough candles to identify the pattern, it shouldn't return a success message here, but an error message, am I right?

    // Identify the minimum number of price bar needed to calculate at least one output.
    int lookbackTotal = GetLookback();

    // Move up the start index if there is not enough initial data.
    if (startIdx < lookbackTotal)
    {
        startIdx = lookbackTotal;
    }

    // Make sure there is still something to evaluate.
    if (startIdx > endIdx)
    {
        return new CandleIndicatorResult(**Success**, outBegIdx, outNBElement, outInteger);
    }

If I'm wrong, I apologize, I'm a little rusty with programming.
Thanks, and nice job

Request for implement ZigZag indicator

I love this indicator for following Long and Short Time. The rols like this

https://www.investopedia.com/terms/z/zig_zag_indicator.asp

Thx

Could you public to Nuget package?

Bug: Invalid conditions in CandleEngulfing pattern recognition

There are invalid conditions:

These conditions always false except of float, double values (that can be different due to conversion)
In theory these conditions are always false.
I Suggest removing lines 108 and 115.