CommunityRecherche & Datenanalysegithub.com

NanookAI/twse-api

Skill für die OpenAPI der Taiwan Stock Exchange (TWSE) – Aktienkurse, KGV & Dividendenrendite, TAIEX-Verlauf, Finanzberichte, ESG-Daten. 143 Endpunkte, kein API-Schlüssel erforderlich.

Was ist twse-api?

Dieses Skill ermöglicht den direkten Zugriff auf die offizielle OpenAPI der Taiwan Stock Exchange (TWSE). Es ist besonders nützlich für Entwickler und KI-Agenten, die auf Echtzeit-Aktienmarktdaten, historische Indizes, Finanzkennzahlen und ESG-Daten aus Taiwan zugreifen möchten, ohne sich registrieren oder einen API-Schlüssel bereitstellen zu müssen. Das Skill deckt 143 Endpunkte in sieben Kategorien ab, darunter Wertpapierhandel, Unternehmensführung (mit 21 ESG-Datensätzen) und Jahresabschlüsse. Eine wichtige Konvention ist, dass alle Endpunkte den gesamten Datensatz zurückgeben, sodass clientseitig nach Aktiencode gefiltert werden muss. Zudem werden Jahreszahlen im ROC-Format (Minguo) verwendet, die umgerechnet werden müssen. Das Skill unterstützt sowohl englische als auch traditionell chinesische Feldnamen und ist für die TWSE-gelisteten Unternehmen (上市) ausgelegt, nicht für den OTC-Markt (上櫃/TPEx).

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add NanookAI/twse-api

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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)

  1. 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 (Code oder 公司代號). 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.

  2. Zwei Namensstile für Felder. Endpunkte unter /exchangeReport, /indicesReport, /announcement, /block, /fund, /holidaySchedule usw. verwenden meist englische JSON-Schlüssel (Code, Name, ClosingPrice...). Endpunkte unter /opendata (die t187ap*-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.

  3. ROC-Daten (Minguo 民國). Die meisten Date/出表日期-Werte sehen aus wie 1150706 = 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 Format YYYYMMDD – überprüfen Sie die Länge: 7-stellige Zahlen, die mit 1 beginnen, sind ROC, 8-stellige Zahlen, die mit 19/20 beginnen, sind gregorianisch.

  4. 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_HIST für die tägliche TAIEX-Historie).

  5. 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.

  6. 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

AufgabeEndpunkt
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):

ReferenzdateiKategorie (原分類)EndpunkteInhalt
references/securities-trading.md證券交易36Tägliche Kurse, Bewertungskennzahlen, Marktstatistiken, Margin-/Block-/Daytrading, Aufmerksamkeits- & Dispositionsaktien, Marktkalender
references/corporate-governance.md公司治理56Unternehmensprofile, Insider-/Vorstandsbestände, Board-Daten, wesentliche Nachrichten, Dividenden, Hauptversammlungen, 21 ESG-Datensätze
references/financial-statements.md財務報表30Monatlicher Umsatz, Gewinn- und Verlustrechnungen & Bilanzen nach Industrieformat, Rentabilitätsübersichten
references/indices.md指數5TAIEX, Taiwan 50, Formosa-Index-Verläufe
references/warrants.md權證3Optionsschein-Emissionen und Handelsstatistiken
references/brokers.md券商資料9Wertpapierfirmenverzeichnisse, Personal, monatliche Finanzdaten
references/misc.md其他4TWSE-Nachrichten/Ereignisse, Staatsanleihen, Fonds

Verwandte Skills