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
GETsimples, 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)
-
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 (
Codeou公司代號). 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. -
Dois estilos de nomes de campos. Endpoints sob
/exchangeReport,/indicesReport,/announcement,/block,/fund,/holidayScheduleetc. usam principalmente chaves JSON em inglês (Code,Name,ClosingPrice…). Endpoints sob/opendata(os conjuntost187ap*) 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. -
Datas ROC (Minguo 民國). A maioria dos campos
Date/出表日期têm valores como1150706= ano ROC 115, 6 de julho = 2026-07-06 (ano gregoriano = ano ROC + 1911). Alguns campos (ex.: data de fundação成立日期) usam formato gregorianoYYYYMMDD— verifique a magnitude: 7 dígitos iniciando com1é ROC, 8 dígitos iniciando com19/20é gregoriano. -
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_HISTpara histórico diário do TAIEX). -
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. -
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
| Tarefa | Endpoint |
|---|---|
| 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ência | Categoria (原分類) | Endpoints | Conteúdo |
|---|---|---|---|
| references/securities-trading.md | 證券交易 | 36 | Cotaçõ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 | 公司治理 | 56 | Perfis de empresas, participações de insiders/diretores, dados do conselho, notícias materiais, dividendos, assembleias, 21 conjuntos ESG |
| references/financial-statements.md | 財務報表 | 30 | Receita mensal, demonstrações de resultado e balanço por formato de indústria, resumos de lucratividade |
| references/indices.md | 指數 | 5 | Históricos do TAIEX, Taiwan 50, Índice Formosa |
| references/warrants.md | 權證 | 3 | Estatísticas de emissão e negociação de warrants |
| references/brokers.md | 券商資料 | 9 | Diretórios de corretoras, pessoal, financeiros mensais |
| references/misc.md | 其他 | 4 | Notícias/eventos TWSE, títulos públicos, fundos |