TWSE OpenAPI (Taiwán Stock Exchange 臺灣證券交易所)
API oficial de datos abiertos de la Bolsa de Valores de Taiwán. Gratuita, sin clave API, sin registro.
- URL base:
https://openapi.twse.com.tw/v1 - Método: todos los endpoints son
GETsimples, sin parámetros (sin cadena de consulta, sin parámetros de ruta) - Respuesta: siempre un array JSON de objetos planos; cada valor es una cadena (los números también)
- Catálogo completo: 143 endpoints en 7 categorías (ver Catálogo de endpoints abajo)
- Especificación Swagger:
https://openapi.twse.com.tw/v1/swagger.json(interfaz de documentación: https://openapi.twse.com.tw/)
Convenciones críticas (leer antes de llamar)
-
Sin filtrado en servidor. Cada endpoint devuelve el conjunto de datos completo (normalmente la instantánea del último día de negociación o una serie histórica). Para obtener datos de una acción, obtén todo el array y filtra del lado del cliente por código de acción (
Codeo公司代號). Las respuestas varían de unas pocas filas a ~30,000 filas (tablas de transferencias de internos), por lo que es mejor filtrar con un script en lugar de volcar la salida sin procesar al contexto. -
Dos estilos de nombres de campo. Los endpoints bajo
/exchangeReport,/indicesReport,/announcement,/block,/fund,/holidaySchedule, etc. usan principalmente claves JSON en inglés (Code,Name,ClosingPrice…). Los endpoints bajo/opendata(los conjuntos de datost187ap*) usan claves JSON en chino tradicional (公司代號,公司名稱,營業收入-當月營收…). Los archivos de referencia enumeran las claves exactas por endpoint: úsalos textualmente; no adivines ni traduzcas los nombres de las claves. -
Fechas ROC (Minguo 民國). La mayoría de los valores de
Date/出表日期se ven como1150706= año ROC 115, 6 de julio = 2026-07-06 (año gregoriano = año ROC + 1911). Algunos campos (por ejemplo, la fecha de fundación de la empresa成立日期) usan el formato gregorianoAAAAMMDDen su lugar; verifica la magnitud: 7 dígitos que comienzan con1son ROC, 8 dígitos que comienzan con19/20son gregoriano. -
Datos instantáneos, no consulta histórica. La mayoría de los endpoints solo exponen el período más reciente:
STOCK_DAY_ALL= último día de negociación,FMSRFK_ALL= agregado del mes actual (una fila por acción),FMNPTK_ALL= agregado del año actual. No hay forma de solicitar una fecha pasada arbitraria a través de esta API. Las series históricas reales existen solo donde se indica (por ejemplo,/indicesReport/MI_5MINS_HISTpara el historial diario del TAIEX). -
Análisis de números. Las cadenas numéricas pueden contener comas (
"1,030,726,137"), estar vacías o ser"-"/"-"para N/A. Elimina las comas y maneja los espacios en blanco antes de convertir. -
El alcance de los datos son valores cotizados en TWSE (上市). Los valores OTC/TPEx (上櫃) son atendidos por una API diferente (
https://www.tpex.org.tw/openapi/), no por esta. Los endpoints sufijados con_L= empresas cotizadas (上市),_P/_X= empresas públicas no cotizadas (公開發行).
Inicio rápido
# OHLC diario de todas las acciones cotizadas, filtrar para 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, rendimiento de dividendos, P/B para una acción
fila = next(r for r in twse("/exchangeReport/BWIBBU_ALL") if r["Code"] == "2330")
# {'Code': '2330', 'Name': '台積電', 'PEratio': '...', 'DividendYield': '...', 'PBratio': '...'}
# Perfil de la compañía (claves en chino!)
tsmc = next(r for r in twse("/opendata/t187ap03_L") if r["公司代號"] == "2330")
Hoja de referencia de tareas a endpoints
| Tarea | Endpoint |
|---|---|
| OHLC/volumen de hoy, todas las acciones | /exchangeReport/STOCK_DAY_ALL |
| PER, rendimiento de dividendos, P/B | /exchangeReport/BWIBBU_ALL |
| Precio de cierre + promedio mensual | /exchangeReport/STOCK_DAY_AVG_ALL |
| Agregado del mes/año actual por acción | /exchangeReport/FMSRFK_ALL / FMNPTK_ALL |
| Historial del índice TAIEX (OHLC diario) | /indicesReport/MI_5MINS_HIST |
| Volumen/valor diario de todo el mercado | /exchangeReport/FMTQIK |
| Perfil básico de la compañía | /opendata/t187ap03_L |
| Ingresos mensuales, todas las empresas | /opendata/t187ap05_L |
| Estado de resultados (industria general) | /opendata/t187ap06_L_ci |
| Balance general (industria general) | /opendata/t187ap07_L_ci |
| Distribuciones de dividendos | /opendata/t187ap45_L |
| Noticias/anuncios relevantes | /opendata/t187ap04_L |
| Calendario de ex-dividendos | /exchangeReport/TWT48U_ALL |
| Saldos de negociación de margen | /exchangeReport/MI_MARGN |
| Festivos comerciales/calendario de mercado | /holidaySchedule/holidaySchedule |
| Noticias de TWSE | /news/newsList |
Catálogo de endpoints
Lee el archivo de referencia para la categoría que necesitas; cada uno enumera todos los endpoints con sus claves de respuesta exactas (los originales en chino se conservan como comentarios):
| Archivo de referencia | Categoría (原分類) | Endpoints | Contenido |
|---|---|---|---|
| references/securities-trading.md | 證券交易 | 36 | Cotizaciones diarias, ratios de valoración, estadísticas de mercado, negociación de margen/bloque/diario, acciones de atención y disposición, calendario de mercado |
| references/corporate-governance.md | 公司治理 | 56 | Perfiles de empresas, tenencias de internos/directores, datos de la junta, noticias relevantes, dividendos, juntas de accionistas, 21 conjuntos de datos ESG |
| references/financial-statements.md | 財務報表 | 30 | Ingresos mensuales, estados de resultados y balances por formato de industria, resúmenes de rentabilidad |
| references/indices.md | 指數 | 5 | Historiales de TAIEX, Taiwan 50, Formosa Index |
| references/warrants.md | 權證 | 3 | Estadísticas de emisión y negociación de warrants |
| references/brokers.md | 券商資料 | 9 | Directorios de firmas de valores, personal, finanzas mensuales |
| references/misc.md | 其他 | 4 | Noticias/eventos de TWSE, bonos gubernamentales, fondos |