CommunityPesquisa e Análise de Dadosgithub.com

NanookAI/twse-api

Skill para a OpenAPI da Bolsa de Valores de Taiwan (TWSE) — cotações de ações, P/L e dividendos, histórico do TAIEX, demonstrações financeiras, dados ESG. 143 endpoints, sem necessidade de chave de API.

O que é twse-api?

Este skill oferece acesso completo à API pública de dados abertos da Bolsa de Valores de Taiwan (TWSE), expondo 143 endpoints em 7 categorias — desde cotações diárias (OHLC/volume), índices de valuation (P/L, dividend yield, P/B), demonstrações financeiras (receita mensal, DRE, balanço), até dados ESG e governança corporativa. Não é necessário registro ou chave de API; todos os endpoints são GET simples sem parâmetros, retornando arrays JSON com valores string. O skill é compatível com assistentes como Claude Code, Cursor, Codex e similares, permitindo que o agente consulte dados históricos do TAIEX, filtre ações por código, e extraia indicadores financeiros para análise de mercado. Atenção especial deve ser dada às convenções: datas no calendário ROC (Minguo) que precisam ser convertidas para gregoriano (ano ROC + 1911), dois estilos de chaves JSON (inglês ou chinês tradicional) conforme o endpoint, e ausência de filtragem no servidor — o agente deve baixar o dataset completo e filtrar localmente. O skill também fornece uma folha de consulta rápida e catálogo completo referenciado em arquivos de markdown auxiliares.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add NanookAI/twse-api

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

API oficial de dados abertos da Bolsa de Valores de Taiwan. Gratuita, sem chave de API, sem registro.

  • URL Base: https://openapi.twse.com.tw/v1
  • Método: todos os endpoints são GET simples, sem parâmetros (sem query string, sem parâmetros de caminho)
  • Resposta: sempre um array JSON de objetos simples; todo valor é uma string (números incluídos)
  • Catálogo completo: 143 endpoints em 7 categorias (veja Catálogo de endpoints abaixo)
  • Especificação Swagger: https://openapi.twse.com.tw/v1/swagger.json (UI da documentação: https://openapi.twse.com.tw/)

Convenções críticas (leia antes de chamar)

  1. Sem filtragem no servidor. Cada endpoint retorna o conjunto completo de dados (tipicamente o snapshot do último dia de negociação ou uma série histórica). Para obter dados de uma ação, baixe todo o array e filtre no cliente pelo código da ação (Code ou 公司代號). As respostas variam de algumas linhas até ~30.000 linhas (tabelas de transferência de insiders); portanto, filtre com um script em vez de despejar a saída bruta no contexto.

  2. Dois estilos de nomes de campos. Endpoints sob /exchangeReport, /indicesReport, /announcement, /block, /fund, /holidaySchedule etc. usam principalmente chaves JSON em inglês (Code, Name, ClosingPrice…). Endpoints sob /opendata (os conjuntos t187ap*) usam chaves JSON em chinês tradicional (公司代號, 公司名稱, 營業收入-當月營收…). Os arquivos de referência listam as chaves exatas por endpoint — use-as textualmente; não adivinhe nem traduza nomes de chaves.

  3. Datas ROC (Minguo 民國). A maioria dos campos Date/出表日期 têm valores como 1150706 = ano ROC 115, 6 de julho = 2026-07-06 (ano gregoriano = ano ROC + 1911). Alguns campos (ex.: data de fundação 成立日期) usam formato gregoriano YYYYMMDD — verifique a magnitude: 7 dígitos iniciando com 1 é ROC, 8 dígitos iniciando com 19/20 é gregoriano.

  4. Dados instantâneos, não consulta histórica. A maioria dos endpoints expõe apenas o período mais recente: STOCK_DAY_ALL = último dia de negociação, FMSRFK_ALL = agregação do mês corrente (uma linha por ação), FMNPTK_ALL = agregação do ano corrente. Não é possível solicitar uma data passada arbitrária através desta API. Séries históricas verdadeiras existem apenas onde indicado (ex.: /indicesReport/MI_5MINS_HIST para histórico diário do TAIEX).

  5. Parsing de números. Strings numéricas podem conter vírgulas ("1.030.726.137"), estar vazias ou ser "-"/"-" para N/A. Remova vírgulas e trate valores em branco antes de converter.

  6. Escopo de dados são títulos listados na TWSE (上市). Títulos OTC/TPEx (上櫃) são servidos por uma API diferente (https://www.tpex.org.tw/openapi/), não esta. Endpoints com sufixo _L = empresas listadas (上市), _P/_X = empresas públicas não listadas (公開發行).

Início rápido

# OHLC diário de todas as ações listadas, 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)

# P/L, dividend yield, P/B de uma ação
row = next(r for r in twse("/exchangeReport/BWIBBU_ALL") if r["Code"] == "2330")
# {'Code': '2330', 'Name': '台積電', 'PEratio': '...', 'DividendYield': '...', 'PBratio': '...'}

# Perfil da empresa (chaves em chinês!)
tsmc = next(r for r in twse("/opendata/t187ap03_L") if r["公司代號"] == "2330")

Folha de consulta tarefa → endpoint

TarefaEndpoint
OHLC/volume de hoje, todas as ações/exchangeReport/STOCK_DAY_ALL
P/L, dividend yield, P/B/exchangeReport/BWIBBU_ALL
Preço de fechamento + média mensal/exchangeReport/STOCK_DAY_AVG_ALL
Agregação mês corrente / ano corrente por ação/exchangeReport/FMSRFK_ALL / FMNPTK_ALL
Histórico do índice TAIEX (OHLC diário)/indicesReport/MI_5MINS_HIST
Volume/valor diário do mercado total/exchangeReport/FMTQIK
Perfil básico da empresa/opendata/t187ap03_L
Receita mensal, todas as empresas/opendata/t187ap05_L
Demonstração de resultado (indústria geral)/opendata/t187ap06_L_ci
Balanço patrimonial (indústria geral)/opendata/t187ap07_L_ci
Distribuição de dividendos/opendata/t187ap45_L
Notícias / materiais relevantes/opendata/t187ap04_L
Calendário de ex-dividendos/exchangeReport/TWT48U_ALL
Saldos de margem de negociação/exchangeReport/MI_MARGN
Feriados de negociação / calendário do mercado/holidaySchedule/holidaySchedule
Notícias TWSE/news/newsList

Catálogo de endpoints

Leia o arquivo de referência da categoria que você precisa — cada um lista todos os endpoints com as chaves de resposta exatas (originais em chinês mantidos como comentários):

Arquivo de referênciaCategoria (原分類)EndpointsConteúdo
references/securities-trading.md證券交易36Cotações diárias, índices de valuation, estatísticas de mercado, margem/bloco/day trade, ações sob atenção e regime especial, calendário do mercado
references/corporate-governance.md公司治理56Perfis de empresas, participações de insiders/diretores, dados do conselho, notícias materiais, dividendos, assembleias, 21 conjuntos ESG
references/financial-statements.md財務報表30Receita mensal, demonstrações de resultado e balanço por formato de indústria, resumos de lucratividade
references/indices.md指數5Históricos do TAIEX, Taiwan 50, Índice Formosa
references/warrants.md權證3Estatísticas de emissão e negociação de warrants
references/brokers.md券商資料9Diretórios de corretoras, pessoal, financeiros mensais
references/misc.md其他4Notícias/eventos TWSE, títulos públicos, fundos

Habilidades Relacionadas