NanookAI/twse-api

Habilidad para la API OpenAPI de la Bolsa de Valores de Taiwán (TWSE): cotizaciones, PER, rendimiento de dividendos, historial del TAIEX, estados financieros y datos ESG. 143 endpoints, no se requiere clave API.

¿Qué es twse-api?

Esta habilidad proporciona acceso completo a la API de datos abiertos de la Bolsa de Valores de Taiwán (TWSE, por sus siglas en inglés), con 143 endpoints distribuidos en 7 categorías que incluyen cotizaciones diarias, índices, ratios financieros, estados financieros, datos ESG, anuncios y calendario de mercado. No requiere registro ni clave API, lo que facilita su integración en agentes de IA como Claude Code, Cursor o Codex. La API es de solo lectura con respuestas JSON que contienen datos del último período disponible (sin filtrado en servidor), por lo que el agente debe realizar el filtrado por código de acción en el cliente. Soporta dos estilos de nombres de campo: inglés para la mayoría de los endpoints y chino tradicional para los conjuntos de datos de opendata. Las fechas están en el calendario de la República de China (Minguo) que requiere conversión a año gregoriano (año ROC + 1911). La habilidad incluye una hoja de referencia de tareas a endpoints y referencias detalladas para cada categoría, lo que permite a los agentes seleccionar rápidamente el endpoint correcto según la consulta del usuario.

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

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 GET simples, 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)

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

  2. 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 datos t187ap*) 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.

  3. Fechas ROC (Minguo 民國). La mayoría de los valores de Date/出表日期 se ven como 1150706 = 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 gregoriano AAAAMMDD en su lugar; verifica la magnitud: 7 dígitos que comienzan con 1 son ROC, 8 dígitos que comienzan con 19/20 son gregoriano.

  4. 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_HIST para el historial diario del TAIEX).

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

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

TareaEndpoint
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 referenciaCategoría (原分類)EndpointsContenido
references/securities-trading.md證券交易36Cotizaciones 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公司治理56Perfiles 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財務報表30Ingresos mensuales, estados de resultados y balances por formato de industria, resúmenes de rentabilidad
references/indices.md指數5Historiales de TAIEX, Taiwan 50, Formosa Index
references/warrants.md權證3Estadísticas de emisión y negociación de warrants
references/brokers.md券商資料9Directorios de firmas de valores, personal, finanzas mensuales
references/misc.md其他4Noticias/eventos de TWSE, bonos gubernamentales, fondos

Skills relacionados