TWSE OpenAPI (Taiwan Stock Exchange 臺灣證券交易所)
Offizielle Open-Data-API der Taiwan Stock Exchange. Kostenlos, kein API-Schlüssel, keine Registrierung.
- Basis-URL:
https://openapi.twse.com.tw/v1 - Methode: Alle Endpunkte sind reine
GET-Aufrufe, keinerlei Parameter (kein Query-String, keine Pfadparameter) - Antwort: Immer ein JSON-Array aus flachen Objekten; jeder Wert ist ein String (auch Zahlen)
- Vollständiger Endpunktkatalog: 143 Endpunkte in 7 Kategorien (siehe Endpunktkatalog unten)
- Swagger-Spezifikation:
https://openapi.twse.com.tw/v1/swagger.json(Dokumentations-UI: https://openapi.twse.com.tw/)
Wichtige Konventionen (vor dem Aufruf lesen)
-
Keine serverseitige Filterung. Jeder Endpunkt gibt den gesamten Datensatz zurück (typischerweise eine Momentaufnahme des letzten Handelstages oder eine historische Reihe). Um Daten für eine einzelne Aktie zu erhalten, rufen Sie das gesamte Array ab und filtern Sie clientseitig nach Aktiencode (
Codeoder公司代號). Die Antworten umfassen zwischen wenigen Zeilen und etwa 30.000 Zeilen (Insider-Handelstabellen). Filtern Sie daher mit einem Skript, anstatt die Rohausgabe in den Kontext zu laden. -
Zwei Namensstile für Felder. Endpunkte unter
/exchangeReport,/indicesReport,/announcement,/block,/fund,/holidayScheduleusw. verwenden meist englische JSON-Schlüssel (Code,Name,ClosingPrice...). Endpunkte unter/opendata(diet187ap*-Datensätze) verwenden traditionell chinesische JSON-Schlüssel (公司代號,公司名稱,營業收入-當月營收...). Die Referenzdateien listen die genauen Schlüssel pro Endpunkt auf – verwenden Sie diese wörtlich; erraten oder übersetzen Sie keine Schlüsselnamen. -
ROC-Daten (Minguo 民國). Die meisten
Date/出表日期-Werte sehen aus wie1150706= ROC-Jahr 115, 6. Juli = 2026-07-06 (Gregorianisches Jahr = ROC-Jahr + 1911). Einige Felder (z. B. das Gründungsdatum des Unternehmens成立日期) verwenden stattdessen das gregorianische FormatYYYYMMDD– überprüfen Sie die Länge: 7-stellige Zahlen, die mit1beginnen, sind ROC, 8-stellige Zahlen, die mit19/20beginnen, sind gregorianisch. -
Momentaufnahmen, keine Abfrage historischer Daten. Die meisten Endpunkte geben nur den letzten Zeitraum aus:
STOCK_DAY_ALL= letzter Handelstag,FMSRFK_ALL= aktueller Monatsaggregat (eine Zeile pro Aktie),FMNPTK_ALL= aktueller Jahresaggregat. Es gibt keine Möglichkeit, über diese API ein beliebiges vergangenes Datum anzufordern. Echte historische Reihen existieren nur, wo angegeben (z. B./indicesReport/MI_5MINS_HISTfür die tägliche TAIEX-Historie). -
Zahlenparsen. Numerische Zeichenketten können Kommas enthalten (
"1,030,726,137"), leer sein oder"-"/"-"für N/A enthalten. Entfernen Sie Kommas und behandeln Sie Leerzeichen, bevor Sie konvertieren. -
Datenumfang sind TWSE-gelistete (上市) Wertpapiere. OTC/TPEx (上櫃)-Wertpapiere werden von einer anderen API bedient (
https://www.tpex.org.tw/openapi/), nicht von dieser. Endpunkte mit der Endung_L= börsennotierte Unternehmen (上市),_P/_X= öffentliche, nicht börsennotierte Unternehmen (公開發行).
Schnellstart
# Tägliche OHLC-Daten aller gelisteten Aktien, Filter für 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)
# KGV, Dividendenrendite, KBV für eine Aktie
row = next(r for r in twse("/exchangeReport/BWIBBU_ALL") if r["Code"] == "2330")
# {'Code': '2330', 'Name': '台積電', 'PEratio': '...', 'DividendYield': '...', 'PBratio': '...'}
# Unternehmensprofil (chinesische Schlüssel!)
tsmc = next(r for r in twse("/opendata/t187ap03_L") if r["公司代號"] == "2330")
Aufgaben → Endpunkt-Spickzettel
| Aufgabe | Endpunkt |
|---|---|
| Heutige OHLC/Volumen, alle Aktien | /exchangeReport/STOCK_DAY_ALL |
| KGV, Dividendenrendite, KBV | /exchangeReport/BWIBBU_ALL |
| Schlusskurs + monatlicher Durchschnitt | /exchangeReport/STOCK_DAY_AVG_ALL |
| Pro-Aktie aktueller Monats-/Jahresaggregat | /exchangeReport/FMSRFK_ALL / FMNPTK_ALL |
| TAIEX-Index-Verlauf (tägliche OHLC) | /indicesReport/MI_5MINS_HIST |
| Tägliches Marktvolumen/-wert | /exchangeReport/FMTQIK |
| Basisprofil des Unternehmens | /opendata/t187ap03_L |
| Monatlicher Umsatz, alle Unternehmen | /opendata/t187ap05_L |
| Gewinn- und Verlustrechnung (allgemeine Industrie) | /opendata/t187ap06_L_ci |
| Bilanz (allgemeine Industrie) | /opendata/t187ap07_L_ci |
| Dividendenausschüttungen | /opendata/t187ap45_L |
| Wesentliche Nachrichten / Ankündigungen | /opendata/t187ap04_L |
| Ex-Dividenden-Kalender | /exchangeReport/TWT48U_ALL |
| Margin-Handelssalden | /exchangeReport/MI_MARGN |
| Handelsfeiertage / Marktkalender | /holidaySchedule/holidaySchedule |
| TWSE-Nachrichten | /news/newsList |
Endpunktkatalog
Lesen Sie die Referenzdatei für die benötigte Kategorie – jede listet alle Endpunkte mit ihren genauen Antwortschlüsseln auf (chinesische Originale als Kommentare beibehalten):
| Referenzdatei | Kategorie (原分類) | Endpunkte | Inhalt |
|---|---|---|---|
| references/securities-trading.md | 證券交易 | 36 | Tägliche Kurse, Bewertungskennzahlen, Marktstatistiken, Margin-/Block-/Daytrading, Aufmerksamkeits- & Dispositionsaktien, Marktkalender |
| references/corporate-governance.md | 公司治理 | 56 | Unternehmensprofile, Insider-/Vorstandsbestände, Board-Daten, wesentliche Nachrichten, Dividenden, Hauptversammlungen, 21 ESG-Datensätze |
| references/financial-statements.md | 財務報表 | 30 | Monatlicher Umsatz, Gewinn- und Verlustrechnungen & Bilanzen nach Industrieformat, Rentabilitätsübersichten |
| references/indices.md | 指數 | 5 | TAIEX, Taiwan 50, Formosa-Index-Verläufe |
| references/warrants.md | 權證 | 3 | Optionsschein-Emissionen und Handelsstatistiken |
| references/brokers.md | 券商資料 | 9 | Wertpapierfirmenverzeichnisse, Personal, monatliche Finanzdaten |
| references/misc.md | 其他 | 4 | TWSE-Nachrichten/Ereignisse, Staatsanleihen, Fonds |