NanookAI/twse-api

Compétence pour l'API Ouverte de la Bourse de Taïwan (TWSE) — cours des actions, ratios PER et rendement des dividendes, historique TAIEX, états financiers, données ESG. 143 points d'accès, aucune clé API requise.

Qu'est-ce que twse-api ?

Cette compétence permet aux agents IA (tels que Claude Code, Cursor ou Codex) d'accéder à l' intégralité de l'API ouverte de la Bourse de Taïwan (TWSE / 臺灣證券交易所) sans nécessiter de clé API ni d'inscription. Elle expose les 143 endpoints répartis en 7 catégories : transactions boursières, gouvernance d'entreprise (incluant 21 jeux de données ESG), états financiers, indices (TAIEX, Taiwan 50), warrants, courtiers et données diverses. Les données brutes sont renvoyées sous forme de tableaux JSON plats ; l'agent doit effectuer le filtrage côté client par code action. La compétence documente des conventions critiques : les dates en format ROC (民国), les clés JSON en anglais ou en chinois traditionnel selon l'endpoint, et l'absence de paramétrage serveur. Elle fournit un aide-mémoire tâche→endpoint ainsi qu'une table de référence pour chaque catégorie, facilitant la sélection et l'utilisation des bons endpoints. Idéal pour les agents financiers, les robots d'analyse, ou les outils de développement intégrant des données boursières taïwanaises.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add NanookAI/twse-api

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

TWSE OpenAPI (Taiwan Stock Exchange 臺灣證券交易所)

API officielle de données ouvertes de la Bourse de Taïwan. Gratuite, aucune clé API, aucune inscription.

  • URL de base : https://openapi.twse.com.tw/v1
  • Méthode : tous les endpoints sont de simples GET, sans aucun paramètre (ni chaîne de requête, ni paramètre de chemin)
  • Réponse : toujours un tableau JSON d'objets plats ; chaque valeur est une chaîne (les nombres inclus)
  • Catalogue complet des endpoints : 143 endpoints répartis dans 7 catégories (voir Catalogue des endpoints ci-dessous)
  • Spécification Swagger : https://openapi.twse.com.tw/v1/swagger.json (interface utilisateur : https://openapi.twse.com.tw/)

Conventions critiques (à lire avant d'appeler)

  1. Aucun filtrage côté serveur. Chaque endpoint renvoie l'ensemble complet des données (généralement un instantané du dernier jour de bourse, ou une série historique). Pour obtenir les données d'une seule action, récupérez le tableau entier et filtrez côté client par code action (Code ou 公司代號). Les réponses vont de quelques lignes à environ 30 000 lignes (tableaux de transferts d'initiés) ; filtrez avec un script plutôt que de déverser la sortie brute dans le contexte.

  2. Deux styles de noms de champs. Les endpoints sous /exchangeReport, /indicesReport, /announcement, /block, /fund, /holidaySchedule, etc. utilisent majoritairement des clés JSON en anglais (Code, Name, ClosingPrice...). Les endpoints sous /opendata (les jeux de données t187ap*) utilisent des clés JSON en chinois traditionnel (公司代號, 公司名稱, 營業收入-當月營收...). Les fichiers de référence listent les clés exactes par endpoint — utilisez-les textuellement ; ne devinez ni ne traduisez les noms de clés.

  3. Dates ROC (Minguo 民國). La plupart des valeurs Date/出表日期 ressemblent à 1150706 = année ROC 115, 6 juillet = 2026-07-06 (année grégorienne = année ROC + 1911). Certains champs (par exemple la date de fondation de l'entreprise 成立日期) utilisent le format grégorien YYYYMMDD — vérifiez la magnitude : 7 chiffres commençant par 1 est ROC, 8 chiffres commençant par 19/20 est grégorien.

  4. Données instantanées, pas de requête historique. La plupart des endpoints exposent uniquement la période la plus récente : STOCK_DAY_ALL = dernier jour de bourse, FMSRFK_ALL = cumul du mois en cours (une ligne par action), FMNPTK_ALL = cumul de l'année en cours. Il n'est pas possible de demander une date passée arbitraire via cette API. Les véritables séries historiques n'existent que là où elles sont mentionnées (par exemple /indicesReport/MI_5MINS_HIST pour l'historique quotidien du TAIEX).

  5. Analyse des nombres. Les chaînes numériques peuvent contenir des virgules ("1,030,726,137"), être vides, ou être "-"/"-" pour les valeurs non disponibles. Supprimez les virgules et traitez les blancs avant de convertir.

  6. Le périmètre des données est celui des valeurs TWSE cotées (上市). Les valeurs OTC/TPEx (上櫃) sont servies par une API différente (https://www.tpex.org.tw/openapi/), pas par celle-ci. Les endpoints suffixés _L = sociétés cotées (上市), _P/_X = sociétés publiques non cotées (公開發行).

Démarrage rapide

# OHLC quotidien pour toutes les actions cotées, filtrage pour 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)

# PER, rendement du dividende, P/B pour une action
ligne = next(r for r in twse("/exchangeReport/BWIBBU_ALL") if r["Code"] == "2330")
# {'Code': '2330', 'Name': '台積電', 'PEratio': '...', 'DividendYield': '...', 'PBratio': '...'}

# Profil de l'entreprise (clés en chinois !)
tsmc = next(r for r in twse("/opendata/t187ap03_L") if r["公司代號"] == "2330")

Aide-mémoire Tâche → Endpoint

TâcheEndpoint
OHLC/volume du jour, toutes les actions/exchangeReport/STOCK_DAY_ALL
PER, rendement du dividende, P/B/exchangeReport/BWIBBU_ALL
Prix de clôture + moyenne mensuelle/exchangeReport/STOCK_DAY_AVG_ALL
Cumul mensuel / annuel par action/exchangeReport/FMSRFK_ALL / FMNPTK_ALL
Historique de l'indice TAIEX (OHLC quotidien)/indicesReport/MI_5MINS_HIST
Volume/valeur quotidien du marché entier/exchangeReport/FMTQIK
Profil de base de l'entreprise/opendata/t187ap03_L
Revenus mensuels, toutes les entreprises/opendata/t187ap05_L
Compte de résultat (industrie générale)/opendata/t187ap06_L_ci
Bilan (industrie générale)/opendata/t187ap07_L_ci
Distributions de dividendes/opendata/t187ap45_L
Actualités / annonces matérielles/opendata/t187ap04_L
Calendrier ex-dividende/exchangeReport/TWT48U_ALL
Soldes des opérations sur marge/exchangeReport/MI_MARGN
Jours fériés / calendrier boursier/holidaySchedule/holidaySchedule
Actualités TWSE/news/newsList

Catalogue des endpoints

Lisez le fichier de référence pour la catégorie dont vous avez besoin — chacun liste tous les endpoints avec leurs clés de réponse exactes (les originaux chinois conservés en commentaires) :

Fichier de référenceCatégorie (原分類)EndpointsContenu
references/securities-trading.md證券交易36Cours quotidiens, ratios de valorisation, statistiques de marché, opérations sur marge/blocs/quotidiennes, actions sous surveillance & sous séquestre, calendrier boursier
references/corporate-governance.md公司治理56Profils d'entreprise, participations des initiés/administrateurs, données de conseil, actualités matérielles, dividendes, assemblées générales, 21 jeux de données ESG
references/financial-statements.md財務報表30Revenus mensuels, comptes de résultat et bilans par format sectoriel, résumés de rentabilité
references/indices.md指數5Historiques TAIEX, Taiwan 50, Formosa Index
references/warrants.md權證3Statistiques d'émission et de transaction des warrants
references/brokers.md券商資料9Annuaire des sociétés de courtage, personnel, états financiers mensuels
references/misc.md其他4Actualités/événements TWSE, obligations d'État, fonds

Skills associés