Os dados, diretamente da plataforma
A mesma camada que as próprias páginas do site leem. Sem chave, sem registo, JSON sobre HTTP. Cada resposta indica de que fonte veio, a que momento se refere e quão recente é.
O sistema elétrico, em tempo real
Consumo, produção por fonte e trocas transfronteiriças, tal como os operadores das redes de transporte os publicam. Aberto.
| Endereço | O que devolve | Frequência |
|---|---|---|
/api/v1/countries |
Todos os países da plataforma, com as suas zonas e o estado de cobertura. | Muda raramente — quando o registo muda. |
/api/v1/countries/:iso2/latest |
O retrato de um país: consumo, produção por fonte, saldo nas fronteiras. | Com a frequência com que o seu operador publica — de 10 segundos a uma hora. |
/api/v1/countries/:iso2/history |
Uma série temporal de um país, num intervalo escolhido. | A mesma frequência do retrato. |
/api/v1/europe/latest |
O total europeu e cada país que o compõe. | Um minuto. |
/api/v1/status |
O estado da recolha: que fonte publicou por último, e quando. | Contínua. |
/api/v1/licenses |
O que a plataforma pode fazer com os dados de cada fonte. | Quando mudam os termos de uma fonte. |
/api/v1/search |
Pesquisa em países, zonas e termos. | Contínua. |
O mercado diário
Os preços leiloados para o dia seguinte, por zona de oferta. Fechado por agora — o motivo é explicado abaixo.
| Endereço | O que devolve | Frequência |
|---|---|---|
/api/v1/prices/latest451 · licença |
O último preço conhecido de cada zona. | Uma vez por dia, depois do leilão. |
/api/v1/prices/zones451 · licença |
As zonas de oferta, com o fuso horário e a moeda de cada uma. | Muda raramente. |
/api/v1/prices/date451 · licença |
Todas as zonas, para um dia de entrega escolhido. | Diária. |
/api/v1/prices/country/:iso2451 · licença |
Os preços de um país, para cada uma das suas zonas. | Diária. |
/api/v1/prices/:zone/history451 · licença |
O histórico de uma zona, intervalo a intervalo. | Diária. |
/api/v1/prices/:zone/summary451 · licença |
Média, mínimo, máximo e quantis por dia, semana ou mês. | Diária. |
/api/v1/market/cheapest451 · licença |
As zonas com o preço médio do dia mais baixo. | Diária. |
/api/v1/market/expensive451 · licença |
As zonas com o preço médio do dia mais alto. | Diária. |
/api/v1/market/spreads451 · licença |
A diferença entre a hora mais barata e a mais cara, por zona. | Diária. |
/api/v1/market/cheapest-window451 · licença |
A janela contínua de N horas mais barata numa zona. | Diária. |
/api/v1/market/weekly451 · licença |
O relatório semanal, depois de a semana fechar. | Semanal. |
Porque é que as rotas de preços respondem com 451
Os dados de mercado vêm da plataforma de transparência da ENTSO-E. Recolhemo-los e mostramo-los no site com a fonte indicada ao lado de cada valor, mas redistribuí-los através de uma API não é o mesmo que mostrá-los, e os termos de reutilização ainda não foram verificados nem registados por nós.
Até lá, as rotas de preços devolvem 451 — o código para «indisponível por motivos legais» — em vez de entregarem discretamente algo que não temos direito a entregar. O sistema de licenças funciona por fonte, não por país, pelo que abri-las não exige nenhuma alteração ao código.
Regras de boa conduta
Não há limite de pedidos, e gostaríamos que não fosse preciso haver. As respostas trazem cache-control: respeitando-o, obtêm-se exatamente os mesmos valores sem pedir duas vezes. Os dados em tempo real não mudam mais depressa do que o seu operador publica — um pedido por segundo para um país que publica de hora a hora não traz nada de novo.
Em caso de utilização pública dos dados, cite a fonte original (o operador da rede de transporte ou a ENTSO-E), não o nosso nome: nós transportamo-los, não os produzimos.
Ver também: Fontes de dados · Metodologia · Estado do sistema · llms.txt