Community研究与数据分析github.com

NanookAI/twse-api

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

twse-api 是什么?

這個技能封裝了臺灣證券交易所 (TWSE) 的官方開放資料 API,提供一個無需 API 金鑰或註冊即可存取的免費資料來源。它涵蓋 143 個端點,分為 7 大類別:證券交易、公司治理、財務報表、指數、權證、券商資料及其他。主要功能包括取得所有上市股票的日 OHLC 資料、本益比、股利殖利率、月營收、資產負債表與損益表,以及加權指數歷史和 ESG 資料集。由於 API 不支援伺服端過濾,每個端點回傳的是完整的資料集(例如最新交易日全體股票的快照),因此建議在客戶端用指令碼根據股票代碼過濾。回應中的數值皆為字串,可能包含逗號或表示無資料的「-」,解析前需先清除。日期欄位多為民國紀年(例如 1150706 對應西元 2026-07-06),少數欄位使用西元年月日,可依數字位數判斷。該技能設計在 Claude Code、Cursor 等 AI 代理人環境中使用,透過 SKILL.md 提供詳細的呼叫慣例、快速入門範例、任務對應端點速查表及完整的端點目錄連結。

兼容平台~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 (臺灣證券交易所 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/)

重要慣例(使用前請務必閱讀)

  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 上市證券。 上櫃證券由不同的 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 新聞/活動、公債、基金

相关技能