thisiscetin / indicado

Indicado 🚀🌕

Technical indicator library for Elixir with no dependencies. Indicado helps you analyze historical data to generate future price movement predictions on numerical datasets. Many traders and automated trading platforms use technical analysis because past actions may indicate future prices. Indicado might also be used outside financial markets if data hold patterns and not random.

What can you do with this library ❔

This library can be used as an add-on to Kamil Skorwon's great project Hands-on Elixir & OTP: Cryptocurrency trading bot, at some point. So, you can create sophisticated trading strategies that may better fit your risk appetite. You can also use this library for your custom solutions around automated trading/testing/strategy building.

In the future, in addition to supporting the community, I plan to release more open source tools around strategy building, backtesting, and numerical analysis.

Table of Contents 📋

• Indicado
• What can you do with this library
• Table of Contents
• Supported Indicators
• Installation
• Usage
• Contributing

Supported Indicators 📈

Indicators below are supported. New indicators being added regularly.

• Accumulation/Distribution Line (ADI)
• Bollinger Bands (BB)
• Exponential Moving Average (EMA)
• Money Flow Index (MFI)
• Moving Average Convergence Divergence (MACD)
• On-Balance Volume (OBV)
• Relative Strength Index (RSI)
• Simple Moving Average (SMA)
• Stochastic Oscillator (SR)
• Williams %R (WR)

Helper math functions such as mean, stddev, variance is accessible through Indicado.Math module.

Installation 💻

Indicado published to Hex. Just add it to your dependencies in mix.exs.

def deps do
  [
    {:indicado, "~> 0.0.4"}
  ]
end

Then run mix deps.get to install indicado.

Usage 🛠️

Indicado provides two functions on the public API of indicators. Namely eval and eval! function.

• eval function calls return {:ok, result} or {:error, reason}.
• eval! functions return a single result list or raises exceptions such as NotEnoughDataError.

Because every other indicator may expect different arguments, I recommend you check online documentation on hexdocs before using the indicado. For demonstration purposes how you can calculate a four day Simple Moving Average is shown below.

  iex(2)> Indicado.SMA.eval([1.0, 5.0, 7.4, 12.5, 16,4], 4)
  {:ok, [6.475, 10.225, 9.975]}

Contributing 🧵

Please follow standard convention such as eval and eval! functions defined for all indicators inside lib folder. Rest is easy;

• Fork it!
• Create your feature branch (git checkout -b my-new-feature)
• Commit your changes (git commit -am 'Add some feature')
• Push to the branch (git push origin my-new-feature)
• Create new Pull Request

To ensure a commit passes CI run mix test.ci before opening a pull request to execute commands below.