Ferramenta
API de dados e downloads: as bases dos painéis direto no seu BI, planilha ou modelo
Em uma frase: A API de dados é um jeito de puxar automaticamente, para o seu sistema ou planilha, as mesmas tabelas de dados que desenham os painéis.
Cada painel é alimentado por tabelas tratadas a partir das fontes. A maior parte vem de dados abertos de órgãos públicos: CCEE (Câmara de Comercialização de Energia Elétrica), ONS (Operador Nacional do Sistema Elétrico) e ANEEL (Agência Nacional de Energia Elétrica). Completam a lista a EPE (Empresa de Pesquisa Energética) e a CVM (Comissão de Valores Mobiliários).
Alguns datasets vêm de fontes que não são abertas. São os índices da curva forward da Dcide, o ranking anual Melhores e Maiores da Exame, os números da ABSOLAR e da ABEEólica e anúncios colhidos na imprensa. Esses dados seguem com os direitos de quem os publicou: servem para uso interno da sua empresa, nunca para repassar a terceiros. Cada resposta da API traz a fonte e a licença do dataset.
São dois caminhos. Pela API, um programa seu chama o endereço com uma chave e recebe as linhas em JSON ou CSV, com filtro por data e paginação. Pela página "API de dados e downloads", você baixa o dataset inteiro em CSV com um clique.
Todos os painéis e ferramentas por 3 dias para avaliar, sem cartão.
Perguntas que esta ferramenta responde
- Consigo levar os dados para o Excel ou o Power BI sem copiar e colar?
- Sim, e a atualização passa a ser um clique: no Excel ou no Power BI, use "Obter dados da Web" com o endereço do dataset e a chave no cabeçalho. A página da ferramenta traz o passo a passo, além de exemplos prontos em curl e Python.
- Que dados a API entrega?
- Você acessa as mesmas tabelas dos painéis: PLD (Preço de Liquidação das Diferenças) diário e horário, carga, reservatórios, curtailment por usina, tarifas, mercado cativo, leilões, transmissão, multas, alavancagem, resultados da CVM e outras. A lista completa, com colunas, fonte, licença e última atualização, sai do endereço /api/v1/datasets.
- Como funciona o acesso e quais são os limites?
- Você cria até 10 chaves na própria página, uma para cada sistema, e revoga qualquer uma na hora. Cada chave faz até 60 requisições por minuto e 1.000 por dia; cada página traz até 10.000 linhas, e o filtro desde/até recorta pela data.
- Em que formato vêm os dados?
- Você escolhe o que o seu programa lê melhor: JSON (padrão), CSV com vírgula e ponto decimal, ou csv-br, com ponto e vírgula e vírgula decimal, que abre direto no Excel em português. Datas em AAAA-MM-DD e números como números.
Na prática
Uma comercializadora alimenta o modelo de risco todo dia
A área de risco de uma comercializadora mantinha uma planilha atualizada à mão com o PLD e os reservatórios. Com uma chave da API, o analista agenda um script em Python que baixa os datasets toda manhã e grava no banco interno. O modelo de exposição roda com o dado do dia, e a equipe passa a discutir a posição, não a coleta.
O que você vê na ferramenta
Catálogo de datasets
Cada tabela com descrição, colunas, painéis de origem e atualização.
Download completo
O dataset inteiro em CSV padrão ou csv-br, com a atribuição no fim.
Suas chaves
Crie, nomeie e revogue chaves, com o uso diário dos últimos 30 dias.
Documentação e exemplos
Parâmetros, erros e exemplos em curl, Python e Excel/Power BI.
Para quem serve
Comercializadora ou varejista
Alimentar modelos de preço e de risco com dado tratado, sem robô de coleta próprio.
Banco, fundo ou investidor
Levar séries do setor para o BI, o modelo de crédito ou o painel interno.
Consultoria, gestora de energia ou escritório
Ter as bases completas para estudos internos, com fonte e licença anotadas em cada dataset.
Geradora ou desenvolvedora de projetos
Cruzar dados públicos com a sua operação no seu próprio sistema.
Ficha técnica
- Fontes oficiais
CCEE — Câmara de Comercialização de Energia Elétrica, dados abertos · licença CC-BY 4.0
ONS — Operador Nacional do Sistema Elétrico, dados abertos · licença CC-BY 4.0
ANEEL — Agência Nacional de Energia Elétrica, dados abertos · licença ODbL 1.0
EPE — Empresa de Pesquisa Energética (publicações e dados abertos) · licença Reprodução permitida com citação da fonte
- Outras fontes
Dcide — índices semanais da curva forward (divulgados no site da Dcide; não são dados abertos) · licença Direitos do titular · fonte citada
Exame — Melhores e Maiores · licença Direitos do titular · fonte citada
ABSOLAR — Associação Brasileira de Energia Solar Fotovoltaica · licença Direitos do titular · fonte citada
ABEEólica — Associação Brasileira de Energia Eólica · licença Direitos do titular · fonte citada
Notícias da imprensa (link em cada linha) · licença Direitos do titular · fonte citada
Não são dados abertos: esta página cita a fonte, mas não reproduz os números dela.
- Atualização
- Cada dataset é atualizado no ritmo do painel de origem (diário, semanal ou mensal); o catálogo informa a última atualização de cada um.
- Janelas
- O histórico completo de cada tabela: a API pagina e filtra por data; o download traz a tabela inteira.
- O que você configura
- Dataset · Formato (json, csv, csv-br) · Período (desde/até) · Linhas por página e página
Dados tratados pelo EnergiaWATT a partir das fontes acima; o ferramenta explica os cálculos nas notas de cada tela.
Em qual plano
Essencial
Mostra o catálogo e a documentação. Download dos datasets e API não incluídos.
Profissional
Mostra o catálogo e a documentação. Download dos datasets completos e API não incluídos.
Corporativo + API
Incluídos: API com até 10 chaves (1.000 requisições por dia por chave) e download dos datasets completos.
No período de apresentação (3 dias), a ferramenta fica aberta como na assinatura, sem download e sem API.
Termos do glossário
- PLD — Preço de Liquidação das Diferenças
- EAR — Energia Armazenada
- Curtailment — corte de geração (constrained-off)
- MWmed — megawatt médio
Indicadores relacionados
Veja com os seus próprios filtros
Peça a apresentação: o acesso chega por e-mail e você usa todos os painéis e ferramentas por 3 dias, sem cartão. A equipe acompanha você.