Desenvolvedores e varejistas

Dados abertos e integração para quem constrói no setor elétrico

A API de tarifas do QuantoGasta, o documento de referência sobre o Grupo B e o toolkit de integração com a CCEE. Tudo aqui é aberto, documentado e mantido por uma pessoa identificável.

Última atualização dos dados: 23/10/2026 · Licença dos dados: CC-BY-4.0

API de tarifas residenciais

Um arquivo CSV por estado com a tarifa residencial de cada distribuidora, o ICMS estadual e a bandeira tarifária vigente. Sem chave, sem cadastro.

Formas de URL

GET /api/tarifas/{estado}.csv com o slug do estado: sao-paulo, minas-gerais, distrito-federal.
GET /api/tarifas/{UF} com a sigla, em maiúsculas ou minúsculas: SP, mg. O sufixo .csv é opcional nas duas formas.

curl -L https://quantogasta.com.br/api/tarifas/sp.csv

Colunas

estado, uf: Nome e sigla do estado.
distribuidora, distribuidora_nome_completo: Nome curto e razão social da distribuidora.
tarifa_base_kwh: TUSD + TE homologadas pela ANEEL para o subgrupo B1 residencial, em R$/kWh, sem tributos.
tarifa_final_kwh: Estimativa com ICMS aplicado "por fora" e adicional de bandeira; não inclui PIS e COFINS. Veja o que é estimado.
icms_percent: Alíquota de ICMS sobre energia elétrica usada para o estado.
bandeira, adicional_bandeira_kwh: Bandeira tarifária vigente e seu adicional em R$/kWh.
municipios_atendidos, clientes_milhoes: Área de concessão da distribuidora.
ultima_atualizacao, fonte: Data da última importação (AAAA-MM-DD) e atribuição.

Resposta e limites

Content-Type: text/csv; charset=utf-8, separador vírgula, cabeçalho na primeira linha.
Access-Control-Allow-Origin: *: pode ser consumido direto do navegador.
Cache de uma hora no cliente e de um dia na CDN. Os dados mudam no máximo uma vez por semana; um download por estado por dia é mais do que suficiente.
Estado desconhecido responde 404 sem corpo.
Licença CC-BY-4.0. Atribuição: "QuantoGasta (quantogasta.com.br), a partir de dados da ANEEL".

Arquivos por estado

Acre (AC) CSV · página
Alagoas (AL) CSV · página
Amapá (AP) CSV · página
Amazonas (AM) CSV · página
Bahia (BA) CSV · página
Ceará (CE) CSV · página
Distrito Federal (DF) CSV · página
Espírito Santo (ES) CSV · página
Goiás (GO) CSV · página
Maranhão (MA) CSV · página
Mato Grosso (MT) CSV · página
Mato Grosso do Sul (MS) CSV · página
Minas Gerais (MG) CSV · página
Paraná (PR) CSV · página
Paraíba (PB) CSV · página
Pará (PA) CSV · página
Pernambuco (PE) CSV · página
Piauí (PI) CSV · página
Rio Grande do Norte (RN) CSV · página
Rio Grande do Sul (RS) CSV · página
Rio de Janeiro (RJ) CSV · página
Rondônia (RO) CSV · página
Roraima (RR) CSV · página
Santa Catarina (SC) CSV · página
Sergipe (SE) CSV · página
São Paulo (SP) CSV · página
Tocantins (TO) CSV · página

Dataset em JSON-LD

Cada página /tarifas/{estado} carrega um schema Dataset do schema.org com contentUrl apontando para o CSV correspondente, dateModified igual à data da última importação e licença declarada. É o que agregadores de dados e mecanismos de busca leem.

Documento de referência

O que o Grupo B exige da engenharia de uma varejista de energia Integrações com a CCEE, Open Energy, medição em escala, faturamento idempotente, reconciliação e o que a ANEEL ainda não definiu antes de 25/11/2027.

Toolkit de integração com a CCEE

Em preparação: biblioteca em Go, de código aberto, com cliente das APIs do modelo simplificado da CCEE, ingestão de medição, faturamento idempotente e reconciliação entre o faturado e o contabilizado. Será publicada em repositório público e linkada aqui.

Problemas e sugestões

Encontrou um valor errado ou precisa de um recorte que a API não oferece? Abra um issue em github.com/MarcoBuarque/quantogasta.