{ "cells": [ { "cell_type": "markdown", "id": "7be70890", "metadata": {}, "source": [ "# TejToolAPI\n", "\n", "幫助使用者快速取得且整理 TEJ 資料庫所提供的資訊。" ] }, { "cell_type": "code", "execution_count": 2, "id": "b7ff5d0c", "metadata": {}, "outputs": [], "source": [ "import os \n", "os.environ['TEJAPI_BASE'] = \"https://api.tej.com.tw\"\n", "os.environ['TEJAPI_KEY'] = \"your key\"\n", "import TejToolAPI\n", "import pandas as pd \n", "import numpy as np" ] }, { "cell_type": "markdown", "id": "edcfe6a1", "metadata": {}, "source": [ "\n", "### TejToolAPI.get_history_data\n", "\n", "取的證券相關或交易相關等歷史資料。\n", "\n", "#### Paramters:\n", "* ticker: _iterable[str]_\n", " 欲查詢的資料的證券代碼。\n", "* columns: _iterable[str]_\n", " \n", " 欲查詢資料的欄位名稱,欄位名稱請見 https://api.tej.com.tw/。\n", "* transfer_to_chinese: _boolean_\n", " 是否將欄位轉換為英文。\n", "* start: _pd.Timestamp_ or _str_\n", " 資料起始時間。\n", "* end: _pd.Timestamp_ or _str_\n", " 資料結束時間。\n", "* fin_type = _iterable[str]_\n", " 決定資料型態。\n", " A: 累績資料\n", " F: 單季資料\n", " TTM: 移動四季資料\n", "* include_self_acc: _str_\n", " 投資用財務包含自結和董事會決議數(include_self_acc = 'Y')\n", " 僅投資用財務(include_self_acc = 'N')\n", " \n", "#### Returns:\n", "\n", "pd.DataFrame" ] }, { "cell_type": "code", "execution_count": 5, "id": "4ce03529", "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", " | 股票代碼 | \n", "日期 | \n", "母公司每股盈餘_A | \n", "母公司每股盈餘_Q | \n", "母公司每股盈餘_TTM | \n", "
---|---|---|---|---|---|
0 | \n", "2330 | \n", "2021-08-13 | \n", "NaN | \n", "NaN | \n", "NaN | \n", "
1 | \n", "2330 | \n", "2021-08-16 | \n", "NaN | \n", "NaN | \n", "NaN | \n", "
2 | \n", "2330 | \n", "2021-08-17 | \n", "NaN | \n", "NaN | \n", "NaN | \n", "
3 | \n", "2330 | \n", "2021-08-18 | \n", "NaN | \n", "NaN | \n", "NaN | \n", "
4 | \n", "2330 | \n", "2021-08-19 | \n", "NaN | \n", "NaN | \n", "NaN | \n", "
... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "
45 | \n", "3711 | \n", "2021-12-02 | \n", "7.66 | \n", "3.29 | \n", "9.83 | \n", "
45 | \n", "3711 | \n", "2021-09-28 | \n", "7.66 | \n", "3.29 | \n", "9.83 | \n", "
45 | \n", "3711 | \n", "2022-04-26 | \n", "14.84 | \n", "7.18 | \n", "9.83 | \n", "
45 | \n", "3711 | \n", "2021-07-22 | \n", "14.84 | \n", "7.18 | \n", "9.83 | \n", "
45 | \n", "3711 | \n", "2022-07-01 | \n", "3.01 | \n", "3.01 | \n", "15.68 | \n", "
735 rows × 5 columns
\n", "