nimFinLib

Financial Library for Nim

Pure Nim score 15/100 · tests present · no docs generated

Summary

Latest Version Unknown
License MIT
CI Status Failing
Downloads 0
Last Indexed 2026-07-22 05:27

Tags

Installation

nimble install nimFinLib
choosenim install nimFinLib
git clone https://github.com/qqtop/NimFinLib

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
nimFinLib - - - - - - -

Source

Repository https://github.com/qqtop/NimFinLib
Homepage https://github.com/qqtop/NimFinLib
Registry Source nimble_official

README

NimFinLib

nimble Join the chat at https://gitter.im/qqtop/NimFinLib

Financial Library for Nim

(Work in Progress)

Description:

         Now using historic data via free apikey from Alpha Vantage. 
         Basic data fetching and data display is working.
         The indicator API does return data for some markets like USA , UK
         but not yet for others like Germany , Hongkong etc.
         The plan is to add portfolio management and analysis.
         Basic charts can currently be displayed via gnuplot.

Update Apr. 2018 :

         Data drawn from the API still seems to have occasional holes 
         especially for non US market stocks or is not available all
         the time . Often two or more hits are needed for the API
         to return data . Sometimes the API returns error messages
         of being hit too fast , despite one hit per second being
         the advertised capability and sufficient time spacing on the
         client side.
         Indicator data returns json data fine , but currently only for certain US stocks. 
         Batch fetching of stock data only works for US market components and may return
         a default timestamp of 1969 during off trading hours.

Update Oct. 2018

        Data quality and speed has slightly improved , unfortunately the free apikey now has a
        standard call-frequency limit of 4-5 requests per minute , which is much too low
        for any reasonable work.
        Of course there is the premium option which allows more requests / minute. 
        Kitco metal prices are not effected by this call limit . 
        The library has been updated to work with nim 0.19.x 
        If sudden crashes occure see : cat /dev/shm/avdata.csv
        most likely reason is inserted nagging lines by the api to ask for registration
        and once registered ask to visit their premium site.

Update Feb. 2019

        Made the library compile with latest nim devel
        Call frequency limit stated above has unfortunately not improved so far.
        The current nagging line is:
           "Thank you for using Alpha Vantage! Our standard API call frequency is 5 
           calls per minute and 500 calls per day."

        Another option may be IEX https://iextrading.com/developer
        a very limited free plan appears to be available

Update Jan. 2021

        Library works with Nim 1.5.1
Library Status Version License OS Compiler
nimFinLib Development 0.3.0.x MIT opensource Linux Nim >= 1.4.2

Data gathering and calculations support

          Alpha Vantage Api support


          Dataframe for display and easy working with dataseries

          Multiple accounts and portfolios management

          Returns calculations and more

          Williams R% calculation

          Indicator displays

          Kitco Metal Prices

          US market spot prices

          Digital currencies 5 min intraday prices .

API Docs

  Planned to be in

  http://qqtop.github.io/nimFinLib.html

  # http://qqtop.github.io/libFinHk.html

Tests and Examples

  nimexrates  
  nfT53       
  nfT55  
  nfT60     
  nimmetal

Requirements

  nimcx         nimble install nimcx

  nimdataframe  nimble install https://github.com/qqtop/nimdataframe.git

Installation

  nimble install nimFinLib

  Note : it is always a good idea to install the latest libraries

Image
Example screen from quickStock.nim

Image
Example screen from nfT58.nim

Image
Example screen from quickSpot.nim showing some quotes for Vanguard components.

Image
Example screen from an attempt to plot williams R indicator output plotting is done via gnuplot.nim ex https://github.com/dvolk/gnuplot.nim

Image

Image

Image Example screen from nfT53.nim

Image Example screen from nfT55.nim displaying SMA,WMA,EMA Indicator data

Below screenshots of nimFinLib usage prior to demise of Yahoo Finance API on Nov 1 2017.

Image Example screen from nfT50.nim

Image Example screen from minifin.nim

NOTE :

 Improvements may be made at any time.              
 Forking ,testing, suggestions ,ideas are welcome.
 This is development code , use at your own risk.



 Tested on openSuse TumbleWeed, Debian Testing

Image qqTop - 2021