0.0
No commit activity in last 3 years
No release in over 3 years
HiStock (https://histock.tw/) filter
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0
~> 13.0
~> 3.0
>= 1.9.0

Runtime

 Project Readme

Gem Version Build Status Coverage Status

Histock::Filter

histock-filter is Ruby library to get the finance data of listed stock on the Taiwan stock exchange market from HiStock嗨投資理財社群.

If you would like to get more basic data (row data), refer to histock-simplefilter.

Installation

Add this line to your application's Gemfile:

gem 'histock-filter'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install histock-filter

Usage

Dividend Policy

require 'histock/filter'

histock = Histock::Filter.new
histock.dividend_policy('2330')
# [
#   {
#     "所屬年度" => "2019",
#     "發放年度" => "2020",
#     "除權日" => "",
#     "除息日" => "06/18",
#     "除權息前股價" => 297.5,
#     "股票股利" => 0,
#     "現金股利" => 2.5,
#     "EPS" => 13.32,
#     "配息率" => 18.77,
#     "現金殖利率" => 0.84,
#     "扣抵稅率" => 0.00,
#     "增資配股率" => 0,
#     "增資認購價" => 0
#   },
#   {},
#   :
# ]

Basic Financial Statements

Monthly Revenue

key type
年度/月份 string
單月營收 integer
去年同月營收 integer
單月月增率 float
單月年增率 float
累計營收 integer
去年累計營收 integer
累積年增率 float
require 'histock/filter'

histock = Histock::Filter.new
histock.monthly_revenue('2330')
# [
#   {
#     "年度/月份" => "2020/04",
#     "單月營收" => 96001568,
#     "去年同月營收" => 74693616,
#     "單月月增率" => -15.4,
#     "單月年增率" => 28.5,
#     "累計營收" => 406598784,
#     "去年累計營收" => 293398112,
#     "累積年增率" => 38.6
#   },
#   {},
#   :
# ]

Income Statement

key type
年度/季別 string
營收 integer
毛利 integer
營業利益 integer
稅前淨利 integer
稅後淨利 integer
histock = Histock::Filter.new
histock.income_statement('2330')
# [
#   {
#     "年度/季別"" => "2019Q4",
#     "營收" => 317237065,
#     "毛利" => 159240985,
#     "營業利益" => 124243722,
#     "稅前淨利" => 128781973,
#     "稅後淨利" => 116078194
#   },
#   {},
#   :
# ]

Profitability

Profit Ratio

key type
年度/季別 string
毛利率 float
營業利益率 float
稅前淨利率 float
稅後淨利率 float
histock = Histock::Filter.new
histock.profit_ratio('2330')
# [
#   {
#     "年度/季別" => "2019Q4",
#     "毛利率" => 50.20,
#     "營業利益率" => 39.16,
#     "稅前淨利率" => 40.59,
#     "稅後淨利率" => 36.59
#   },
#   {},
#   :
# ]

Income Rate

Monthly Data
key type
年度/季別 string
ROE float
ROA float
histock = Histock::Filter.new
histock.income_rate('2330', 'month')
# [
#   {
#     "年度/季別" => "2020Q1",
#     "ROE" => 7.10,
#     "ROA" => 5.08
#   },
#   {},
#   :
# ]
Quarterly Data
key type
年度/季別 string
近四季ROE float
近四季ROA float
histock = Histock::Filter.new
histock.income_rate('2330', 'quarter')
# [
#   {
#     "年度/季別" => "2020Q1",
#     "近四季ROE" => 23.45,
#     "近四季ROA" => 17.70
#   },
#   {},
#   :
# ]
Yearly Data
key type
年度 string
年度ROE float
年度ROA float
histock = Histock::Filter.new
histock.income_rate('2330', 'year')
# [
#   {
#     "年度" => "2019",
#     "年度ROE" => 20.93,
#     "年度ROA" => 15.86
#   },
#   {},
#   :
# ]

Corporate Value

PER

key type
年度/月份 string
本益比 float
histock = Histock::Filter.new
histock.price_to_earning_ratio('2330')
# [
#   {
#     "年度/月份" => "2020/06",
#     "本益比" => 20.44
#   },
#   {},
#   :
# ]

PBR

key type
年度/月份 string
股價淨值比 float
histock = Histock::Filter.new
histock.price_book_ratio('2330')
# [
#   {
#     "年度/月份" => "2020/06",
#     "股價淨值比" => 4.89
#   },
#   {},
#   :
# ]