Todo lo que la página muestra, para usarlo fuera de ella.

Cinco documentos JSON con el estado del día y los modelos, y cada tabla completa en CSV. Sin clave, sin límite y con CORS abierto: se pueden pedir desde cualquier sitio web. Cada número es una copia de lo que publicaron CELEC, CENACE, XM, Open-Meteo o la NOAA; cítelos a ellos y a este proyecto.

Lo que se promete

schema_version (1 hoy) es la versión del formato, no de un modelo. Solo cambia cuando se quita, se renombra o cambia de tipo un campo. Añadir un campo no la cambia: un lector debe ignorar los campos que no conoce.
Cada documento se valida en cada cambio contra su esquema JSON; un cambio de forma es una prueba que falla antes de ser un lector roto.
data_date es la misma fecha en todos: el día de Ecuador que describen las lecturas del documento. En los modelos es igual a origin_date, el día sobre el que se paran.
Los códigos son palabras en inglés estables (ords_levels, report_endpoint, watch); junto a cada uno va su etiqueta en español (label_es, declaration_es, tier_label_es).
Un campo que se va a quitar se anuncia en el bloque deprecated del documento y se mantiene una versión. Hoy: as_of en latest.json y status.json (use data_date) y feeds[].feed en status.json (use id y label_es). El campo tier de la suficiencia conserva la palabra del modelo; el código estable es tier_code.
Lo que no se promete: que un modelo no cambie. Cada documento dice qué modelo y qué versión lo produjo.

Cuándo cambian

El trabajo diario está programado a las 12:47 UTC (07:47 en Ecuador), 16:53 UTC (11:53 en Ecuador), 20:47 UTC (15:47 en Ecuador) y 00:47 UTC (19:47 en Ecuador). GitHub suele empezarlo con retraso, a veces de horas, así que la hora real de cada documento es su generated_at. Las cotas de CELEC llegan la mañana siguiente al día que describen, y el balance de CENACE cierra el día anterior hacia las 11:15 de Ecuador, así que data_date suele ser ayer. La lectura del día se genera después de los modelos y puede quedarse un día atrás; lo dice su propia fecha.

Los documentos se sirven con Access-Control-Allow-Origin: * y una caché de cinco minutos. La última comprobación, del 19 oct 2026, vio 12 de 12 fuentes al día.

Licencia: código MIT. Datos: CELEC EP (servicios web públicos de una empresa del Estado; no declaran licencia); CENACE (servicios web públicos del operador del sistema; no declaran licencia); XM S.A. E.S.P. (portal de datos públicos del operador del mercado colombiano); Open-Meteo (ERA5 and forecast models) (CC BY 4.0 (https://open-meteo.com/en/terms); la API gratuita es para uso no comercial); GEOGLOWS Hydrologic Model v2 (ECMWF, BYU; shown in Ecuador by the INAMHI–GEOGLOWS portal) (CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/; https://geoglows-v2.s3-us-west-2.amazonaws.com/licenses.md). Modificado aquí: el miembro de alta resolución del pronóstico se promedia por día y se corrige con el caudal medido por CELEC, y los máximos anuales de la simulación desde 1980 se ajustan a una distribución de Gumbel); GEOGLOWS v2 retrospective return periods (Riley Chad Hales; revision 4 of 2026-06-10) (CC BY-NC-SA 4.0 (https://creativecommons.org/licenses/by-nc-sa/4.0/), la licencia de este almacén solamente: citarlo, sin uso comercial, compartir igual); European Centre for Medium-Range Weather Forecasts (ECMWF) (Copyright "© 2023 European Centre for Medium-Range Weather Forecasts (ECMWF)". Fuente: www.ecmwf.int. Licencia: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). El ECMWF no acepta responsabilidad alguna por errores u omisiones en los datos, su disponibilidad, ni por pérdidas o daños derivados de su uso); NOAA PSL / CPC (obra del Gobierno de EE. UU., dominio público).

Los documentos

/api/latest.json

esquema · lo escribe scripts/publish.ts

El estado del día: la cota, las bandas, las pendientes y el caudal de cada embalse, el balance nacional del último día cerrado, el cambio desde ayer de cada uno, y el nivel de suficiencia copiado de adequacy.json.

Los 117 campos

Campos de latest.json, con su tipo y su unidad
Campo	Tipo	Unidad	Siempre	Descripción (del esquema)
`schema_version`	integer		sí	The format version. Changes only when a field is removed, renamed or retyped; added fields do not change it.
`generated_at`	string		sí	When the document was written, UTC.
`data_date`	string \| null		sí	The Ecuadorian calendar day the document's readings describe.
`as_of`	string		sí	Deprecated. Deprecated: the day the job ran. Use data_date. Removed in schema_version 2.
`disclaimer`	string		sí
`reservoirs`	lista		sí
`reservoirs[].site`	string		sí
`reservoirs[].label`	string		sí
`reservoirs[].basin`	string		sí
`reservoirs[].level`	objeto \| null		sí
`reservoirs[].level.masl`	number	m s. n. m.	sí
`reservoirs[].level.date`	string		sí
`reservoirs[].level.first_reading`	string		sí
`reservoirs[].level.days`	integer	días	sí
`reservoirs[].level.observed_min_masl`	number	m s. n. m.	sí
`reservoirs[].level.observed_max_masl`	number	m s. n. m.	sí
`reservoirs[].level.previous`	objeto \| null		sí
`reservoirs[].level.previous.masl`	number	m s. n. m.	sí
`reservoirs[].level.previous.date`	string		sí
`reservoirs[].level.delta_1d_m`	number \| null	m	sí
`reservoirs[].bands`	lista		sí
`reservoirs[].bands[].min_masl`	number	m s. n. m.	sí
`reservoirs[].bands[].max_masl`	number	m s. n. m.	sí
`reservoirs[].bands[].declaration`	string: "report_endpoint", "dashboard_chart_title", "operational_minimum"		sí	How CELEC declared the band, as a code.
`reservoirs[].bands[].declaration_es`	string		sí
`reservoirs[].bands[].source`	string		sí
`reservoirs[].bands[].observed_from`	string		sí
`reservoirs[].bands[].observed_to`	string		sí
`reservoirs[].bands[].band_pct`	number \| null	%	sí	(level - min) / (max - min) * 100. A position in the band, not stored water.
`reservoirs[].bands[].metres_above_min`	number \| null		sí
`reservoirs[].slopes_m_per_day`	objeto	m/día	sí
`reservoirs[].slopes_m_per_day.d7`	number \| null	m/día	sí
`reservoirs[].slopes_m_per_day.d14`	number \| null	m/día	sí
`reservoirs[].slopes_m_per_day.d30`	number \| null	m/día	sí
`reservoirs[].inflow`	objeto \| null		sí
`reservoirs[].inflow.m3s`	number	m³/s	sí
`reservoirs[].inflow.date`	string		sí
`reservoirs[].inflow.first_reading`	string		sí
`reservoirs[].inflow.days`	integer	días	sí
`reservoirs[].inflow.climatology`	objeto \| null		sí
`reservoirs[].inflow.climatology.p10`	number		sí
`reservoirs[].inflow.climatology.p50`	number		sí
`reservoirs[].inflow.climatology.p90`	number		sí
`reservoirs[].inflow.climatology.years`	integer		sí
`reservoirs[].inflow.climatology.n`	integer		sí
`reservoirs[].inflow.climatology.percentile_today`	number \| null		sí
`reservoirs[].inflow.previous`	objeto \| null		sí
`reservoirs[].inflow.previous.m3s`	number	m³/s	sí
`reservoirs[].inflow.previous.date`	string		sí
`reservoirs[].inflow.delta_1d_m3s`	number \| null	m³/s	sí
`reservoirs[].inflow.return_periods`	objeto		sí	Today's inflow against the floods this river is known for, from two sources kept apart because they disagree: GEOGLOWS v2 (the model behind INAMHI's portal, inamhi.geoglows.org) and the same statistic fitted on CELEC's record. data/reports/return-periods.md compares them.
`reservoirs[].inflow.return_periods.geoglows`	objeto \| null		sí	The return periods INAMHI's Hydroviewer (inamhi.geoglows.org) draws for the GEOGLOWS v2 river matched to this dam, beside the GEOGLOWS store's own fits (data/reference/geoglows_return_periods.csv). Null where no river matched or `npm run geoglows` has not run. `inamhi` and `simulated_vs_measured` are computed here from GEOGLOWS' daily simulation (CC BY 4.0, attribution `geoglows`); `daily` and `hourly` are copied from its return-period store (CC BY-NC-SA 4.0, attribution `geoglows_return_periods`).
`reservoirs[].inflow.return_periods.measured`	objeto \| null		sí	The same Gumbel fit on the annual maxima of CELEC's daily inflow, over calendar years with at least 330 readings. Null with fewer than five such years.
`national`	objeto \| null		sí
`national.date`	string		sí
`national.supply_gwh`	lista	GWh	sí
`national.supply_gwh[].concept`	string		sí
`national.supply_gwh[].gwh`	number	GWh	sí
`national.supply_gwh[].pct`	number	%	sí
`national.total_generation_gwh`	number \| null	GWh	sí
`national.total_import_gwh`	number \| null	GWh	sí
`national.total_export_gwh`	number \| null	GWh	sí
`national.distribution_demand_gwh`	number \| null	GWh	sí
`national.transport_losses_gwh`	number \| null	GWh	sí
`national.hydro_share_pct`	number \| null	%	sí
`national.thermal_share_pct`	number \| null	%	sí
`national.import_share_pct`	number \| null	%	sí
`national.previous`	objeto \| null		sí
`national.previous.date`	string		sí
`national.previous.total_generation_gwh`	number \| null	GWh	sí
`national.previous.total_import_gwh`	number \| null	GWh	sí
`national.previous.hydro_share_pct`	number \| null	%	sí
`national.previous.thermal_share_pct`	number \| null	%	sí
`national.previous.import_share_pct`	number \| null	%	sí
`national.delta_1d`	objeto \| null		sí
`national.delta_1d.hydro_share_pct_points`	number \| null	puntos porcentuales	sí
`national.delta_1d.thermal_share_pct_points`	number \| null	puntos porcentuales	sí
`national.delta_1d.import_share_pct_points`	number \| null	puntos porcentuales	sí
`national.delta_1d.total_generation_gwh`	number \| null	GWh	sí
`live`	objeto \| null		sí	Today so far: CENACE Información Operativa's running total since local midnight (preliminary SCADA), newer than national and partial. Totals are not comparable with a closed day; shares are over production plus imports, as in national. Null when no real-time reading has been stored.
`live.date`	string		sí	The Ecuadorian calendar day the running total covers.
`live.fetched_at`	string		sí	When CENACE's page was read, UTC; the total covers local midnight up to about this instant.
`live.total_production_gwh`	number \| null	GWh	sí
`live.hydro_gwh`	number \| null	GWh	sí
`live.thermal_gwh`	number \| null	GWh	sí
`live.nonconventional_gwh`	number \| null	GWh	sí
`live.import_gwh`	number \| null	GWh	sí
`live.export_gwh`	number \| null	GWh	sí
`live.hydro_share_pct`	number \| null	%	sí
`live.thermal_share_pct`	number \| null	%	sí
`live.import_share_pct`	number \| null	%	sí
`adequacy`	objeto \| null		sí
`adequacy.origin_date`	string		sí
`adequacy.tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí	The model's Spanish word. Kept in schema_version 1; use the *_code field beside it.
`adequacy.tier_code`	string: "comfortable", "watch", "tight", "deficit"		sí
`adequacy.tier_label_es`	string		sí
`adequacy.worst_tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí	The model's Spanish word. Kept in schema_version 1; use the *_code field beside it.
`adequacy.worst_tier_code`	string: "comfortable", "watch", "tight", "deficit"		sí
`adequacy.worst_tier_label_es`	string		sí
`adequacy.worst_tier_horizon_days`	integer	días	sí
`adequacy.narrative_tier_field`	string		sí	The tier the daily narrative is written about.
`adequacy.worst_deficit_gwh_day`	number	GWh/día	sí
`adequacy.run_id`	string		sí
`deprecated`	objeto		no	Fields kept for one more schema version, each with what replaces it.
`license`	objeto		sí
`license.code`	string		sí
`license.code_url`	string		sí
`license.data`	string		sí
`license.data_es`	string		sí
`attribution`	lista		sí
`attribution[].id`	string		sí
`attribution[].name`	string		sí
`attribution[].provides`	string		sí
`attribution[].url`	string		sí
`attribution[].terms`	string		sí
`attribution[].terms_es`	string		sí
`see_also`	objeto		sí	Absolute URLs to the other documents, this document's schema and the documentation page.

/api/status.json

esquema · lo escribe scripts/check.ts

Si cada fuente sigue llegando: la última fecha de cada una frente a su límite, el tamaño de cada tabla y los avisos abiertos de las comprobaciones.

Los 33 campos

Campos de status.json, con su tipo y su unidad
Campo	Tipo	Unidad	Siempre	Descripción (del esquema)
`schema_version`	integer		sí	The format version. Changes only when a field is removed, renamed or retyped; added fields do not change it.
`generated_at`	string		sí	When the document was written, UTC.
`data_date`	string \| null		sí	The Ecuadorian calendar day the document's readings describe.
`as_of`	string		sí	Deprecated. Deprecated: the day the check ran. Use data_date. Removed in schema_version 2.
`ok`	boolean		sí
`status`	string: "pass", "info", "warn", "fail"		sí
`feeds`	lista		sí
`feeds[].id`	string		sí
`feeds[].label_es`	string		sí
`feeds[].feed`	string		sí	Deprecated. Deprecated English label. Use id and label_es.
`feeds[].latest`	string \| null		sí
`feeds[].limit_days`	integer	días	sí
`feeds[].state`	string: "current", "stale", "not_ingested"		sí
`tables`	objeto		sí
`findings`	lista		sí
`findings[].check`	string		sí
`findings[].level`	string: "info", "warn", "fail"		sí
`findings[].message`	string		sí
`counts`	objeto		no
`deprecated`	objeto		no	Fields kept for one more schema version, each with what replaces it.
`license`	objeto		sí
`license.code`	string		sí
`license.code_url`	string		sí
`license.data`	string		sí
`license.data_es`	string		sí
`attribution`	lista		sí
`attribution[].id`	string		sí
`attribution[].name`	string		sí
`attribution[].provides`	string		sí
`attribution[].url`	string		sí
`attribution[].terms`	string		sí
`attribution[].terms_es`	string		sí
`see_also`	objeto		sí	Absolute URLs to the other documents, this document's schema and the documentation page.

/api/forecast.json

esquema · lo escribe scripts/forecast.ts

La cota de Mazar a 7, 14, 30, 60 y 90 días como p10/p50/p90, los días hasta cada umbral bajo años análogos, y la validación que la puntúa.

Los 152 campos

Campos de forecast.json, con su tipo y su unidad
Campo	Tipo	Unidad	Siempre	Descripción (del esquema)
`schema_version`	integer		sí	The format version. Changes only when a field is removed, renamed or retyped; added fields do not change it.
`generated_at`	string		sí	When the document was written, UTC.
`data_date`	string \| null		sí	The Ecuadorian calendar day the document's readings describe.
`run_id`	string		sí
`origin_date`	string		sí	The day the forecast stands on; equal to data_date.
`site`	string		sí
`variable`	string		no
`units`	string		no
`disclaimer`	string		sí
`model`	objeto		sí
`model.id`	string		sí
`model.label`	string		sí
`model.version`	string		sí
`model.backtest_origins`	integer		sí
`current`	objeto		sí
`current.level_masl`	number	m s. n. m.	sí
`current.observed_on`	string		sí
`current.storage_above_lowest_threshold_hm3`	number \| null	hm³	sí
`current.surface_area_km2`	number	km²	sí
`current.release_stance_m3s`	number	m³/s	sí
`thresholds`	lista		sí
`thresholds[].name`	string		sí
`thresholds[].level_masl`	number	m s. n. m.	sí
`thresholds[].source`	string		sí
`thresholds[].status`	string: "published", "unverified"		sí
`thresholds[].note`	string		sí
`thresholds[].metres_above`	number \| null		sí
`forecast`	lista		sí
`forecast[].horizon_days`	integer	días	sí
`forecast[].target_date`	string		sí
`forecast[].p10`	number		sí
`forecast[].p50`	number		sí
`forecast[].p90`	number		sí
`forecast[].median_backtest_residual_m`	number \| null	m	no
`forecast[].ensemble`	objeto		sí
`forecast[].ensemble.p10`	number		sí
`forecast[].ensemble.p90`	number		sí
`forecast[].ensemble.n`	integer		sí
`forecast[].ensemble.years`	lista		sí
`forecast[].model`	string		no
`days_to_threshold`	objeto		sí
`days_to_threshold.horizon_days`	integer	días	sí
`days_to_threshold.note`	string		sí
`days_to_threshold.thresholds`	lista		sí
`days_to_threshold.thresholds[].threshold`	string		sí
`days_to_threshold.thresholds[].level_masl`	number	m s. n. m.	sí
`days_to_threshold.thresholds[].status`	string		sí
`days_to_threshold.thresholds[].across_all_analogue_years`	objeto		sí
`days_to_threshold.thresholds[].across_all_analogue_years.analogue_years`	integer		sí
`days_to_threshold.thresholds[].across_all_analogue_years.years_that_cross`	integer		sí
`days_to_threshold.thresholds[].across_all_analogue_years.p10_days`	number \| null	días	sí
`days_to_threshold.thresholds[].across_all_analogue_years.p50_days`	number \| null	días	sí
`days_to_threshold.thresholds[].across_all_analogue_years.p90_days`	number \| null	días	sí
`days_to_threshold.thresholds[].scenarios`	lista		sí
`days_to_threshold.thresholds[].scenarios[].scenario`	string		sí
`days_to_threshold.thresholds[].scenarios[].analogYear`	integer		sí
`days_to_threshold.thresholds[].scenarios[].inflowMeanM3s`	number		sí
`days_to_threshold.thresholds[].scenarios[].crossesOn`	string \| null		sí
`days_to_threshold.thresholds[].scenarios[].days`	number \| null	días	sí
`days_to_threshold.thresholds[].scenarios[].minimumLevelMasl`	number		sí
`backtest`	objeto		sí
`backtest.report`	string		sí
`backtest.horizons`	lista		sí
`backtest.horizons[].horizon_days`	integer	días	sí
`backtest.horizons[].n`	integer		sí
`backtest.horizons[].mae_m`	number	m	sí
`backtest.horizons[].skill_vs_persistence`	number		sí
`backtest.horizons[].coverage_p10_p90`	number		sí
`crisis_check`	objeto		sí
`crisis_check.threshold_masl`	number	m s. n. m.	sí
`crisis_check.origins_considered`	integer		sí
`crisis_check.false_alarms_p50`	integer		sí
`crisis_check.episodes`	lista		sí
`crisis_check.episodes[].crossed_on`	string		sí
`crisis_check.episodes[].p50_lead_time_days`	number \| null	días	sí
`crisis_check.episodes[].p10_lead_time_days`	number \| null	días	sí
`precipitation_basin`	objeto		no	Which basin's ERA5 precipitation the Mazar run read: the verified catchment centroid once its history is adequate, the provisional point until then. Additive; absent before 2026-09-23.
`precipitation_basin.basin`	string		sí
`precipitation_basin.verified_centroid`	boolean		sí	True when basin is the verified centroid; false on the provisional fallback.
`precipitation_basin.era5_days`	integer	días	sí
`precipitation_basin.share_since_1990`	number		sí	Share of days since 1990-01-01 present in the basin's ERA5 series.
`precipitation_basin.fallback_reason`	string \| null		sí	Why the verified centroid was not used; null when it was.
`inflow_forecasts`	objeto		no	Mean inflow forecasts for the plants whose level is not worth forecasting (ENHANCEMENTS §5.3). A horizon is published only where the published rung (`backtest.model`: since 2026-09-25 the ensemble, the mean of the analogue years and climatology, plus a river forecast where one is validated) beats persistence and climatology on the backtest; the others carry the reason. Additive; absent before 2026-09-23.
`inflow_forecasts.report`	string		sí
`inflow_forecasts.note`	string		sí
`inflow_forecasts.plants`	lista		sí
`inflow_forecasts.plants[].site`	string		sí
`inflow_forecasts.plants[].origin_date`	string		sí
`inflow_forecasts.plants[].variable`	string		sí
`inflow_forecasts.plants[].target`	string		sí
`inflow_forecasts.plants[].precip_basin`	string \| null		sí	The basin whose rain conditions the analogue years; null when its ERA5 history is not adequate.
`inflow_forecasts.plants[].rain_conditioned`	boolean		sí
`inflow_forecasts.plants[].horizons`	lista		sí
`inflow_forecasts.plants[].horizons[].horizon_days`	integer	días	sí
`inflow_forecasts.plants[].horizons[].published`	boolean		sí
`inflow_forecasts.plants[].horizons[].reason`	string		sí
`inflow_forecasts.plants[].horizons[].backtest`	objeto		sí
`inflow_forecasts.plants[].horizons[].target_date`	string		no	Present only on a published horizon.
`inflow_forecasts.plants[].horizons[].p10`	number		no	m³/s; present only on a published horizon.
`inflow_forecasts.plants[].horizons[].p50`	number		no	m³/s; present only on a published horizon.
`inflow_forecasts.plants[].horizons[].p90`	number		no	m³/s; present only on a published horizon.
`inflow_forecasts.plants[].horizons[].ensemble_years`	integer		no
`inflow_forecasts.plants[].horizons[].rain_conditioned`	boolean		no
`scorecard`	objeto		no	How the published level forecasts (Mazar's level on the target day, m) did once their horizons passed (ENHANCEMENTS §5.1): every published run scored under the model and version that made it, the last run per origin and version only. Additive; absent in documents written before 2026-09-23.
`scorecard.generated_at`	string		sí	When the scorecard was computed, UTC.
`scorecard.observed_through`	string \| null		sí	The last day with an observation to score against.
`scorecard.target`	string		sí	The quantity scored, in words.
`scorecard.units`	string: "m", "GWh/day"		sí
`scorecard.runs_considered`	integer		sí
`scorecard.runs_superseded`	integer		sí	Runs left out because a later run for the same origin and version replaced them.
`scorecard.rows_scored`	integer		sí
`scorecard.rows_pending`	integer		sí	Published rows whose target date is after observed_through.
`scorecard.rows_excluded`	integer		sí	Rows whose date passed with no usable observation.
`scorecard.method`	string		sí
`scorecard.by_horizon`	lista		sí	One row per model, model version and horizon with at least one scored row.
`scorecard.by_horizon[].model_id`	string		sí
`scorecard.by_horizon[].model_version`	string		sí
`scorecard.by_horizon[].horizon_days`	integer	días	sí
`scorecard.by_horizon[].n`	integer		sí
`scorecard.by_horizon[].mae`	number \| null		sí	Mean absolute error of the p50, in units.
`scorecard.by_horizon[].bias`	number \| null		sí	Mean of observed minus p50, in units.
`scorecard.by_horizon[].n_band`	integer		sí	Rows that carried a p10 and a p90.
`scorecard.by_horizon[].coverage_p10_p90`	number \| null		sí	Share of banded rows observed inside p10–p90, 0–1.
`scorecard.by_horizon[].pinball_mean`	number \| null		sí	Mean pinball loss over p10, p50 and p90.
`scorecard.by_horizon[].first_origin`	string \| null		sí
`scorecard.by_horizon[].last_origin`	string \| null		sí
`scorecard.recent`	lista		sí	The most recent scored rows, newest target date first.
`scorecard.recent[].run_id`	string		sí
`scorecard.recent[].model_id`	string		sí
`scorecard.recent[].model_version`	string		sí
`scorecard.recent[].origin_date`	string		sí
`scorecard.recent[].horizon_days`	integer	días	sí
`scorecard.recent[].target_date`	string		sí
`scorecard.recent[].p10`	number \| null		sí
`scorecard.recent[].p50`	number		sí
`scorecard.recent[].p90`	number \| null		sí
`scorecard.recent[].observed`	number \| null		sí
`scorecard.recent[].error`	number \| null		sí	Observed minus p50.
`scorecard.recent[].in_band`	boolean \| null		sí
`license`	objeto		sí
`license.code`	string		sí
`license.code_url`	string		sí
`license.data`	string		sí
`license.data_es`	string		sí
`attribution`	lista		sí
`attribution[].id`	string		sí
`attribution[].name`	string		sí
`attribution[].provides`	string		sí
`attribution[].url`	string		sí
`attribution[].terms`	string		sí
`attribution[].terms_es`	string		sí
`see_also`	objeto		sí	Absolute URLs to the other documents, this document's schema and the documentation page.

/api/adequacy.json

esquema · lo escribe scripts/adequacy.ts

El déficit o superávit esperado en GWh/día por horizonte, el nivel de riesgo, los techos que supone y su validación. current.narrative_tier_field dice cuál de sus dos niveles usa la lectura del día.

Los 152 campos

Campos de adequacy.json, con su tipo y su unidad
Campo	Tipo	Unidad	Siempre	Descripción (del esquema)
`schema_version`	integer		sí	The format version. Changes only when a field is removed, renamed or retyped; added fields do not change it.
`generated_at`	string		sí	When the document was written, UTC.
`data_date`	string \| null		sí	The Ecuadorian calendar day the document's readings describe.
`run_id`	string		sí
`origin_date`	string		sí	The day the model stands on; equal to data_date.
`units`	string		no
`disclaimer`	string		no
`model`	objeto		sí
`model.id`	string		sí
`model.label`	string		sí
`model.backtest_origins`	integer		sí
`data`	objeto		sí
`data.usable_days`	integer	días	sí
`data.rejected_days`	integer	días	sí
`data.hydro_anomaly`	number		sí
`data.demand_growth_pct_per_year`	number		sí
`assumptions`	objeto		sí
`assumptions.thermal_gwh_day`	number	GWh/día	sí
`assumptions.import_gwh_day`	number	GWh/día	sí
`assumptions.stressed_import_gwh_day`	number	GWh/día	sí
`assumptions.other_gwh_day`	number	GWh/día	sí
`assumptions.editable_at`	string		sí
`current`	objeto		sí
`current.tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí	The model's Spanish word. Kept in schema_version 1; use the *_code field beside it.
`current.tier_code`	string: "comfortable", "watch", "tight", "deficit"		sí
`current.tier_label_es`	string		sí
`current.worst_tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí	The model's Spanish word. Kept in schema_version 1; use the *_code field beside it.
`current.worst_tier_code`	string: "comfortable", "watch", "tight", "deficit"		sí
`current.worst_tier_label_es`	string		sí
`current.worst_tier_horizon_days`	integer	días	sí
`current.worst_deficit_gwh_day`	number	GWh/día	sí
`current.narrative_tier_field`	string		sí	Which of tier and worst_tier the daily narrative is written about.
`horizons`	lista		sí
`horizons[].horizon_days`	integer	días	sí
`horizons[].target_date`	string		sí
`horizons[].demand_gwh_day`	number	GWh/día	sí
`horizons[].hydro_gwh_day`	number	GWh/día	sí
`horizons[].hydro_p10`	number \| null		sí
`horizons[].hydro_p90`	number \| null		sí
`horizons[].requirement_gwh_day`	number	GWh/día	sí
`horizons[].deficit_gwh_day`	number	GWh/día	sí
`horizons[].deficit_p10`	number \| null		sí
`horizons[].deficit_p90`	number \| null		sí
`horizons[].stressed_deficit_gwh_day`	number	GWh/día	sí
`horizons[].margin_pct`	number	%	sí
`horizons[].tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí	The model's Spanish word. Kept in schema_version 1; use the *_code field beside it.
`horizons[].tier_code`	string: "comfortable", "watch", "tight", "deficit"		sí
`horizons[].tier_label_es`	string		sí
`horizons[].backtest`	objeto		sí
`tiers`	objeto		sí
`tiers.definition`	objeto		sí
`tiers.codes`	objeto		sí
`band_method`	objeto		no	How the requirement's p10–p90 band is calibrated. Additive; absent before 2026-09-23.
`band_method.method`	string		sí
`band_method.quantiles`	lista		sí
`band_method.nominal_coverage`	number		sí
`band_method.stretch_by_horizon`	lista		sí
`band_method.stretch_by_horizon[].horizon_days`	integer	días	sí
`band_method.stretch_by_horizon[].stretch`	number \| null		sí
`import_sensitivity`	objeto		no	The deficit and tier under each import assumption from Colombia (ENHANCEMENTS §5.5), so a reader sees how much the tier rests on it. The central case is one of these rows. Additive; absent before 2026-09-23.
`import_sensitivity.note`	string		sí
`import_sensitivity.central_case`	string: "demonstrated", "stressed", "current_regime"		sí
`import_sensitivity.cases`	lista		sí
`import_sensitivity.cases[].case`	string: "demonstrated", "stressed", "current_regime"		sí
`import_sensitivity.cases[].import_gwh_day`	number	GWh/día	sí
`import_sensitivity.cases[].worst_tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí
`import_sensitivity.cases[].worst_tier_horizon_days`	integer	días	sí
`import_sensitivity.cases[].horizons`	lista		sí
`import_sensitivity.cases[].horizons[].horizon_days`	integer	días	sí
`import_sensitivity.cases[].horizons[].deficit_gwh_day`	number	GWh/día	sí
`import_sensitivity.cases[].horizons[].deficit_p90`	number \| null		sí	GWh/day: the deficit with the requirement at its p90.
`import_sensitivity.cases[].horizons[].tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí
`plant_outage`	objeto		no	The deficit and tier if Coca Codo Sinclair were out of service for the whole horizon (PLAN §8a gap 5): its recent share of national hydro is removed from the hydro forecast, with imports and thermal as in the central case. Not a forecast. Additive; absent before 2026-09-24.
`plant_outage.note`	string		sí
`plant_outage.site`	string		sí
`plant_outage.available`	boolean		sí	False when too few days of the plant's energy were in the share window; `reason` then says why and no horizons are given.
`plant_outage.reason`	string \| null		no
`plant_outage.share_of_hydro`	number		no	Plant energy over SMEC national hydro across the matched days of the window.
`plant_outage.plant_gwh_day`	number	GWh/día	no
`plant_outage.share_days`	integer	días	no
`plant_outage.share_from`	string		no
`plant_outage.share_to`	string		no
`plant_outage.horizons`	lista		no
`plant_outage.horizons[].horizon_days`	integer	días	sí
`plant_outage.horizons[].lost_gwh_day`	number	GWh/día	sí
`plant_outage.horizons[].hydro_gwh_day`	number	GWh/día	sí
`plant_outage.horizons[].deficit_gwh_day`	number	GWh/día	sí
`plant_outage.horizons[].deficit_p90`	number \| null		sí
`plant_outage.horizons[].tier`	string: "holgado", "vigilancia", "ajustado", "deficit"		sí
`scorecard`	objeto		no	How the published adequacy runs (the net requirement, demand minus hydro, mean over the horizon window, GWh/day) did once their horizons passed (ENHANCEMENTS §5.1): every published run scored under the model and version that made it, the last run per origin and version only. Additive; absent in documents written before 2026-09-23.
`scorecard.generated_at`	string		sí	When the scorecard was computed, UTC.
`scorecard.observed_through`	string \| null		sí	The last day with an observation to score against.
`scorecard.target`	string		sí	The quantity scored, in words.
`scorecard.units`	string: "m", "GWh/day"		sí
`scorecard.runs_considered`	integer		sí
`scorecard.runs_superseded`	integer		sí	Runs left out because a later run for the same origin and version replaced them.
`scorecard.rows_scored`	integer		sí
`scorecard.rows_pending`	integer		sí	Published rows whose target date is after observed_through.
`scorecard.rows_excluded`	integer		sí	Rows whose date passed with no usable observation.
`scorecard.method`	string		sí
`scorecard.by_horizon`	lista		sí	One row per model, model version and horizon with at least one scored row.
`scorecard.by_horizon[].model_id`	string		sí
`scorecard.by_horizon[].model_version`	string		sí
`scorecard.by_horizon[].horizon_days`	integer	días	sí
`scorecard.by_horizon[].n`	integer		sí
`scorecard.by_horizon[].mae`	number \| null		sí	Mean absolute error of the p50, in units.
`scorecard.by_horizon[].bias`	number \| null		sí	Mean of observed minus p50, in units.
`scorecard.by_horizon[].n_band`	integer		sí	Rows that carried a p10 and a p90.
`scorecard.by_horizon[].coverage_p10_p90`	number \| null		sí	Share of banded rows observed inside p10–p90, 0–1.
`scorecard.by_horizon[].pinball_mean`	number \| null		sí	Mean pinball loss over p10, p50 and p90.
`scorecard.by_horizon[].first_origin`	string \| null		sí
`scorecard.by_horizon[].last_origin`	string \| null		sí
`scorecard.recent`	lista		sí	The most recent scored rows, newest target date first.
`scorecard.recent[].run_id`	string		sí
`scorecard.recent[].model_id`	string		sí
`scorecard.recent[].model_version`	string		sí
`scorecard.recent[].origin_date`	string		sí
`scorecard.recent[].horizon_days`	integer	días	sí
`scorecard.recent[].target_date`	string		sí
`scorecard.recent[].p10`	number \| null		sí
`scorecard.recent[].p50`	number		sí
`scorecard.recent[].p90`	number \| null		sí
`scorecard.recent[].observed`	number \| null		sí
`scorecard.recent[].error`	number \| null		sí	Observed minus p50.
`scorecard.recent[].in_band`	boolean \| null		sí
`tier_history`	objeto		sí
`tier_history.horizon_days`	integer	días	sí
`tier_history.origins`	integer		sí
`tier_history.origins_followed_by_rationing`	integer		sí
`tier_history.origins_flagged`	integer		sí
`tier_history.share_of_flagged_that_preceded_cuts`	number \| null		sí
`tier_history.share_of_cuts_that_were_flagged`	number \| null		sí
`crisis_check`	objeto		sí
`crisis_check.episodes`	lista		sí
`crisis_check.episodes[].start`	string		sí
`crisis_check.episodes[].end`	string		sí
`crisis_check.episodes[].days`	integer	días	sí
`crisis_check.episodes[].measured_suppression_gwh_day`	number	GWh/día	sí
`crisis_check.episodes[].implied_deficit_gwh_day`	number	GWh/día	sí
`license`	objeto		sí
`license.code`	string		sí
`license.code_url`	string		sí
`license.data`	string		sí
`license.data_es`	string		sí
`attribution`	lista		sí
`attribution[].id`	string		sí
`attribution[].name`	string		sí
`attribution[].provides`	string		sí
`attribution[].url`	string		sí
`attribution[].terms`	string		sí
`attribution[].terms_es`	string		sí
`see_also`	objeto		sí	Absolute URLs to the other documents, this document's schema and the documentation page.

/api/narrative.json

esquema · lo escribe scripts/narrative.ts

La lectura del día: el texto que un modelo de lenguaje escribió solo con los números de basis, publicado únicamente si un validador lo aprobó.

Los 36 campos

Campos de narrative.json, con su tipo y su unidad
Campo	Tipo	Unidad	Siempre	Descripción (del esquema)
`schema_version`	integer		sí	The format version. Changes only when a field is removed, renamed or retyped; added fields do not change it.
`generated_at`	string		sí	When the document was written, UTC.
`data_date`	string \| null		sí	The Ecuadorian calendar day the document's readings describe.
`status`	string		sí
`model`	string		sí
`prompt_version`	string		sí
`payload_hash`	string		sí
`origin_date`	string		sí	The day the payload describes; equal to data_date.
`risk_tier`	string \| null: "holgado", "vigilancia", "ajustado", "deficit"		sí	The model's Spanish word. Kept in schema_version 1; use the *_code field beside it.
`risk_tier_code`	string \| null: "comfortable", "watch", "tight", "deficit"		sí
`risk_tier_source`	string		sí	The adequacy field the tier was copied from.
`outlook_es`	string		sí
`drivers`	lista		sí
`confidence`	string: "low", "medium", "high"		sí
`usage`	objeto		no
`usage.input_tokens`	number \| null		sí
`usage.output_tokens`	number \| null		sí
`usage.cost_usd`	number \| null	USD	sí
`disclaimer`	string		sí
`basis`	objeto		sí	The payload the text was written from, verbatim.
`basis.payload_version`	integer		sí
`basis.origin_date`	string		sí
`basis.reservoirs`	lista		sí
`license`	objeto		sí
`license.code`	string		sí
`license.code_url`	string		sí
`license.data`	string		sí
`license.data_es`	string		sí
`attribution`	lista		sí
`attribution[].id`	string		sí
`attribution[].name`	string		sí
`attribution[].provides`	string		sí
`attribution[].url`	string		sí
`attribution[].terms`	string		sí
`attribution[].terms_es`	string		sí
`see_also`	objeto		sí	Absolute URLs to the other documents, this document's schema and the documentation page.

Las tablas completas

Cada tabla del repositorio en un solo CSV comprimido con gzip, de su primer día al último, reconstruido en cada publicación del sitio: la cabecera una vez y cada fila exactamente como está en data/curated, donde se guardan partidas por año. La lista con filas y columnas, en /api/bulk/index.json.

Tablas completas descargables
Archivo	Filas	Columnas
adequacy_runs.csv.gz	30	`run_id, generated_at, origin_date, model_id, model_version, features_hash, usable_days, rejected_days, demand_fit_days, demand_growth_pct_per_year, hydro_fit_days, hydro_anomaly, thermal_gwh_day, import_gwh_day, stressed_import_gwh_day, other_gwh_day, backtest_origins`
adequacy_values.csv.gz	150	`run_id, origin_date, horizon_days, target_date, demand_gwh_day, hydro_gwh_day, requirement_gwh_day, requirement_p10, requirement_p90, deficit_gwh_day, deficit_p10, deficit_p90, stressed_deficit_gwh_day, margin_pct, tier`
enso_monthly.csv.gz	920	`month, oni, source, fetched_at, raw_ref`
forecast_runs.csv.gz	35	`run_id, generated_at, origin_date, site, variable, model_id, model_version, features_hash, origin_level_masl, train_days, balance_days, analog_years, backtest_origins, curve_datum_m, curve_area_coefficient, curve_area_exponent, curve_rmse_level_m, turbine_m3s_per_mw, release_stance_m3s, crest_masl`
forecast_values.csv.gz	175	`run_id, origin_date, horizon_days, target_date, p10, p50, p90, ensemble_p10, ensemble_p90, ensemble_n, model_id`
geoglows_forecasts.csv.gz	25.200	`issued, site, river_id, member, lead_days, q_m3s, store_key, etag, fetched_at`
narrative_snapshots.csv.gz	46	`run_id, generated_at, origin_date, status, model_id, prompt_version, payload_hash, forecast_run_id, adequacy_run_id, risk_tier, confidence, input_tokens, output_tokens, cost_usd, outlook_es, drivers_json, reason`
national_balance_daily.csv.gz	58.504	`date, concepto, dia_kwh, pct_dia, mes_kwh, pct_mes, anio_kwh, pct_anio, ultimos365_kwh, tipo_dia, tipo_dia_anio_anterior, source, fetched_at, raw_ref`
observations_daily.csv.gz	91.273	`date, site, variable, value, source, mrid, fetched_at, raw_ref`
operating_bands.csv.gz	7	`site, cota_min, cota_max, qmax_m3s, source, first_date, last_date`
operativa_snapshots.csv.gz	4.841	`fetched_at, block, period_label, period_date, metric, value, unit, source, raw_ref`
weather_daily.csv.gz	111.200	`date, basin, latitude, longitude, kind, precip_mm, temp_mean_c, issued_at, source, fetched_at, raw_ref`
xm_exchange_daily.csv.gz	4.028	`date, link, export_kwh, import_kwh, export_hours, import_hours, source, fetched_at, raw_ref`
xm_system_daily.csv.gz	33.389	`date, metric, value, unit, source, fetched_at, raw_ref`

Esquemas JSON

Un esquema JSON (draft 2020-12) por documento, el mismo contra el que se prueba cada cambio: latest.schema.json, status.schema.json, forecast.schema.json, adequacy.schema.json, narrative.schema.json. También hay un feed Atom de la lectura del día y un archivo con lo que se publicó sobre cada día.