Skip to content

v1.2.0
Compare
Choose a tag to compare
@Han860207 Han860207 released this 30 Oct 00:43
· 7 commits to main since this release
1.2.0
80aedd0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.

tej-tool-api

新增dependency : dask-expr

Future warning : 未來可能僅支援 pandas 2 版以上，將不針對 pandas 1 版進行相容性測試

bug修復 (目前已測試到pandas 2.2.2 , dask 2024.9.1 , dask-expr 1.1.15)

  1. 修復較新版dask與pandas使用時可能會遇到string變成PyArrow導致資料型態不匹配的問題

  2. 修復較新版dask與pandas使用時可能會遇到mdate資料型態不匹配的問題

功能新增

1. 顯示所有可以使用的欄位，參數為chinese , if True 使用中文 , false回傳英文欄位名稱

import TejToolAPI
TejToolAPI.show_columns(chinese = True)

2. 新增get_history_data 的參數說明，

ticker : list , 公司碼

columns : list , 欄位

fin_type : list , 累計,單季,移動四季(A,Q,TTM) (optional)

include_self_acc : ["Y","N"] , 是否包含公司自結 (optional)

start : str , 資料起始日 (YYYY-MM-DD) (optional)

end : str , 資料結束日 (YYYY-MM-DD) (optional)

npartitions : int , 每組資料數量 (optional)

require_annd : bool , 是否需要公告日欄位 (optional)

transfer_to_chinese : bool , 欄位是否轉換為中文 (optional)

show_progress : bool , 顯示流量狀況 (optional)

或在Jupyter Notebook中使用

TejToolAPI.get_history_data?

異動

1. 更新月營收邏輯，將採用當下最新的月營收，若有重新公告的月營收將以公告時日進行更新；同時，重新公告過時的月營收將不會覆蓋。

# 範例
import tejapi
tejapi.ApiConfig.api_base = 'https://api.tej.com.tw'
tejapi.ApiConfig.api_key = '<your_key>'
#  d0001 為月營收_千元
df = tejapi.fastget('TWN/APISALE1' , coid = ['6186'] , mdate  = {'gte': '20230101' , 'lte': '20230501'} , opts = { 'columns' : ['coid' , 'mdate' , 'key3' , 'annd_s' , 'd0001']  })
df = df.rename({'d0001':'月營收' , 'annd_s' : '公告日'}, axis=1)
# df 輸出
coid mdate      key3 公告日      月營收
6186 2023-01-01 1.0  2023-02-10 139310.0
6186 2023-02-01 1.0  2023-03-09 9789.0
6186 2023-03-01 1.0  2023-04-10 859024.0
6186 2023-03-01 2.0  2023-04-17 162844.0
6186 2023-04-01 1.0  2023-05-10 1022.0
6186 2023-05-01 1.0  2023-06-06 52945.0
# TejToolAPI比較(程式碼相同)
import os
os.environ['TEJAPI_KEY'] = '<your_key>'
import TejToolAPI
df = TejToolAPI.get_history_data(ticker=['6186'] , columns=['單月營收_千元'] , start = '20230406' , end = '20230420')

# 左邊為舊版的輸出結果 , 右邊為新板的輸出結果
coid mdate      月營收(舊版) 月營收(新版)
6186 2023-04-06 9789        9789
6186 2023-04-07 9789        9789
6186 2023-04-10 162844      859024
6186 2023-04-11 162844      859024
6186 2023-04-12 162844      859024
6186 2023-04-13 162844      859024
6186 2023-04-14 162844      859024
6186 2023-04-17 162844      162844
6186 2023-04-18 162844      162844
6186 2023-04-19 162844      162844
6186 2023-04-20 162844      162844

2. 新增預設網域，未來在 import TejToolAPI 之前，僅需設定 TEJAPI_KEY 即可，預設網域為 https://api.tej.com.tw。

欄位新增

新增
中文名稱 英文名稱 備註
Q1_除息融券最後回補日 Q1_Ex-Dividends_Final_Short-covering_Date
Q2_除息融券最後回補日 Q2_Ex-Dividends_Final_Short-covering_Date
Q3_除息融券最後回補日 Q3_Ex-Dividends_Final_Short-covering_Date
Q4_除息融券最後回補日 Q4_Ex-Dividends_Final_Short-covering_Date
月營收備註說明 Revenue_Remark
暫停當沖先買後賣註記 Suspension_of_Sell_After_Day_Trading_Fg
Assets 2
Loading