Community研究與資料分析github.com

NanookAI/twse-api

臺灣證券交易所(TWSE)OpenAPI 的專用技能——即時股價、本益比與殖利率、加權指數歷史、財務報表、ESG 資料,共 143 個端點,無需 API 金鑰。

twse-api 是什麼?

此技能為臺灣證券交易所(TWSE)的非官方開放資料 API 提供完整的開發者整合介面。它封裝了 143 個端點,涵蓋 7 大類別(證券交易、公司治理、財務報表、指數、權證、券商資料及其他),所有端點皆為純 GET 請求,無需 API 金鑰、無需註冊、無伺服端過濾。技能會詳細解釋關鍵慣例:回應總為 JSON 陣列且所有值皆為字串;端點使用英文或傳統中文欄位名稱;使用民國紀年(需加 1911 轉換為西元)。它支援 Claude Code、Cursor 及 Codex 等 AI 代理平台,讓開發者能直接透過自然語言查詢即時股價、本益比、財務報表、ESG 評級、除權息日曆與重大訊息。內建的端點速查表與七份參考文件分類目錄,能引導代理選擇正確的端點,並指導客戶端過濾(因回傳為完整資料集而非單筆查詢)。此技能對於需要整合臺灣上市股票資料的交易機器人、財務分析工具與 ESG 報告系統尤其有用。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add NanookAI/twse-api

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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/)

重要慣例(使用前請詳讀)

  1. 無伺服端過濾。 每個端點回傳完整資料集(通常為最新交易日快照或歷史序列)。若要取得單一股票資料,請擷取整個陣列,並在客戶端依股票代碼(Code 或 公司代號)進行過濾。回應資料範圍從幾行到約 30,000 行(內部人轉讓表)不等,因此請使用指令碼過濾,而非將原始輸出直接放入上下文。

  2. 兩種欄位命名風格。 位於 /exchangeReport、/indicesReport、/announcement、/block、/fund、/holidaySchedule 等路徑下的端點,大多使用英文 JSON 鍵(Code、Name、ClosingPrice...)。而 /opendata 路徑下的端點(t187ap* 資料集)則使用傳統中文 JSON 鍵(公司代號、公司名稱、營業收入-當月營收...)。參考文件中列出了每個端點的準確鍵值——請按原文使用,切勿猜測或翻譯鍵名。

  3. 民國紀年。 大多數 Date/出表日期 值的格式為 1150706,表示民國 115 年 7 月 6 日 = 2026-07-06(西元年 = 民國年 + 1911)。部分欄位(例如公司成立日期 成立日期)則使用西元 YYYYMMDD 格式——請檢查數字位數:7 位數以 1 開頭為民國紀年,8 位數以 19/20 開頭為西元紀年。

  4. 快照資料,非歷史查詢。 多數端點僅提供最新期間的資料:STOCK_DAY_ALL = 最新交易日,FMSRFK_ALL = 當月彙總(每行一檔股票),FMNPTK_ALL = 當年彙總。無法透過此 API 請求任意過往日期。真正的歷史序列僅在特定端點提供(例如 /indicesReport/MI_5MINS_HIST 提供加權指數每日歷史資料)。

  5. 數字解析。 數字字串可能包含逗號("1,030,726,137")、為空值,或為 "-"/"-" 表示無資料。轉換前請先移除逗號並處理空值。

  6. 資料範圍為 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其他4TWSE 新聞/活動、公債、基金

相關技能