Testing version
Project description
OwlData 數據貓頭鷹 API
數據貓頭鷹官方網站: https://owl.cmoney.com.tw/Owl/
Outline
Dependencies
- pandas
- requests
Install
安裝資源可以詳見 Github at https://github.com/owldb168/owldata
By PyPI
pip install owldata
Install source from GitHub
git clone https://github.com/owldb168/owldata.git
cd owldata
python setup.py install
HTTP Authentication
介接端須先透過取得的應用程式編號與應用程式密鑰取得一次性的有效交易驗證碼,於每次API呼叫時帶入 HTTP HEADER 提供驗證才能使用相關API。此驗證碼於特定時間後會 timeout過期,此時必須重新取得交易驗證碼得以再次操作相關API。
Flow Control
Code Example
使用 OwlData 模組輸入 AppID 與應用程式密鑰進行登入,並呼叫欲查詢資料表
import owldata
# 輸入數據貓頭鷹會員 AppID & 應用程式密鑰
appid = '請輸入 AppID'
appsecret = '請輸入 應用程式密鑰'
# 引用函數取得資料
owlapp = owldata.OwlData(appid, appsecret)
Quick Start
快速拿取個股歷史資料
import owldata
# 輸入數據貓頭鷹會員 AppID & 應用程式密鑰
appid = '請輸入 AppID'
appsecret = '請輸入 應用程式密鑰'
# 引用函數取得資料
owlapp = owldata.OwlData(appid, appsecret)
# 擷取台積電股價 from 2019/08/12 to 2019/08/13
stock_price = owlapp.ssp("2330", "20190812", "20190813")
stock_price.head()
Data Function
OwlData 使用方法,使用 OwlData 不同方法擷取所需要的資料,並可以利用參數 colist 進行欄位篩選
-
個股日收盤行情 (Single Stock Price, SSP)
依指定日期區間,撈取指定股票代號的股價資訊OwlData.ssp(sid:str, bpd:str, epd:str, colist:list) -> DataFrame
Parameters - sid : string
股票代號- bpd : string
設定查詢起始日期 8 碼數字,格式: yyyymmdd- epd : string
設定查詢結束日期 8 碼數字,格式: yyyymmdd- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 日期 股票名稱 開盤價 最高價 最低價 收盤價 成交量 付費版 日期 股票名稱 開盤價 最高價 最低價 收盤價 成交量 漲跌 漲幅(%) 振幅(%) 成交筆數 成交金額(千) 均張 均價 股本(百萬) 總市值(億) 本益比 股價淨值比 本益比(近四季) - 範例
# 擷取台積電股價 from 2019/08/12 to 2019/08/13 >>> colist = ['日期', '股票名稱', '開盤價', '最高價', '最低價' , '收盤價','成交量'] >>> owlapp.ssp("2330", "20190812", "20190813", colist) [out] 日期 股票名稱 開盤價 最高價 最低價 收盤價 成交量 0 2019-08-12 台積電 254.50 254.50 251.00 251.00 24732 1 2019-08-13 台積電 249.00 249.50 246.50 246.50 25045
-
多股每日收盤行情 (Multi-Stock Price, MSP)
依指定日期,撈取全上市櫃台股的股價資訊OwlData.msp(dt:str, colist:list) -> DataFrame
Parameters - dt : string
查詢某一日期- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 股票代號 股票名稱 日期 開盤價 最高價 最低價 收盤價 成交量 付費版 股票代號 股票名稱 日期 開盤價 最高價 最低價 收盤價 成交量 漲跌 漲幅(%) 振幅(%) 成交筆數 成交金額(千) 均張 均價 股本(百萬) 總市值(億) 本益比 股價淨值比 本益比(近四季) - 範例
# 擷取台股上市上櫃 2019/08/01 所有盤後資訊 >>>colist = ['股票代號','股票名稱','日期','開盤價','最高價','最低價','收盤價','成交量'] >>> owlapp.msp("20190801",colist) [out] 股票代號 股票名稱 日期 開盤價 最高價 最低價 收盤價 成交量 0 1101 台泥 2019-08-01 44.50 44.55 44.00 44.05 33643 1 1102 亞泥 2019-08-01 41.45 41.70 41.20 41.40 8384
-
個股財務簡表 (Financial Statements Single, FIS)
依據 di 決定查詢資料頻率,並依股票代號,撈取指定區間的財務報表資訊
y(年)、 q(季) 是撈取財務報表資訊;m(月) 是撈取營收相關資訊OwlData.fis(sid:str, di:str, bpd:str, epd:str, colist:list) -> DataFrame
Parameters - sid : string
股票代號- di : string
設定資料時間頻率- Y : 年度, 格式 : yyyy
- Q : 季度, 格式 : yyyyqq
- M : 月份, 格式 : yyyymm
- bpd : string
設定查詢起始日期- epd : string
設定查詢結束日期- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 季度日期格式 yyyqq, 其中 qq 請輸入 01 - 04, 分別表示為第一季至第四季
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空
- 參數 di 大小寫無異- 欄位
免費版 年與季財報欄位 年度 年季 流動資產(千) 非流動資產(千) 資產總計(千) 流動負債(千) 非流動負債(千) 負債總計(千) 權益總計(千) 營業收入淨額(千) 營業成本(千) 營業毛利(千) 營業費用(千) 營業利益(千) 月營收欄位 年月 單月合併營收(千) 單月合併營收年成長(%) 累計合併營收(千) 付費版 年與季財報欄位 年度 年季 流動資產(千) 現金及約當現金(千) 短期投資合計(千) 應收帳款淨額(千) 存貨(千) 非流動資產(千) 不動產、廠房及設備(千) 無形資產(千) 資產總計(千) 流動負債(千) 短期借款(千) 應付票據(千) 應付帳款(千) 非流動負債(千) 應付公司債(千) 負債總計(千) 普通股股本(千) 特別股股本(千) 公告每股淨值(元) 保留盈餘(千) 資本公積(千) 庫藏股票(千) 母公司業主權益(千) 權益總計(千) 營業收入淨額(千) 營業成本(千) 營業毛利(千) 營業費用(千) 營業利益(千) 營業外收入及支出(千) 稅前純益(千) 所得稅(千) 繼續營業單位損益(千) 稅後純益(千) 公告基本每股盈餘(元) 營業活動現金流量(千) 投資活動現金流量(千) 籌資活動現金流量(千) 自由現金流量(千) 槓桿比率(%) 流動比率(%) 速動比率(%) 負債比率(%) 淨值成長率(%) 應付帳款週轉率(次) 應收帳款週轉率(次) 存貨週轉率(次) 固定資產週轉率(次) 總資產週轉率(次) 淨值週轉率(次) 毛利率(%) 營業費用率(%) 營業利益率(%) 稅前純益率(%) 稅後純益率(%) 稅前權益報酬率(%) 稅後權益報酬率(%) 稅前資產報酬率(%) 稅後資產報酬率(%) 利息保障倍數(倍) 營收成長率(%) 總資產成長率(%) 月營收欄位 年月 單月合併營收(千) 去年單月合併營收(千) 單月合併營收年成長(%) 單月合併營收月變動(%) 累計合併營收(千) 去年累計合併營收(千) 累計合併營收成長(%) 近三月合併營收(千) 近三月合併營收年成長(%) 近三月合併營收月變動(%) 近12月合併營收(千) 近12月合併營收成長(%) - 範例
# 擷取台積電財務簡表 from 2016 to 2017 >>> colist = ['年度', '流動資產(千)', '非流動資產(千)', '資產總計(千)', '流動負債(千)', '非流動負債(千)', '負債總計(千)'] >>> owlapp.fis('y', "2330", "2017", "2018", colist) [out] 年度 流動資產(千) 非流動資產(千) 資產總計(千) 流動負債(千) 非流動負債(千) 負債總計(千) 0 2017-12-31 92719914 179837135 272557049 65192960 54716873 119909833 1 2018-12-31 110380695 233704423 344085118 64503844 82201818 146705662
-
多股財務簡表 (Financial Statements Multi, FIM)
依據 di 決定查詢資料頻率,並依指定區間,撈取全上市櫃台股的財務報表資訊
y(年)、 q(季) 是撈取財務報表資訊;m(月) 是撈取營收相關資訊OwlData.fim(di:str, dt:str, colist:list) -> DataFrame
Parameters - di : string
設定資料時間頻率- Y : 年度, 格式 : yyyy
- Q : 季度, 格式 : yyyyqq
- M : 月份, 格式 : yyyymm
- dt : string
查詢某一日期- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 季度日期格式 yyyqq, 其中 qq 請輸入 01 - 04, 分別表示為第一季至第四季
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空
- 參數 di 大小寫無異- 欄位
免費 年與季財報欄位 股票代號 股票名稱 年度 年季 流動資產(千) 非流動資產(千) 資產總計(千) 流動負債(千) 非流動負債(千) 負債總計(千) 權益總計(千) 營業收入淨額(千) 營業成本(千) 營業毛利(千) 營業費用(千) 營業利益(千) 月營收欄位 股票代號 股票名稱 年月 單月合併營收(千) 單月合併營收年成長(%) 累計合併營收(千) 付費版 年與季財報欄位 股票代號 股票名稱 年度 年季 存貨(千) 非流動資產(千) 不動產、廠房及設備(千) 無形資產(千) 資產總計(千) 流動負債(千) 短期借款(千) 應付票據(千) 應付帳款(千) 非流動負債(千) 應付公司債(千) 負債總計(千) 普通股股本(千) 特別股股本(千) 公告每股淨值(元) 保留盈餘(千) 資本公積(千) 庫藏股票(千) 母公司業主權益(千) 權益總計(千) 營業收入淨額(千) 營業成本(千) 營業毛利(千) 營業費用(千) 營業利益(千) 營業外收入及支出(千) 稅前純益(千) 所得稅(千) 繼續營業單位損益(千) 稅後純益(千) 公告基本每股盈餘(元) 營業活動現金流量(千) 投資活動現金流量(千) 籌資活動現金流量(千) 自由現金流量(千) 槓桿比率(%) 流動比率(%) 速動比率(%) 負債比率(%) 淨值成長率(%) 應付帳款週轉率(次) 應收帳款週轉率(次) 存貨週轉率(次) 固定資產週轉率(次) 總資產週轉率(次) 淨值週轉率(次) 毛利率(%) 營業費用率(%) 營業利益率(%) 稅前純益率(%) 稅後純益率(%) 稅前權益報酬率(%) 稅後權益報酬率(%) 稅前資產報酬率(%) 稅後資產報酬率(%) 利息保障倍數(倍) 營收成長率(%) 總資產成長率(%) 月營收欄位 股票代號 股票名稱 年月 單月合併營收(千) 去年單月合併營收(千) 單月合併營收年成長(%) 單月合併營收月變動(%) 累計合併營收(千) 去年累計合併營收(千) 累計合併營收成長(%) 近三月合併營收(千) 近三月合併營收年成長(%) 近三月合併營收月變動(%) 近12月合併營收(千) 近12月合併營收成長(%) -
範例
# 台股上市上櫃財務簡表 from 2018 >>> colist = ["股票代號","股票名稱","年度","流動資產(千)","非流動資產(千)","資產總計(千)","流動負債(千)"] >>> owlapp.fim('Y',"2018",colist) [out] 股票代號 股票名稱 年度 流動資產(千) 非流動資產(千) 資產總計(千) 流動負債(千) 0 1101 台泥 2018-12-31 110380695 233704423 344085118 64503844 1 1102 亞泥 2018-12-31 80358506 198829492 279187998 62804294
-
法人籌碼個股資料 (Corporate Chip Single, CHS)
依指定日期區間,撈取指定股票的三大法人買賣狀況和該股票的融資券狀況OwlData.chs(sid:str, bpd:str, epd:str, colist:list) -> DataFrame
Parameters - sid : string
股票代號- bpd : string
設定查詢起始日期 8 碼數字,格式: yyyymmdd- epd : string
設定查詢結束日期 8 碼數字,格式: yyyymmdd- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 日期 買賣超合計 外資買賣超 投信買賣超 自營買賣超 付費版 日期 買賣超合計 法人買賣超金額(千) 法人持股比率(%) 外資買賣超 外資買賣超金額(千) 外資持股比率(%) 投信買賣超 投信買賣超金額(千) 投信庫存 投信持股比率(%) 自營買賣超 自營買賣超金額(千) 自營商買賣超(自行買賣) 自營商買賣超(避險) 自營商庫存 自營商持股比率(%) 資餘 資增減 券餘 - 範例
# 擷取台積電法人籌碼資料 from 2019/08/01 to 2019/08/02 >>> colist = ['日期','買賣超合計','外資買賣超','投信買賣超','自營商買賣超'] >>> owlapp.chs("2330", "20190801", "20190802",colist) [out] 日期 買賣超合計 外資買賣超 投信買賣超 自營商買賣超 0 2019-08-01 -9058 -10675 196 1421 1 2019-08-02 -8712 -9356 -235 879
-
法人籌碼多股資料 (Corporate Chip Multi, CHM)
查詢指定日期,全上市櫃台股的三大法人買賣狀況和融資券狀況OwlData.chm(dt:str,colist:list) -> DataFrame
Parameters - dt : string
查詢某一日期 8碼,格式: yyyymmdd- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 股票代號 股票名稱 日期 買賣超合計 外資買賣超 投信買賣超 自營買賣超 付費版 股票代號 股票名稱 日期 買賣超合計 法人買賣超金額(千) 法人持股比率(%) 外資買賣超 外資持股比率(%) 投信買賣超 投信買賣超金額(千) 投信庫存 投信持股比率(%) 自營買賣超 自營買賣超金額(千) 自營商買賣超(自行買賣) 自營商買賣超(避險) 自營商庫存 自營商持股比率(%) 資餘 資增減 券餘 券增減 券資比 資使用率 券使用率 當沖比率 - 範例
# 擷取台股上市上櫃 from 2019/08/01 所有法人籌碼資訊 >>> colist = ['股票代號','股票名稱','日期','買賣超合計','外資買賣超','投信買賣超','自營商買賣超'] >>> owlapp.chm("20190916",colist) [out] 股票代號 股票名稱 日期 買賣超合計 外資買賣超 投信買賣超 自營商買賣超 0 1101 台泥 2019-09-16 -3470 -2323 0 -1147 1 1102 亞泥 2019-09-16 2008 1712 50 246
-
技術指標 個股 (Technical Indicators Single, TIS)
依指定日期區間,撈取指定股票的技術指標數值OwlData.tis(sid:str, bpd:str, epd:str, colist:list) -> DataFrame
Parameters - sid : string
股票代號- bpd : string
查詢起始日期 8 碼數字,格式: yyyymmdd- epd : string
查詢結束日期 8 碼數字,格式: yyyymmdd- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 日期 K(9) D(9) RSI(5) RSI(10) DIF-MACD 付費版 日期 K(9) D(9) RSI(5) RSI(10) DIF MACD DIF-MACD W%R(5) W%R(10) +DI(14) -DI(14) ADX(14) Alpha(250D) Beta係數(21D) Beta係數(65D) Beta係數(250D) 年化波動度(21D) 年化波動度(250D) 乖離率(20日) 乖離率(60日) 乖離率(250日) EWMA波動率(%) +DM(14) -DM(14) - 範例
# 擷取台積電技術指標 from 2019/08/01 to 2019/08/02 >>> colist = ['日期', 'K(9)', 'D(9)', 'RSI(5)', 'RSI(10)',"DIF","MACD","DIF-MACD"] >>> owlapp.tis("2330", "20190801", "20190802", colist) [out] 日期 K(9) D(9) RSI(5) RSI(10) DIF MACD DIF-MACD 0 2019-08-01 39.80 60.45 30.51 51.65 5.12 5.73 -0.61 1 2019-08-02 28.62 49.84 17.88 40.98 4.21 5.43 -1.22
-
技術指標 多股 (Technical Indicators Multi, TIM)
查詢指定日期,全上市櫃台股的技術指標數值OwlData.tim(dt:str, colist:list) -> DataFrame
Parameters - dt : string
查詢某一日期 8碼,格式: yyyymmdd- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費 股票代號 股票名稱 日期 K(9) D(9) RSI(5) RSI(10) DIF MACD DIF-MACD 付費版 股票代號 股票名稱 日期 K(9) D(9) RSI(5) RSI(10) DIF MACD DIF-MACD W%R(5) W%R(10) +DI(14) -DI(14) ADX(14) Alpha(250D) Beta係數(21D) Beta係數(65D) Beta係數(250D) 年化波動度(21D) 年化波動度(250D) 乖離率(20日) 乖離率(60日) 乖離率(250日) EWMA波動率(%) +DM(14) -DM(14) - 範例
# 擷取台股上市上櫃 from 2019/08/01 所有技術指標資訊 >>> colist = ['股票代號', '股票名稱', '日期', 'K(9)', 'D(9)', 'RSI(5)', 'RSI(10)',"DIF","MACD","DIF-MACD"] >>> owlapp.tim("20190801", colist) [out] 股票代號 股票名稱 日期 K(9) D(9) RSI(5) RSI(10) DIF MACD DIF-MACD 0 1101 台泥 2019-08-02 27.82 42.49 18.10 29.52 -0.13 -0.01 -0.13 1 1102 亞泥 2019-08-02 9.00 11.74 11.85 25.02 -0.62 -0.31 -0.31
-
公司基本資料 多股 (Company Information Multi, CIM)
撈取上市櫃台股的公司基本資料OwlData.cim(colist:list) -> DataFrame
Parameters - colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 股票代號 股票名稱 中文簡稱 公司名稱 地址 電話 上市上櫃 成立日期 產業名稱 董事長 總經理 發言人 發言人職稱 經營項目 交易所公告股本(千) 付費版 股票代號 股票名稱 中文簡稱 公司名稱 地址 電話 上市上櫃 存續年度 成立日期 上市日期 上櫃日期 興櫃日期 公發日期 董事長 總經理 發言人 發言人職稱 產業代號 產業名稱 產業指數代號 產業指數名稱 股票過戶機構 經營項目 前年度內銷比重(%) 前年度外銷比重(%) 交易所普通股股本(千) 交易所特別股股本(千) 交易所普通股股數(千) 交易所特別股股數(千) 交易所公告股本(千) 實收資本額(百萬) 普通股每股面額 員工人數(人) - 範例
# 擷取台股上市上櫃 所有公司基本資訊 >>> colist = ['股票代號', '股票名稱', '中文簡稱', '董事長', '總經理'] >>> owlapp.cim(colist) [out] 股票代號 股票名稱 中文簡稱 董事長 總經理 0 1101 台泥 台泥 張安平 李鐘培 1 1102 亞泥 亞泥 徐旭東 李坤炎 2 1103 嘉泥 嘉泥 張剛綸 祁士鉅
-
股利政策 個股 (Dividend Policy Single, DPS)
依據指定年度區間,撈取指定股票的配發股利狀況表OwlData.dps(sid:str, bpd:str, epd:str, colist:list) -> DataFrame
Parameters - sid : string
股票代號- bpd : string
查詢起始年度 4 碼數字,格式: yyyy- epd : string
查詢結束年度 4 碼數字,格式: yyyy- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 年度 除息日 除權日 現金股利合計(元) 股票股利合計(元) 付費版 年度 除息日 除權日 現金股利合計(元) 股票股利合計(元) 股利合計(元) 盈餘配息(元) 公積配息(元) 盈餘配股(元) 公積配股(元) 領股日期 領息日期 現金股利殖利率(%) 股票股利發放率(%) 股利發放率(%) 董監改選年度 - 範例
# 擷取台積電股利政策資料 from 2017 to 2018 >>> colist = ['年度', '除息日', '除權日', '現金股利合計(元)','股票股利合計(元)'] >>> owlapp.dps("2330", "2017", "2018", colist) [out] 年度 除息日 除權日 現金股利合計(元) 股票股利合計(元) 0 2017-12-31 20180625 8 0 1 2018-12-31 20190624 8 0
-
股利政策 多股 (Dividend Policy Multi, DPM)
依指定年度,撈取全上市櫃台股的配發股利狀況表OwlData.dpm(dt:str, colist:list) -> DataFrame
Parameters - dt : string
查詢某一年度 4碼,格式: yyyy- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 股票代號 股票名稱 年度 除息日 除權日 現金股利合計(元) 股票股利合計(元) 付費版 股票代號 股票名稱 年度 除息日 除權日 現金股利合計(元) 股票股利合計(元) 股利合計(元) 盈餘配息(元) 公積配息(元) 盈餘配股(元) 公積配股(元) 領股日期 領息日期 現金股利殖利率(%) 股票股利發放率(%) 股利發放率(%) 董監改選年度 - 範例
# 擷取台股上市上櫃 from 2018 所有股利政策資訊 >>> colist = ['股票代號', '股票名稱', '年度', '除息日','除權日','現金股利合計(元)', '股票股利合計(元)'] >>> owlapp.dpm("2018", colist) [out] 股票代號 股票名稱 年度 除息日 除權日 現金股利合計(元) 股票股利合計(元) 0 1101 台泥 2018-12-31 20190813 20190813 3.31 0.70 1 1102 亞泥 2018-12-31 20190724 2.80 0.00 2 1103 嘉泥 2018-12-31 20190829 1.00 0.00
-
除權除息 個股 (Exemption Dividend Policy Single, EDPS)
依據指定年度區間,撈取指定股票的股東會日期及停止過戶的相關日期OwlData.edps(sid:str, bpd:str, epd:str, colist:list) -> DataFrame
Parameters - sid : string
股票代號- bpd : string
查詢起始年度 4 碼數字,格式: yyyy- epd : string
查詢結束年度 4 碼數字,格式: yyyy- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 年度 停止過戶起 停止過戶迄 最後過戶日 股東會日期 付費版 年度 停止過戶起 停止過戶迄 最後過戶日 股東會日期 停止融券起始日 融券回補日 停止融券終迄日 停止融資起始日 停止融資終迄日 # 擷取台積電除權除息資料 from 2017 to 2018 >>> colist = ['年度', '停止過戶起', '停止過戶迄', '最後過戶日','股東會日期'] >>> owlapp.edps("2330", "2017", "2018", colist) [out] 年度 停止過戶起 停止過戶迄 最後過戶日 股東會日期 0 2017-12-31 20170410 20170608 20170407 20170608 1 2018-12-31 20180407 20180605 20180403 20180605
-
除權除息 多股 (Exemption Dividend Policy Multi, EDPM)
依指定日期,撈取全上市櫃台股的股東會日期及停止過戶的相關日期OwlData.edpm(dt:str, colist:str) -> DataFrame
Parameters - dt : string
查詢某一年度 4 碼,格式: yyyy- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
免費版 股票代號 股票名稱 年度 停止過戶起 停止過戶迄 最後過戶日 股東會日期 付費版 股票代號 股票名稱 年度 停止過戶起 最後過戶日 停止過戶迄 股東會日期 停止融券起始日 融券回補日 停止融券終迄日 停止融資起始日 停止融資終迄日 - 範例
# 擷取台股上市上櫃 2018 所有除權除息資訊 >>> colist = ['股票代號', '股票名稱', '年度','停止過戶起','停止過戶迄', '最後過戶日','股東會日期'] >>> owlapp.edpm("2018", colist) [out] 股票代號 股票名稱 年度 停止過戶起 停止過戶迄 最後過戶日 股東會日期 0 1101 台泥 2018-12-31 20180424 20180622 20180423 20180622 1 1102 亞泥 2018-12-31 20180428 20180626 20180427 20180626 2 1103 嘉泥 2018-12-31 20180423 20180621 20180420 20180621
-
即時報價 (Timely Stock Price, TSP)
撈取指定股票即時股價資訊OwlData.tsp(sid:str, colist:str) -> DataFrame
Parameters - sid : string
股票代號- colist : list, default None
指定顯示欄位 (若不輸入則顯示所有欄位)Returns DataFrame or Series Note
- 發生錯誤時,會直接顯示錯誤訊息,回傳變數為空- 欄位
付費版 股票代號 股票名稱 時間 成交價 漲跌 漲跌幅 總量 開盤價 最高價 最低價 成交量 - 範例
# 擷取台積電即時報價 >>> colist = ['股票代號', '股票名稱', '時間', '開盤價', '最高價', '最低價', '成交量'] >>> owlapp.tsp("2330", colist) [out] 股票代號 股票名稱 時間 開盤價 最高價 最低價 成交量 0 2330 台積電 20190814143000 252.50 254.00 249.50 11.00
Notes
-
Python 免費版資料期間限制於2年,欄位詳見 GitHub或數據貓頭鷹官網
-
免費版試用期間為 90 日,過期則需要再等 2 日才能再次申請免費試用
-
Python 付費版資料期間為 10 年,欄位詳見 GitHub或數據貓頭鷹官網
-
若付費本出現無法擷取資料的情況,可能是因為商品清單或是交易週期對應表過期所導致,請向客服進行聯繫 (預設過期天數為999天,等待期限 1 日)
有任何相關錯誤請聯繫:
- E-mail:service@cmoney.com.tw
- 請撥打 02-8252-6620 分機241
- 星期一-星期五: 早上9:00-下午6:00, 除了國定假日以外
Contribute
owldata was created by OwlData co. owldb@cmoney.com.tw
Contributing were welcome, please use GitHub issue and Pull Request to contribute!
歡迎協作,請使用 GitHub issue 以及 Pull Request 功能來協作。
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.