Coordinador Eléctrico Chile – Costo Marginal y Generación

ES · Datos del Sistema Eléctrico Nacional de Chile, normalizados para agentes de IA y desarrolladores: costos marginales por barra, generación real por central, demanda, catálogo de centrales y líneas, limitaciones y energía no suministrada. Se obtienen de la API oficial SIP (Sistema de Información Pública) del Coordinador Eléctrico Nacional usando tu propia API Key. EN · Chile's national grid data — locational marginal prices per bus, real generation per plant, demand, plant and line catalogs, outages — normalized for AI agents and developers, from the official Coordinador Eléctrico Nacional SIP API, using your own API key.

⚠️ Se requiere API Key propia / Your own API key is required. Es gratuita y se activa al instante: regístrate en https://portal.api.coordinador.cl, elige el plan «Sistema de Información Pública», confirma tu correo y copia la Credencial desde Aplicaciones. Este Actor no incluye, comparte ni revende claves: cada ejecución usa la tuya.

⚠️ No afiliado / Not affiliated. Proyecto independiente. No está afiliado, patrocinado ni aprobado por el Coordinador Eléctrico Nacional (CEN). El nombre se usa solo para describir la fuente de los datos.

Fuente / Data source: Coordinador Eléctrico Nacional, Sistema de Información Pública (https://www.coordinador.cl). Cada registro incluye dataSource con esta atribución.

Uso con agentes de IA (MCP)

Agrega el Actor como herramienta MCP en Claude, Cursor, ChatGPT u otro cliente compatible:

https://mcp.apify.com/?tools=better-llama/coordinador-electrico-chile

Ejemplos de preguntas: «¿Cuál fue el costo marginal en la barra Crucero 220 ayer a las 15:00?», «¿Cuánta energía solar se generó el lunes?», «¿Qué instalaciones tuvieron limitaciones esta semana?».

Conjuntos de datos / Datasets

dataset	Ruta oficial	Qué entrega	Unidad
costo_marginal_online	/costo-marginal-online/v4/findByDate	CMg preliminar por barra, cada 15 min	USD/MWh (+ CLP/kWh)
costo_marginal_real	/costo-marginal-real/v4/findByDate	CMg definitivo por barra (se publica con semanas de desfase)	USD/MWh (+ CLP/kWh)
generacion_real	/generacion-real/v3/findByDate	Generación horaria por central, tecnología y propietario	MW
generacion_diaria	/generacion-real/v3/getDailySum	Total diario por tecnología (solar, eólica, hidráulica, térmica…)	MWh
demanda_neta	/demanda-neta/v4/findByDate	Demanda neta, generación bruta y ERV por hora	MWh
demanda_real_estimada	/demanda-real-estimada/v4/findByDate	Retiros estimados por barra y suministrador	kWh
centrales	/centrales/v4/findByDate	Catálogo de centrales (tecnología, potencia, región, comuna)	MW
lineas_transmision	/lineas-transmision/v4/findByDate	Catálogo de líneas	—
limitaciones_transmision	/limitaciones-transmision/v4/findByDate	Limitaciones y perturbaciones con retorno estimado	MW
instrucciones_sscc	/instrucciones-operacionales-sscc/v4/findByDate	Instrucciones de servicios complementarios	MW
energia_no_suministrada	/energia-no-suministrada/v4/findByDate	ENS por interrupción, comunas y empresa afectada	MWh

• Fechas: startDate / endDate en AAAA-MM-DD (hora de Chile), máximo 31 días por ejecución. Por defecto, ayer.
• Filtro: la API no filtra por barra; usa filter (p. ej. "crucero") y el Actor descarta el resto antes de entregar. Solo se cobra lo entregado.
• Volumen: un día de costo marginal son ~145.000 filas (≈1.500 barras × 96 cuartos de hora). Usa filter y maxItems.
• Horas: localDateTime es la hora de Chile tal como la publica el CEN; dateTimeUtc es el mismo instante en UTC.

Comportamiento

• Paginación automática (page desde 1, limit/pageSize hasta 5000) con tope maxPages.
• Pausa de 1 s entre solicitudes y reintentos con espera exponencial y jitter ante 429 (el gateway limita ráfagas), 5xx y errores de red.
• Errores claros: API Key ausente o inválida (HTTP 403 «Authentication failed / parameters missing»), rango sin datos (run vacío con advertencia, no un fallo).
• Deduplicación si la ejecución se reanuda. La API Key se marca como secreto (cifrada por Apify) y nunca se escribe en logs.
• Privacidad (Ley 19.628 / 21.719): se eliminan RUT, correos y direcciones de contacto (p. ej. en demanda real estimada) y se ocultan nombres que podrían ser de personas naturales (clientes afectados en ENS y propietarios de pequeños medios de generación sin marca de persona jurídica), también en raw. Cada registro trae redacted y personType.

Precio / Pricing

Pago por resultado (pay per event): solo se cobra el evento result por cada registro entregado en el dataset. No se cobran páginas filtradas, duplicados ni errores. Puedes fijar un gasto máximo por ejecución; el Actor se detiene al alcanzarlo.

Input

Costo marginal de una barra ayer:

{
  "apiKey": "TU-CREDENCIAL",
  "dataset": "costo_marginal_online",
  "filter": "crucero 220",
  "maxItems": 200
}

Generación diaria por tecnología de una semana:

{
  "apiKey": "TU-CREDENCIAL",
  "dataset": "generacion_diaria",
  "startDate": "2026-11-01",
  "endDate": "2026-11-07"
}

Centrales solares de una región:

{
  "apiKey": "TU-CREDENCIAL",
  "dataset": "centrales",
  "filter": "solar",
  "maxItems": 2000
}

Output (diccionario / data dictionary)

Campo	ES	EN
dataset, datasetTitle	Conjunto consultado	Dataset
date, localDateTime, dateTimeUtc, hour	Fecha y hora (Chile y UTC)	Date and time
name, code	Barra / central / línea / instalación e identificador estable	Entity name and id
value, unit	Valor principal y unidad	Main value and unit
costClpKwh, voltageKv, version	CMg en CLP/kWh, tensión de la barra, versión	Marginal cost extras
technology, subTechnology, owner, coordinado, maxPowerMw, erncMw, region, comuna, status	Generación y centrales	Generation and plants
grossGenerationMwh, variableRenewableMwh, ownConsumptionMwh, ownConsumptionPct, supplier, withdrawal	Demanda	Demand
type, instruction, startTime, endTime, reason, expectedReturn, actualReturn, observation, affectedCompany, clientName	Operación, limitaciones y ENS	Operations and outages
redacted, personType	Privacidad	Privacy flags
officialUrl, dataSource, retrievedAt, raw	Atribución, fecha de consulta y fila original	Attribution and raw row

Limitaciones conocidas

• El costo marginal real (definitivo) se publica con semanas de desfase; para días recientes usa costo_marginal_online.
• El histórico disponible en la API no es ilimitado (en pruebas públicas de 2026, fechas de 2025 respondían y fechas de 2022 no).
• El catálogo de rutas sigue la documentación del Coordinador (guía SIP v2.0, 2023) y el swagger del portal; si el Coordinador cambia una versión de ruta, el Actor lo reporta como error 404 claro.

English summary

Official Chilean grid data (Coordinador Eléctrico Nacional SIP API) as clean JSON: marginal costs per bus (USD/MWh and CLP/kWh), real generation, daily generation by technology, demand, plant/line catalogs, transmission limitations, ancillary-service instructions and unserved energy. Bring your own free key from https://portal.api.coordinador.cl. Pay only per delivered result. Not affiliated with the Coordinador Eléctrico Nacional.

Más conectores de Chile / More Chilean data connectors

Este Actor es parte de Better Llama, una colección de conectores de datos públicos y empresariales de Chile (licitaciones, UF y dólar, energía, bencina, envíos, bolsa y más) con JSON limpio y pago por resultado. Catálogo completo: https://betterllama.com.

Part of Better Llama, a collection of Chilean data connectors for developers and AI agents. Full catalog: https://betterllama.com/en/.