API REST
Integre dados do setor elétrico diretamente na sua aplicação.
A API do CENTELHA fornece acesso programático a todos os dados da plataforma. Autenticação via token Bearer, respostas em JSON, paginação automática e filtros por subsistema, fonte e período.
Autenticação
Token Bearer via header Authorization. Solicite seu token na plataforma.
Formato
Respostas em JSON. Paginação com parâmetros page e per_page. Limite de 100 registros por requisição.
Rate Limit
60 requisições por minuto por token. Headers X-RateLimit indicam uso e limites.
Endpoints disponíveis
Todos os endpoints aceitam GET e retornam JSON com paginação.
| Endpoint | Método | Descrição |
|---|---|---|
| /v1/pld | GET | Preços PLD por subsistema e período |
| /v1/generation | GET | Geração por fonte e subsistema |
| /v1/reservoirs | GET | Níveis de reservatórios |
| /v1/plants | GET | Registro de usinas (SIGA) |
| /v1/dg | GET | Geração distribuída por município |
| /v1/tariffs | GET | Tarifas homologadas |
| /v1/concessions | GET | Concessionárias e indicadores |
| /v1/pld/summary | GET | Estatísticas agregadas de PLD |
Exemplo: consultar PLD atual
A resposta inclui o preço de liquidação das diferenças (PLD) e o custo marginal de operação (CMO) em R$/MWh. Filtre por subsistema (SE, S, NE, N) e período. A paginação retorna total de registros, página atual e registros por página.
Solicitar Token# Consultar PLD atual do Sudeste $ curl -H "Authorization: Bearer YOUR_TOKEN" \ https://api.centelha.tech/v1/pld?subsystem=SE { "data": [ { "subsystem": "SE", "date": "2026-03-14", "pld_brl_mwh": 187.42, "cmo_brl_mwh": 178.22, "source": "CCEE" } ], "total": 1, "page": 1, "per_page": 20 }
Exemplo: geração por fonte
Consulte a geração de energia elétrica por fonte (hídrica, térmica, eólica, solar e nuclear) em MW. Use o parâmetro per_page para controlar o número de registros retornados. Dados do ONS atualizados a cada hora.
# Geração por fonte $ curl -H "Authorization: Bearer YOUR_TOKEN" \ https://api.centelha.tech/v1/generation?per_page=1 { "data": [ { "timestamp": "2026-03-14T18:00:00Z", "hydro_mw": 42312, "thermal_mw": 18445, "wind_mw": 7823, "solar_mw": 2145, "nuclear_mw": 1990 } ], "total": 1 }