*** IMPORTANT LEGAL DISCLAIMER ***Yahoo!, Y!Finance, and Yahoo! finance are registered trademarks of Yahoo, Inc. yfinrb is not affiliated, endorsed, or vetted by Yahoo, Inc. It is an open-source tool that uses Yahoo's publicly available APIs, and is intended for research and educational purposes. You should refer to Yahoo!'s terms of use (here, here, and here) for details on your rights to use the actual data downloaded. Remember - the Yahoo! finance API is intended for personal use only. |
This package provides for pulling data from Yahoo!'s unofficial API, and providing that data using using Polars dataframes in ruby. Data in those dataframes can then be easily post-processed using technical indicators provided by Tulip via Tulirb's ruby bindings, and visualized using Vega.
The Ticker class, which allows you to access ticker data from Yahoo!'s unofficial API:
msft = Yfinrb::Ticker.new("MSFT")
# get all stock info
msft.info
# get historical market data as a dataframe
hist = msft.history(period: "1mo")
hist2 = msft.history(start: '2020-01-01', fin: '2021-12-31')
# show meta information about the history (requires history() to be called first)
msft.history_metadata
# show actions (dividends, splits, capital gains)
msft.actions
msft.dividends
msft.splits
msft.capital_gains # only for mutual funds & etfs
# show share count
msft.shares_full(start: "2022-01-01", fin: nil)
# show financials:
# - income statement
msft.income_stmt
msft.quarterly_income_stmt
# - balance sheet
msft.balance_sheet
msft.quarterly_balance_sheet
# - cash flow statement
msft.cashflow
msft.quarterly_cashflow
# show holders
msft.major_holders
msft.institutional_holders
msft.mutualfund_holders
msft.insider_transactions
msft.insider_purchases
msft.insider_roster_holders
# show recommendations
msft.recommendations
msft.recommendations_summary
msft.upgrades_downgrades
# Show future and historic earnings dates, returns at most next 4 quarters and last 8 quarters by default.
msft.earnings_dates
# show ISIN code
# ISIN = International Securities Identification Number
msft.isin
# show options expirations
msft.options
# show news
msft.news
# get option chain for specific expiration
opt = msft.option_chain('2026-12-18')
# data available via: opt.calls, opt.puts
# technical operations, using the Tulirb gem, which provides bindings to
# the Tulip technical indicators library
h = msft.history(period: '2y', interval: '1d')
Yfinrb.ad(h)
# then
h.insert_at_idx(h.columns.length, Yfinrb.ad(h))
h['ad_results'] = Yfinrb.ad(h)
Most of the indicators are found here and here. Indicator parameters in Tulirb called, e.g., "period" or "short_period" are renamed as "window" or "short_window", respectively. There are a few other variants that are affected. Default values are shown below.
df = msft.history(period: '3y', interval: '1d') # for example
Yfinrb.ad(df)
Yfinrb.adosc(df, short_window: 2, long_window: 5)
Yfinrb.adx(df, column: 'Adj Close', window: 5)
Yfinrb.adxr(df, column: 'Adj Close', window: 5)
Yfinrb.avg_daily_trading_volume(df, window: 20)
Yfinrb.ao(df)
Yfinrb.apo(df, column: 'Adj Close', short_window: 12, long_window: 29)
Yfinrb.aroon(df, window: 20)
Yfinrb.aroonosc(df, window: 20)
Yfinrb.avg_price(df)
Yfinrb.atr(df, window: 20)
Yfinrb.bbands(df, column: 'Adj Close', window: 20, stddev: 1 )
Yfinrb.bop(df)
Yfinrb.cci(df, window: 20)
Yfinrb.cmo(df, column: 'Adj Close', window: 20)
Yfinrb.cvi(df, window: 20)
Yfinrb.dema(df, column: 'Adj Close', window: 20)
Yfinrb.di(df, window: 20)
Yfinrb.dm(df, window: 20)
Yfinrb.dpo(df, column: 'Adj Close', window: 20)
Yfinrb.dx(df, window: 20)
Yfinrb.ema(df, column: 'Adj Close', window: 5)
Yfinrb.emv(df)
Yfinrb.fisher(df, window: 20)
Yfinrb.fosc(df, window: 20)
Yfinrb.hma(df, column: 'Adj Close', window: 5)
Yfinrb.kama(df, column: 'Adj Close', window: 5)
Yfinrb.kvo(df, short_window: 5, long_window: 20)
Yfinrb.linreg(df, column: 'Adj Close', window: 20)
Yfinrb.linregintercept(df, column: 'Adj Close', window: 20)
Yfinrb.linregslope(df, column: 'Adj Close', window: 20)
Yfinrb.macd(df, column: 'Adj Close', short_window: 12, long_window: 26, signal_window: 9)
Yfinrb.marketfi(df)
Yfinrb.mass(df, window: 20)
Yfinrb.max(df, column: 'Adj Close', window: 20)
Yfinrb.md(df, column: 'Adj Close', window: 20)
Yfinrb.median_price(df)
Yfinrb.mfi(df, window: 20)
Yfinrb.min(df, column: 'Adj Close', window: 20)
Yfinrb.mom(df, column: 'Adj Close', window: 5)
Yfinrb.moving_avgs(df, window: 20)
Yfinrb.natr(df, window: 20)
Yfinrb.nvi(df)
Yfinrb.obv(df)
Yfinrb.ppo(df, column: 'Adj Close', short_window: 12, long_window: 26)
Yfinrb.psar(df, acceleration_factor_step: 0.2, acceleration_factor_maximum: 2)
Yfinrb.pvi(df)
Yfinrb.qstick(df, window: 20)
Yfinrb.roc(df, column: 'Adj Close', window: 20)
Yfinrb.rocr(df, column: 'Adj Close', window: 20)
Yfinrb.rsi(df, window: 20)
Yfinrb.sma(df, column: 'Adj Close', window: 20)
Yfinrb.stddev(df, column: 'Adj Close', window: 20)
Yfinrb.stderr(df, column: 'Adj Close', window: 20)
Yfinrb.stochrsi(df, column: 'Adj Close', window: 20)
Yfinrb.sum(df, column: 'Adj Close', window: 20)
Yfinrb.tema(df, column: 'Adj Close', window: 20)
Yfinrb.tr(df, column: 'Adj Close')
Yfinrb.trima(df, column: 'Adj Close', window: 20)
Yfinrb.trix(df, column: 'Adj Close', window: 20)
Yfinrb.trima(df, column: 'Adj Close', window: 20)
Yfinrb.tsf(df, column: 'Adj Close', window: 20)
Yfinrb.typical_price(df)
Yfinrb.ultosc(df, short_window: 5, medium_window: 12, long_window: 26)
Yfinrb.weighted_close_price(df)
Yfinrb.var(df, column: 'Adj Close', window: 20)
Yfinrb.vhf(df, column: 'Adj Close', window: 20)
Yfinrb.vidya(df, column: 'Adj Close', short_window: 5, long_window: 20, alpha: 0.2)
Yfinrb.volatility(df, column: 'Adj Close', window: 20)
Yfinrb.vosc(df, column: 'Adj Close', short_window: 5, long_window: 20)
Yfinrb.vol_weighted_moving_avg(df, window: 20)
Yfinrb.wad(df)
Yfinrb.wcprice(df)
Yfinrb.wilders(df, column: 'Adj Close', window: 20)
Yfinrb.willr(df, window: 20)
Yfinrb.wma(df, column: 'Adj Close', window: 5)
Yfinrb.zlema(df, column: 'Adj Close', window: 5)
To graph any of the series using Vega, per the information here, you will need to run
yarn add vega-cli vega-lite
Then, from within irb, you can generate charts, e.g.,
> msft = Yfinrb::Ticker.new("MSFT")
# =>
# #<Yfinrb::Ticker:0x000000011e6d50a0
# ...
> df = msft.history(period: '3y', interval: '1d')
# =>
# shape: (754, 10)
# ...
> df.insert_at_idx(df.columns.length, Yfinrb.ema(df, column: 'Adj Close', window: 5))
# =>
# shape: (753, 11)
# ┌────────────┬────────────┬────────────┬────────────┬───┬───────────┬───────────────┬──────────────┬──────────────────────┐
# │ Timestamps ┆ Open ┆ High ┆ Low ┆ … ┆ Dividends ┆ Capital Gains ┆ Stock Splits ┆ EMA(5) for Adj Close │
# │ --- ┆ --- ┆ --- ┆ --- ┆ ┆ --- ┆ --- ┆ --- ┆ --- │
# │ date ┆ f64 ┆ f64 ┆ f64 ┆ ┆ f64 ┆ f64 ┆ f64 ┆ f64 │
# ╞════════════╪════════════╪════════════╪════════════╪═══╪═══════════╪═══════════════╪══════════════╪══════════════════════╡
# │ 2021-07-12 ┆ 279.160004 ┆ 279.769989 ┆ 276.579987 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 270.325745 │
# │ 2021-07-13 ┆ 277.519989 ┆ 282.850006 ┆ 277.390015 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 271.514984 │
# │ 2021-07-14 ┆ 282.350006 ┆ 283.660004 ┆ 280.549988 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 272.804932 │
# │ 2021-07-15 ┆ 282.0 ┆ 282.51001 ┆ 279.829987 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 273.184001 │
# │ 2021-07-16 ┆ 282.070007 ┆ 284.100006 ┆ 279.459991 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 273.345751 │
# │ … ┆ … ┆ … ┆ … ┆ … ┆ … ┆ … ┆ … ┆ … │
# │ 2024-07-02 ┆ 453.200012 ┆ 459.589996 ┆ 453.109985 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 454.288375 │
# │ 2024-07-03 ┆ 458.190002 ┆ 461.019989 ┆ 457.880005 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 456.448913 │
# │ 2024-07-05 ┆ 459.609985 ┆ 468.350006 ┆ 458.970001 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 460.152608 │
# │ 2024-07-08 ┆ 466.549988 ┆ 467.700012 ┆ 464.459991 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 462.181735 │
# │ 2024-07-09 ┆ 467.0 ┆ 467.329987 ┆ 458.0 ┆ … ┆ 0.0 ┆ 0.0 ┆ 0.0 ┆ 461.30116 │
# └────────────┴────────────┴────────────┴────────────┴───┴───────────┴───────────────┴──────────────┴──────────────────────┘
> File.binwrite('/tmp/chart.png',df.plot("Timestamps", "EMA(5) for Adj Close", type: "line", width:800, height:500).to_png)
# => 44913
Then the following image should be saved at the specified location.
PNG, SVG, and PDF output formats are supported directly. See this page for more information in constructing supported charts.
While it has not been tested yet, images should be able to be produced interactively using iruby operating in a Jupyter environment.
Add this line to your application's Gemfile:
gem 'yfinrb'
And then execute:
$ bundle install
Or install it yourself as:
$ gem install yfinrb
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/bmck/yfinrb.
The yfinrb gem is available as open source under the MIT Software License (https://opensource.org/licenses/MIT). See the LICENSE.txt file in the release for details.
AGAIN - yfinrb is not affiliated, endorsed, or vetted by Yahoo, Inc. It's an open-source tool that uses Yahoo's publicly available APIs, and is intended for research and educational purposes. You should refer to Yahoo!'s terms of use (here, here, and here) for details on your rights to use the actual data downloaded.
FAQs
Unknown package
We found that yfinrb demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers uncover how threat actors weaponize Out-of-Band Application Security Testing (OAST) techniques across the npm, PyPI, and RubyGems ecosystems to exfiltrate sensitive data.
Security News
Research
A malicious npm campaign is targeting Ethereum developers by impersonating Hardhat plugins and the Nomic Foundation, stealing sensitive data like private keys.
Research
Security News
Socket researchers uncover a malicious npm package posing as a tool for detecting vulnerabilities in Etherium smart contracts.