Como aceder
Todos os ficheiros são públicos, sem registo nem chave de API. Base dos URLs:
https://dados.tiagofelicia.pt/data/<caminho>
Exemplos:
# curl
curl -s https://dados.tiagofelicia.pt/data/omie/omie_dados_atuais.csv
# Python / pandas
import pandas as pd
df = pd.read_csv("https://dados.tiagofelicia.pt/data/omie/omie_dados_atuais.csv")
# JavaScript (CORS aberto: Access-Control-Allow-Origin: *)
const r = await fetch("https://dados.tiagofelicia.pt/data/omie/records_omie.json");
const recordes = await r.json();
Espelho alternativo (mesmos caminhos): https://raw.githubusercontent.com/tiagofelicia/dados-energia/main/data/…
Catálogo e estado
data/manifest.json é o catálogo legível por máquina:
para cada dataset, o caminho, o schema, a cadência de atualização, a última data disponível e os
avisos relevantes. A página Estado dos dados lê esse
manifesto e mostra se algum dataset está atrasado — o cálculo é feito no seu navegador, pelo que
continua a reportar atrasos mesmo que os processos de recolha parem.
Por onde começar
Se quer médias e totais, use data/agregados/ em vez das séries
quarto-horárias: 2 KB em vez de 32 MB. Se quer mostrar o dia corrente numa página, use os
hoje.json.
🔌 Preços de mercado — data/omie/
| Ficheiro | Conteúdo | Atualização |
|---|---|---|
| omie_dados_atuais.csv | Preços quarto-horários PT/ES do ano corrente (€/MWh), incluindo datas futuras estimadas via futuros OMIP. Inclui classificação dos períodos horários BTN (Simples, Bi, Tri). | ~2×/dia útil |
historico/omie_historico_AAAA.csv |
Séries anuais 2010–presente, mesmo schema. Ex.: 2024 | Fecho de ano |
| precos-horarios.csv | Preço final quarto-horário por tarifário indexado e opção horária (fórmulas). | ~1×/dia útil |
| hoje.json | Instantâneo do dia para dashboards e widgets: preços de hoje e de amanhã, médias por período do ciclo horário (~8 KB). | A cada atualização |
| futuros_omip.csv | Versão leve só com as tabelas de metadados e futuros OMIP da sessão em curso (~3 KB). | ~5×/dia útil |
historico/omip_historico_AAAA.csv |
Histórico de sessões OMIP: uma linha por sessão × zona × contrato. Ex.: 2026 | Diária |
| records_omie.json | Recordes históricos OMIE (dia/hora mais caro e mais barato, etc.) + agregados. | Diária |
⚠️ Dois avisos de formato.
O omie_dados_atuais.csv tem blocos extra no fim (TABELA_ATUALIZACOES,
TABELA_FUTUROS_*): corte no primeiro TABELA_ ou use os agregados.
O precos-horarios.csv não abre com pd.read_csv sem argumentos —
tem tabelas concatenadas horizontalmente, o que produz linhas de larguras diferentes.
Além disso, as datas do omie_dados_atuais.csv posteriores à
Data_Valores_OMIE (declarada em futuros_omip.csv) são
estimativas dos futuros OMIP, não preços de mercado.
🏭 Produção elétrica (Portugal e Europa) — data/producao/
| Ficheiro | Conteúdo | Atualização |
|---|---|---|
| producao_dados_atuais.csv | Produção por fonte (Hídrica, Eólica, Solar, …), importação/exportação, bombagem, baterias e consumo — potência média (MW) por intervalo de 15 min, ano corrente. Fonte: REN. | A cada 4 h |
historico/producao_historico_AAAA.csv |
Séries anuais 2010–presente, mesmo schema. Ex.: 2024 | Fecho de ano |
| producao_bombagem_diaria.csv | Consumo diário em bombagem hidroelétrica (GWh), desde 2010. | A cada 4 h |
| hoje.json | Instantâneo do dia: mix quarto-horário, resumo diário e estado no último intervalo (~15 KB). | A cada atualização |
| records_producao.json | Recordes (dia mais renovável, maior consumo, pico) + agregados mensais. | A cada 4 h |
producao-entsoe/{cc}/AAAA-W SS.json |
Produção europeia intra-diária para 35 países: geração por tecnologia, consumo, previsões day-ahead e intradiárias, preços e fluxos transfronteiriços. Um ficheiro por país e semana ISO. Ex.: pt 2026-W35 · metadata | A cada 4 h (PT/ES) · 2×/dia (todos) |
Valores em MW (potência média no intervalo). Para energia: MW × 0,25 = MWh.
Os ficheiros de producao-entsoe/ têm schema próprio, com timezone,
interval_minutes e unix_seconds explícitos.
🔥 Mercado de gás — data/gas/
| Ficheiro | Conteúdo | Atualização |
|---|---|---|
| mibgas_spot.csv | Índices diários do mercado ibérico de gás (PT, ES, VTP, PVB, GNL, armazenamento) desde 17/12/2015. Só índices à vista: preços reais, sem preenchimento de lacunas. | 2×/dia |
| mibgas_futuros.csv | Curva forward do gás ibérico em preço absoluto — do intradiário ao ano Y+2, com a
coluna rotulo já legível («Janeiro 2027», «1.º Trimestre 2027»).
Desde 16/12/2015. |
2×/dia |
| mibgas_ttf_spread.csv | Prémio do gás ibérico face ao benchmark europeu TTF, 15 produtos de D+1 a Y+2, desde 02/01/2024. | 2×/dia |
| metadata.json | Última data, primeira data e cobertura. | 2×/dia |
Preços em €/MWh (PCS). Campo vazio = não publicado nesse dia, nunca zero.
PVB é o ponto virtual espanhol e VTP o português. Há dois índices por zona e diferem no âmbito:
vtp_last/pvb_last são o índice day-ahead (um produto, uma
sessão — é o que o site do MIBGAS mostra), enquanto mibgas_pt/mibgas_es
cobrem todos os produtos com entrega nesse dia e só fecham um a dois dias depois.
Confirme qual a fórmula do seu comercializador refere.
Na curva forward, o médio e longo prazo (mês, trimestre, estação, ano) é cotado só em
Espanha; Portugal tem apenas produtos de curto prazo.
A coluna ttf_derivado é uma estimativa (±1 €/MWh), não o índice oficial da ICE.
🗺️ Europa — data/mapas/
| Caminho | Conteúdo | Atualização |
|---|---|---|
precos_qh/AAAA-MM.json |
Preços day-ahead por zona de mercado europeia (ENTSO-E), um ficheiro por mês desde 2018-01. Por dia/zona: média, mín, máx e valores quarto-horários (€/MWh). Ex.: 2026-06 · metadata | 1×/dia |
producao/AAAA-MM.json |
Mix de produção diário por país europeu (GWh/dia por tecnologia + consumo), desde 2026-01. Fonte: Energy-Charts. Ex.: 2026-06 · metadata | 1×/dia |
📊 Séries pré-calculadas — data/agregados/
Derivados de data/omie/ e data/producao/, para quem quer médias e totais
sem descarregar as séries quarto-horárias completas (~94 MB).
| Ficheiro | Conteúdo | Tamanho |
|---|---|---|
| omie_anual.csv | Preços OMIE por ano, 2010–presente, com média por período do ciclo horário BTN. | 2 KB |
| omie_mensal.csv | Idem, por mês. | 22 KB |
| omie_diario.csv | Idem, por dia. | 712 KB |
| producao_anual.csv | Produção, consumo, quota renovável e saldo importador por ano. | 2 KB |
| producao_mensal.csv | Idem, por mês. | 24 KB |
| producao_diario.csv | Idem, por dia. | 672 KB |
| erc_resumo.json | Encargos de regulação (ERC) da REN: intervalos publicados, componentes e previsão própria a 14 dias com o erro medido. | 30 KB |
| erc_diario/AAAA.json | Por ano: totais por dia de mercado (MWh, € e € por componente) e, por dia em hora de Portugal, ERC, consumo e OMIE PT de cada hora, extremos, perdas e ERC por período horário BTN. | 170–260 KB/ano |
| erc_omie/AAAA-MM.json | Por mês, dia e quarto de hora: OMIE PT, ERC (real ou previsão própria) e fator de perdas (desde 2025). | ~50 KB/mês |
Cada linha traz dias (e quartos, no OMIE) com quantos entraram
no cálculo — é assim que se vê que o mês ou ano corrente ainda está incompleto.
Os dias futuros estimados a partir dos futuros OMIP estão excluídos.
🌱 Intensidade carbónica e preço do CO₂ — data/emissoes/
Emissões da produção elétrica nacional, calculadas a 15 minutos desde 2010 a partir de
data/producao/ (unidade: gCO₂eq/kWh), e o preço a que a UE
leiloa as licenças de emissão.
| Ficheiro | Conteúdo | Tamanho |
|---|---|---|
| intensidade_anual.csv | Por ano, 2010–presente. | 1 KB |
| intensidade_mensal.csv | Por mês. | 13 KB |
| intensidade_diaria.csv | Por dia. | 424 KB |
| intensidade_perfil_horario.csv | Média por hora do dia e por ano — quando é que a eletricidade é mais limpa. | 6 KB |
| fatores_emissao.csv | Os fatores usados (IPCC AR5, WG3 Annex III) e a sua proveniência. | 1 KB |
| eua_co2.csv | Leilões primários de licenças de CO₂ da UE (EU ETS), desde 2020: preço de fecho em €/tCO₂, volume, rácio de cobertura e a receita que cabe a Portugal. Fonte: EEX. | 176 KB |
Custo de transformar gás em eletricidade. Juntando o
eua_co2.csv ao mibgas_spot.csv e ao omie_diario.csv
fecha-se a conta: custo = gás ÷ rendimento + CO₂ × 0,2016 ÷ rendimento, onde 0,2016
tCO₂/MWh térmico é o valor por omissão do regulamento de monitorização da UE para gás natural.
Em 12/09/2026, um ciclo combinado a 55 % precisava de 179,40 €/MWh — e o OMIE fez média de 118,07.
Atenção: aqui é o fator de combustão, não os de ciclo de vida do
fatores_emissao.csv.
⚠️ Âmbito. São emissões de ciclo de vida (construção, fabrico, operação, desmantelamento), não emissões diretas de combustão: não são comparáveis com o Inventário Nacional da APA nem com o indicador da EEA. Cobrem a produção nacional, não o consumo — Portugal importou 25,5 % do consumo em 2024. E no perfil horário as horas de maior sol não são as mais limpas: em ciclo de vida o solar é cerca do dobro da hídrica.
🔤 Referência — data/referencia/
| Ficheiro | Conteúdo | Atualização |
|---|---|---|
| tecnologias.json | Traduz entre os três vocabulários de tecnologias de geração usados neste site (REN, Energy-Charts, ENTSO-E), com categoria, fator de emissão de ciclo de vida e notas de agregação. | Quando as fontes mudam |
As três fontes não partilham um único nome: a REN diz Hídrica,
o Energy-Charts hydro_run_of_river e o ENTSO-E Hydro Run-of-River.
O ficheiro sinaliza também que a Hídrica da REN agrega o que as
outras separam em três — fio de água, albufeira e turbinagem de bombagem — e que a
Outra Térmica junta fuelóleo, gasóleo, resíduos e biogás.
📋 Dados regulados (ERSE / E-Redes) — data/regulado/
| Ficheiro | Conteúdo | Atualização |
|---|---|---|
| perfis_erse_9.json | Perfis de consumo BTN publicados pela ERSE. | Anual |
| Perdas_calculadas_2026_TF.csv | Fatores de perdas (1+perdas) calculados para BT e MT, a partir dos perfis da E-Redes. | Anual |
| tos_municipios.json | Taxa de Ocupação do Subsolo por município + ORD/CUR de gás natural respetivo. | Quando há alterações |
⚠️ O Perdas_calculadas_2026_TF.csv está fora da convenção do resto do site:
separador ;, vírgula decimal, data no formato 1/jan/2026 e três linhas
decorativas antes do cabeçalho real.
Fontes, licença e citação
Os dados são recolhidos e processados a partir de fontes oficiais e públicas: OMIE, OMIP, MIBGAS, REN, ENTSO-E, Energy-Charts (Fraunhofer ISE), ERSE e E-Redes e IPCC AR5 (fatores de emissão). Os dados originais pertencem às respetivas entidades; este serviço disponibiliza compilações e séries derivadas, organizadas para consumo direto.
As compilações estão licenciadas sob CC BY 4.0 — pode copiar, redistribuir e adaptar, inclusive comercialmente, desde que dê crédito. Citação sugerida:
Dados: Tiago Felícia — www.tiagofelicia.pt (fontes originais: OMIE, REN, ENTSO-E, MIBGAS),
via dados.tiagofelicia.pt
Exceção — data/simuladores/: os comparativos de tarifários
de eletricidade e gás não estão abrangidos pela CC BY 4.0 e são reservados
(© Tiago Felícia, todos os direitos reservados). Ao contrário do resto do site, não são recolha
automática de uma fonte pública: resultam de pesquisa, verificação e agregação manual, oferta a
oferta. Estão acessíveis porque alimentam os simuladores de tiagofelicia.pt, não como dado aberto.
Para os reutilizar, contacte o autor.
Os dados são disponibilizados "tal como estão", sem garantias — podem existir falhas, atrasos ou correções retroativas nas fontes originais. Os nomes e caminhos dos ficheiros são estáveis; alterações serão anunciadas no repositório. O estado de atualização de cada dataset está em Estado dos dados.
Veja os dados em ação
Estes dados alimentam as ferramentas gratuitas de tiagofelicia.pt: simulador de tarifários de eletricidade, gás natural, autoconsumo solar, dashboard OMIE diário, balanço energético e mapas europeus.