TWSE OpenAPI(臺灣證券交易所 台湾証券取引所)
台湾証券取引所の公式オープンデータAPI。無料、APIキー不要、登録不要。
- ベースURL:
https://openapi.twse.com.tw/v1 - メソッド: 全エンドポイントは単純な
GET、パラメータは一切なし(クエリ文字列、パスパラメータともに無し) - 応答: 常にフラットなオブジェクトのJSON配列;すべての値は文字列(数値も含む)
- 全エンドポイントカタログ: 7カテゴリ、143エンドポイント(下記「エンドポイントカタログ」参照)
- Swagger仕様:
https://openapi.twse.com.tw/v1/swagger.json(ドキュメントUI: https://openapi.twse.com.tw/)
重要な規約(呼び出し前に必読)
-
サーバー側フィルタリングは不可。 各エンドポイントは全データセットを返します(通常は最新取引日のスナップショット、または履歴系列)。特定の銘柄のデータを取得するには、配列全体を取得し、銘柄コード(
Codeまたは公司代號)でクライアント側でフィルタリングしてください。応答のサイズは数行から約30,000行(インサイダー譲渡テーブル)まで様々なので、生の出力をそのままコンテキストに投入するのではなく、スクリプトでフィルタリングしてください。 -
2種類のフィールド命名スタイル。
/exchangeReport、/indicesReport、/announcement、/block、/fund、/holidayScheduleなどのエンドポイントでは主に英語のJSONキー(Code、Name、ClosingPrice…)が使われます。/opendata配下のエンドポイント(t187ap*データセット)では繁体字中国語のJSONキー(公司代號、公司名稱、營業收入-當月營收…)が使われます。参照ファイルにはエンドポイントごとの正確なキーが記載されています — そのまま使用し、キー名を推測したり翻訳したりしないでください。 -
民国(Minguo 民國)日付。 ほとんどの
Date/出表日期の値は1150706のようになっており、民国115年7月6日 = 2026-07-06(西暦年 = 民国年 + 1911)を意味します。一部のフィールド(例:会社設立日成立日期)では西暦YYYYMMDDが使われる場合があります — 桁数を確認してください:1で始まる7桁は民国、19/20で始まる8桁は西暦です。 -
スナップショットデータであり、履歴クエリではない。 ほとんどのエンドポイントは最新期間のみを公開します:
STOCK_DAY_ALL= 最新取引日、FMSRFK_ALL= 当月累計(銘柄ごとに1行)、FMNPTK_ALL= 当年累計。このAPIを通じて任意の過去日付をリクエストする方法はありません。真の履歴系列が存在するのは、明記されている場合のみです(例:加権指数の日次履歴/indicesReport/MI_5MINS_HIST)。 -
数値のパース。 数値文字列にはカンマが含まれている場合があり(
"1,030,726,137")、空文字列の場合、または"-"/"-"で欠損値を示す場合があります。変換前にカンマを除去し、空欄を処理してください。 -
データ範囲はTWSE上場(上市)証券。 店頭市場(OTC/TPEx、上櫃)証券は別のAPI(
https://www.tpex.org.tw/openapi/)が提供しており、こちらは対象外です。末尾が_Lのエンドポイント = 上場企業(上市)、_P/_X= 非上場公開企業(公開發行)。
クイックスタート
# 全上場銘柄の日次四本値(OHLC)、TSMC(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)
# 1銘柄のPER、配当利回り、PBR
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")
タスク → エンドポイント早見表
| タスク | エンドポイント |
|---|---|
| 本日の四本値・出来高(全銘柄) | /exchangeReport/STOCK_DAY_ALL |
| PER、配当利回り、PBR | /exchangeReport/BWIBBU_ALL |
| 終値 + 月間平均 | /exchangeReport/STOCK_DAY_AVG_ALL |
| 銘柄別当月 / 当年累計 | /exchangeReport/FMSRFK_ALL / FMNPTK_ALL |
| 加権指数履歴(日次四本値) | /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ニュース・イベント、国債、ファンド |