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)
-
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 (
Codeou公司代號). 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. -
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éest187ap*) 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. -
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égorienYYYYMMDD— vérifiez la magnitude : 7 chiffres commençant par1est ROC, 8 chiffres commençant par19/20est grégorien. -
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_HISTpour l'historique quotidien du TAIEX). -
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. -
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âche | Endpoint |
|---|---|
| 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érence | Catégorie (原分類) | Endpoints | Contenu |
|---|---|---|---|
| references/securities-trading.md | 證券交易 | 36 | Cours 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 | 公司治理 | 56 | Profils 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 | 財務報表 | 30 | Revenus mensuels, comptes de résultat et bilans par format sectoriel, résumés de rentabilité |
| references/indices.md | 指數 | 5 | Historiques TAIEX, Taiwan 50, Formosa Index |
| references/warrants.md | 權證 | 3 | Statistiques d'émission et de transaction des warrants |
| references/brokers.md | 券商資料 | 9 | Annuaire des sociétés de courtage, personnel, états financiers mensuels |
| references/misc.md | 其他 | 4 | Actualités/événements TWSE, obligations d'État, fonds |