TWSE OpenAPI (臺灣證券交易所 Taiwan Stock Exchange)
臺灣證券交易所官方開放資料 API。完全免費,無需 API 金鑰,無需註冊。
- 基礎網址:
https://openapi.twse.com.tw/v1 - 方法:所有端點均為純
GET,完全無參數(無查詢字串、無路徑參數) - 回應:一律為平面物件的 JSON 陣列;所有值皆為字串(數字亦同)
- 完整端點目錄:共 143 個端點,涵蓋 7 大類別(請見下方端點目錄)
- Swagger 規範:
https://openapi.twse.com.tw/v1/swagger.json(文件 UI:https://openapi.twse.com.tw/)
重要慣例(使用前請務必閱讀)
-
無伺服端過濾。 每個端點回傳的是 完整 資料集(通常為最新交易日的快照,或歷史序列)。若要查詢單一股票的資料,請先取得整個陣列,再於客戶端以股票代碼(
Code或公司代號)進行過濾。回應的資料列數從數筆到約 30,000 筆(內部人轉讓表)不等,因此請使用指令碼過濾,而非將原始輸出直接倒進對話脈絡。 -
兩種欄位命名風格。 位於
/exchangeReport、/indicesReport、/announcement、/block、/fund、/holidaySchedule等路徑下的端點,大多使用英文 JSON 鍵(Code、Name、ClosingPrice……)。位於/opendata(t187ap*資料集)下的端點,則使用繁體中文 JSON 鍵(公司代號、公司名稱、營業收入-當月營收……)。參考檔案中會列出每個端點的實際鍵名,請原樣使用,切勿猜測或翻譯鍵名。 -
民國日期。 多數
Date/出表日期值呈現為1150706,代表民國 115 年 7 月 6 日,即2026-07-06(西元年 = 民國年 + 1911)。某些欄位(例如公司成立日期成立日期)則使用西元YYYYMMDD格式,請依數字位數判斷:7 位數且開頭為1的是民國紀年,8 位數且開頭為19/20的是西元紀年。 -
快照資料,非歷史查詢。 多數端點僅揭露最近一期資料:
STOCK_DAY_ALL為最新交易日、FMSRFK_ALL為當月累計(每檔股票一行)、FMNPTK_ALL為當年累計。此 API 不支援查詢任意過去日期。真正的歷史序列僅在特定端點提供(例如/indicesReport/MI_5MINS_HIST的加權指數每日歷史)。 -
數字解析。 數字字串可能包含逗號(
"1,030,726,137")、為空字串,或為"-"/"-"表示無資料。轉換前請先移除逗號並處理空白。 -
資料範圍為 TWSE 上市證券。 上櫃證券由不同的 API(
https://www.tpex.org.tw/openapi/)提供,非本 API。端點後綴_L表示上市公司(上市),_P/_X表示公開發行公司(公開發行)。
快速入門
# 所有上市股票的每日 OHLC,以指令碼過濾出台積電 (2330)
curl -s https://openapi.twse.com.tw/v1/exchangeReport/STOCK_DAY_ALL |
python3 -c "import json,sys; print([r for r in json.load(sys.stdin) if r['Code']=='2330'])"
import json, urllib.request
BASE = "https://openapi.twse.com.tw/v1"
def twse(path):
with urllib.request.urlopen(BASE + path) as r:
return json.load(r)
# 查詢單一股票的本益比、殖利率、股價淨值比
row = next(r for r in twse("/exchangeReport/BWIBBU_ALL") if r["Code"] == "2330")
# {'Code': '2330', 'Name': '台積電', 'PEratio': '...', 'DividendYield': '...', 'PBratio': '...'}
# 公司基本資料(中文鍵名!)
tsmc = next(r for r in twse("/opendata/t187ap03_L") if r["公司代號"] == "2330")
任務對應端點速查表
| 任務 | 端點 |
|---|---|
| 今日所有股票的 OHLC/成交量 | /exchangeReport/STOCK_DAY_ALL |
| 本益比、殖利率、股價淨值比 | /exchangeReport/BWIBBU_ALL |
| 收盤價與月平均價 | /exchangeReport/STOCK_DAY_AVG_ALL |
| 個股當月/當年累計 | /exchangeReport/FMSRFK_ALL / FMNPTK_ALL |
| 加權指數歷史(每日 OHLC) | /indicesReport/MI_5MINS_HIST |
| 全市場每日成交量/成交值 | /exchangeReport/FMTQIK |
| 公司基本資料 | /opendata/t187ap03_L |
| 所有公司月營收 | /opendata/t187ap05_L |
| 損益表(一般業) | /opendata/t187ap06_L_ci |
| 資產負債表(一般業) | /opendata/t187ap07_L_ci |
| 股利分派 | /opendata/t187ap45_L |
| 重大訊息 / 公告 | /opendata/t187ap04_L |
| 除息除權行事曆 | /exchangeReport/TWT48U_ALL |
| 信用交易餘額 | /exchangeReport/MI_MARGN |
| 休市行事曆 | /holidaySchedule/holidaySchedule |
| TWSE 新聞 | /news/newsList |
端點目錄
請閱讀您所需的類別參考檔案——每個檔案皆列出該類別所有端點及其完整的回應鍵名(中文原始鍵名保留於註解中):
| 參考檔案 | 類別(原分類) | 端點數量 | 內容 |
|---|---|---|---|
| references/securities-trading.md | 證券交易 | 36 | 每日報價、評價比率、市場統計、信用/鉅額/當沖交易、注意及處置股票、市場行事曆 |
| references/corporate-governance.md | 公司治理 | 56 | 公司基本資料、內部人/董事持股、董事會資料、重大訊息、股利、股東會、21 項 ESG 資料集 |
| references/financial-statements.md | 財務報表 | 30 | 月營收、各行業別損益表與資產負債表、獲利能力摘要 |
| references/indices.md | 指數 | 5 | 加權指數、台灣 50、寶島指數歷史 |
| references/warrants.md | 權證 | 3 | 權證發行與交易統計 |
| references/brokers.md | 券商資料 | 9 | 證券商名錄、人員資料、月財務報告 |
| references/misc.md | 其他 | 4 | TWSE 新聞/活動、公債、基金 |