API

Los datos, directamente de la plataforma

La misma capa que leen las propias páginas del sitio. Sin clave, sin registro, JSON sobre HTTP. Cada respuesta indica de qué fuente procede, a qué momento se refiere y cuán reciente es.

El sistema eléctrico, en tiempo real

Demanda, generación por fuente e intercambios transfronterizos, tal como los publican los gestores de la red de transporte. Abierto.

Dirección Qué devuelve Frecuencia
/api/v1/countries Todos los países de la plataforma, con sus zonas y su estado de cobertura. Cambia rara vez — cuando cambia el registro.
/api/v1/countries/:iso2/latest La instantánea de un país: demanda, generación por fuente, saldo en las fronteras. Tan a menudo como publique su operador — de 10 segundos a una hora.
/api/v1/countries/:iso2/history Una serie temporal de un país, en un intervalo elegido. La misma frecuencia que la instantánea.
/api/v1/europe/latest El total europeo y cada país que entra en él. Un minuto.
/api/v1/status El estado de la recogida: qué fuente publicó por última vez, y cuándo. Continua.
/api/v1/licenses Lo que la plataforma puede hacer con los datos de cada fuente. Cuando cambian las condiciones de una fuente.
/api/v1/search Búsqueda en países, zonas y términos. Continua.

El mercado diario

Los precios subastados para el día siguiente, por zona de oferta. Cerrado por ahora — vea más abajo por qué.

Dirección Qué devuelve Frecuencia
/api/v1/prices/latest451 · licencia El último precio conocido de cada zona. Una vez al día, después de la subasta.
/api/v1/prices/zones451 · licencia Las zonas de oferta, con el huso horario y la moneda de cada una. Cambia rara vez.
/api/v1/prices/date451 · licencia Todas las zonas, para un día de entrega elegido. Diaria.
/api/v1/prices/country/:iso2451 · licencia Los precios de un país, para cada una de sus zonas. Diaria.
/api/v1/prices/:zone/history451 · licencia El historial de una zona, intervalo a intervalo. Diaria.
/api/v1/prices/:zone/summary451 · licencia Media, mínimo, máximo y cuantiles por día, semana o mes. Diaria.
/api/v1/market/cheapest451 · licencia Las zonas con el precio medio más bajo del día. Diaria.
/api/v1/market/expensive451 · licencia Las zonas con el precio medio más alto del día. Diaria.
/api/v1/market/spreads451 · licencia La diferencia entre la hora más barata y la más cara, por zona. Diaria.
/api/v1/market/cheapest-window451 · licencia La ventana continua de N horas más barata en una zona. Diaria.
/api/v1/market/weekly451 · licencia El informe semanal, una vez cerrada la semana. Semanal.

Por qué las rutas de precios responden con 451

Los datos de mercado proceden de la Plataforma de Transparencia de ENTSO-E. Los recogemos y los mostramos en el sitio con la fuente escrita junto a cada cifra, pero redistribuirlos a través de una API no es lo mismo que mostrarlos, y todavía no hemos verificado ni registrado las condiciones de reutilización.

Hasta entonces, las rutas de precios devuelven 451 — el código de «no disponible por razones legales» — en lugar de entregar discretamente algo que no tenemos derecho a entregar. El sistema de licencias funciona por fuente, no por país, así que abrirlas no requiere ningún cambio de código.

Normas de buena conducta

No hay límite de peticiones, y nos gustaría que no hiciera falta ninguno. Las respuestas llevan cache-control: respételo y obtendrá exactamente las mismas cifras sin preguntar dos veces. Los datos en tiempo real no cambian más a menudo de lo que publica su operador — una petición por segundo para un país que publica cada hora no aporta nada nuevo.

Si utiliza los datos públicamente, cite la fuente original (el gestor de la red de transporte o ENTSO-E), no nuestro nombre: nosotros los transportamos, no los producimos.

Véase también: Fuentes de datos · Metodología · Estado del sistema · llms.txt