使用 Tool API 獲取數據(股價、財務、月營收、集保和股票屬性)
安裝套件
pip install tej-tool-api
匯入套件
import os
os.environ['TEJAPI_KEY'] = "YOURAPIKEY"
import TejToolAPI
get_history_data - 獲取歷史資料
list_of_Stocks = ['2330','2303','2454', '2882', '2881']
# 撈取歷史資料
data = TejToolAPI.get_history_data(
ticker=list_of_Stocks,
columns= ['稅前淨利成長率', '單月營收成長率%'],
transfer_to_chinese=False
)
目前資料庫僅支援台灣市場。
Tool API 可獲取 PIT 資料庫的所有欄位,共計超過 600 個指標,具體指標內容參考TEJAPI_量化投資資料庫 。
財務數據是根據發布日(announcement date)來mapping,非發布日的財務數據會使用當下可獲得最新的資料為準進行填值。ex: 2330 在 2010-02-01 時所能獲得最新的財務資料為 2009Q3 的財務資料,則 2010-01-01 會以 2009Q3 的資料進行填補。惟公司2009Q4自結財報早於 2010-02-01 發布時,且 include_self_acc = 'Y',這時 2010-02-01 的財務數據使用自結財務數據。
參數:
| Parameters | Is Required | Data Type | Descriptions |
|---|---|---|---|
| ticker | Required | list | 股票代碼,ex: ['2330', '2881', '2882'] |
| columns | Required | list | 欄位代碼,可參考TEJAPI_量化投資資料庫 |
| start | Optional | date/str | 起始日,ex: '2008-01-01' (預設值為 '2013-01-01'),目前版本尚未支援timezone的設定 |
| end | Optional | date/str | 結束日,ex: '2008-01-01' (預設值為今日 datetime.now()),目前版本尚未支援timezone的設定 |
| transfer_to_chinese | Optional | boolean | 欄位轉換成中文,若 transfer_to_chinese=True,則欄位顯示為中文名稱,transfer_to_chinese=False,則欄位顯示為英文名稱。(預設為 False) |
| fin_type | Optional | list | 會計科目類型 -> 單季:Q、累計:A、移動四季:TTM,ex: 撈取單季和累積,fin_type=['Q','A']。(預設為 ['Q','A','TTM']) |
| include_self_acc | Optional | string | 財務是否包含公司自結損益,include_self_acc='Y',表示財務資料包含自結損益,否則僅有財簽資料 (預設為 'N') |
| npartitions | Optional | int | 代表取得資料時已n家公司為一組單位,ex: 取得100家資料時設定 npartitions = 50 ,則會分成 ceil(100/50) = 2 次 分別抓取後再合併 |
get_internal_code
內部欄位編碼與中英文簡稱轉換功能
TejToolAPI.get_internal_code(['稅前淨利成長率', 'Gross_Profit_Loss_from_Operations'])
output: ['r404', 'gm']
參數:
| Parameters | Is Required | Data Type | Descriptions |
|---|---|---|---|
| columns | Required | list | 欄位代碼,可參考TEJAPI_量化投資資料庫 |
search_columns
若想從內部編碼反向取得 columns 所對應之中英文欄位則可利用 search_columns 這個function
TejToolAPI.search_columns(['r404'])
| columns | chn_column_names | eng_column_names | table_names | TABLE_NAMES | API_TABLE | CHN_NAMES |
|---|---|---|---|---|---|---|
| r404 | 稅前淨利成長率 | Pre_Tax_Income_Growth_Rate | fin_self_acc | fin_self_acc | TWN/AFESTM1 | 財務-自結數 |
| r404 | 稅前淨利成長率 | Pre_Tax_Income_Growth_Rate | fin_board_select | fin_board_select | TWN/AFESTMD | 財務-董事決議數 |
參數:
| Parameters | Is Required | Data Type | Descriptions |
|---|---|---|---|
| columns | Required | list | 欄位代碼,可參考TEJAPI_量化投資資料庫 |
search_table
TejToolAPI.search_table(['r404'])
| COLUMNS | TABLE_NAMES |
|---|---|
| r404 | fin_self_acc |
| r404 | fin_auditor |
參數:
| Parameters | Is Required | Data Type | Descriptions |
|---|---|---|---|
| columns | Required | list | 欄位代碼,可參考TEJAPI_量化投資資料庫 |
Metadata
Release files for tej-tool-api 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tej_tool_api-1.3.0.tar.gz | 89.2 kB | Without provenance | Details for tej_tool_api-1.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tej_tool_api-1.3.0-py3-none-any.whl | Python 3 | none | any | Details for tej_tool_api-1.3.0-py3-none-any.whl |
Total release size: 179.6 kB
Release files / tej_tool_api-1.3.0.tar.gz
| Download URL | tej_tool_api-1.3.0.tar.gz |
|---|---|
| Size | 89.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2f4038820f30caca7ff05f155bd10077abf7991077f7405a353422dce65d2067
|
|
BLAKE2b-256 checksum How to use checksums |
7e0b534cabcbd45bc8d203ba369a6d6e8ae43ea1e50f2453461abfbea41f030c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / tej_tool_api-1.3.0-py3-none-any.whl
| Download URL | tej_tool_api-1.3.0-py3-none-any.whl |
|---|---|
| Size | 90.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75d8e2d85494d4f176175a23de9fb3de60447ca1a7c9f4cdc381c71316ee2784
|
|
BLAKE2b-256 checksum How to use checksums |
11d89fda42f0b81367199e4fd0a5206b65dc11fbeb2c0707c4fa7dfce0f002be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Security for tej-tool-api 1.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.