TWSE OpenAPI (臺灣證券交易所)
臺灣證券交易所官方開放資料 API。免費使用,無需 API 金鑰,無需註冊。
- Base URL:
https://openapi.twse.com.tw/v1 - Method: 所有端點皆為純
GET,完全無參數(無查詢字串、無路徑參數) - Response: 始終為 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 上市證券。 櫃買(OTC/TPEx)證券由另一個 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 新聞/活動、公債、基金 |