Community研究&データ分析github.com

NanookAI/twse-api

臺灣證券交易所(TWSE)開放APIのスキル — 株価、PER・配当利回り、加権指数履歴、財務諸表、ESGデータなどを提供。143のエンドポイントがあり、APIキー不要。

twse-api とは?

このスキルは、臺灣證券交易所(TWSE)が公式に提供するオープンデータAPIをエージェントから直接利用できるようにするものです。全143エンドポイントは認証不要で、ベースURLは `https://openapi.twse.com.tw/v1`、すべてのエンドポイントは単純なGETリクエストで、クエリパラメータやパスパラメータは一切ありません。応答は常にフラットなオブジェクトのJSON配列で、値はすべて文字列として返されます。サーバー側でのフィルタリングはできないため、クライアント側で銘柄コードなどを使ってフィルタリングする必要があります。フィールド名には英語と繁体字中国語の2種類のスタイルが混在しており、日付は主に民国紀元(ROC年)で表記されるなど、いくつかの重要な規約を理解した上で利用する必要があります。Claude Code, Cursor, CodexなどのAIエージェントに対応しており、台湾株式市場の分析や銘柄調査に役立ちます。

対応~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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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

重要な規約(呼び出し前に必読)

  1. サーバー側フィルタリングは不可。 各エンドポイントは全データセットを返します(通常は最新取引日のスナップショット、または履歴系列)。特定の銘柄のデータを取得するには、配列全体を取得し、銘柄コード(Code または 公司代號)でクライアント側でフィルタリングしてください。応答のサイズは数行から約30,000行(インサイダー譲渡テーブル)まで様々なので、生の出力をそのままコンテキストに投入するのではなく、スクリプトでフィルタリングしてください。

  2. 2種類のフィールド命名スタイル。 /exchangeReport、/indicesReport、/announcement、/block、/fund、/holidaySchedule などのエンドポイントでは主に英語のJSONキー(Code、Name、ClosingPrice…)が使われます。/opendata 配下のエンドポイント(t187ap* データセット)では繁体字中国語のJSONキー(公司代號、公司名稱、營業收入-當月營收…)が使われます。参照ファイルにはエンドポイントごとの正確なキーが記載されています — そのまま使用し、キー名を推測したり翻訳したりしないでください。

  3. 民国(Minguo 民國)日付。 ほとんどの Date/出表日期 の値は 1150706 のようになっており、民国115年7月6日 = 2026-07-06(西暦年 = 民国年 + 1911)を意味します。一部のフィールド(例:会社設立日 成立日期)では西暦 YYYYMMDD が使われる場合があります — 桁数を確認してください:1 で始まる7桁は民国、19/20 で始まる8桁は西暦です。

  4. スナップショットデータであり、履歴クエリではない。 ほとんどのエンドポイントは最新期間のみを公開します:STOCK_DAY_ALL = 最新取引日、FMSRFK_ALL = 当月累計(銘柄ごとに1行)、FMNPTK_ALL = 当年累計。このAPIを通じて任意の過去日付をリクエストする方法はありません。真の履歴系列が存在するのは、明記されている場合のみです(例:加権指数の日次履歴 /indicesReport/MI_5MINS_HIST)。

  5. 数値のパース。 数値文字列にはカンマが含まれている場合があり("1,030,726,137")、空文字列の場合、または "-"/"-" で欠損値を示す場合があります。変換前にカンマを除去し、空欄を処理してください。

  6. データ範囲は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其他(その他)4TWSEニュース・イベント、国債、ファンド

関連スキル