Cernion
Cernion is the unified energy data API for Germany and Europe. It combines the German installation registry (MaStR, 3.7M+ assets), ENTSO-E market prices and generation data, AGSI+ gas storage, GrünstromIndex CO₂ forecasts, and AI-powered business analytics for energy suppliers and grid operators — all under one token. Built for Stadtwerke, DSOs, energy traders, and developers building prosumer…
2 subscribers
100 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Cernion endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
eic-codes_eic-codes_gasOperators /api/eic-codes/gas-operators |
Retrieve list of gas storage system operators in Germany with their EIC codes. Use cases: Find valid codes for AGSI operator queries, German gas storage market overview, operator… |
| POST |
eic-codes_eic-codes_search /api/eic-codes/search |
Search 72,580+ EIC codes from ENTSO-E and AGSI/GIE. **At least one of 'code' or 'name' is required.** **Parameter Details:** - **code**: Exact 16-character EIC code (e.g.,… |
| GET |
eic-codes_eic-codes_gasFacilities /api/eic-codes/gas-facilities |
Retrieve underground gas storage facilities in Germany. Use cases: Find valid codes for AGSI facility queries, operator portfolio breakdown, facility-level monitoring. |
| POST |
customer-service_customer-service_installationHealthCheck /api/customer-service/installation-health-check |
Health status: EXCELLENT (>95%), GOOD (90-95%), ACCEPTABLE (85-90%), POOR (70-85%), CRITICAL ( |
| POST |
customer-service_customer-service_installationChangeWizard /api/customer-service/installation-change-wizard |
6 change types: operator change, storage retrofit, capacity increase, decommissioning, tariff switch, direct marketing |
| POST |
eic-codes_eic-codes_validate /api/eic-codes/validate |
Validates EIC code format according to IEC 62325 standard. Checks: length (16 characters), LIO area (10-70), code type character, check digit algorithm. Use for pre-validation… |
| POST |
query_query_discover /api/query/discover |
Explore available data sources to prevent query errors and build dynamic UIs. Provides schema information about databases, tables, columns, operators, and available MCP tools.… |
| POST |
query_query_ask /api/query/ask |
Execute natural language queries against German energy data sources including MaStR (Marktstammdatenregister), ENTSO-E Transparency Platform, and SMARD.de. Supports multi-source… |
| POST |
customer-service_customer-service_portalWidget /api/customer-service/portal-widget |
Generate embeddable self-service widgets that dramatically reduce call center load and improve customer satisfaction. **Business Impact: 30-40% reduction in support calls** =… |
| POST |
energy-market_energy-market_installations /api/energy-market/installations |
Search Marktstammdatenregister (MaStR) for energy installations. **'installationType' is required.** **Parameter Details:** - **installationType**: Installation type - "solar"… |
| POST |
gas-storage_gas-storage_historicalData /api/gas-storage/historical-data |
Retrieve historical gas storage time-series data with flexible aggregation. **Aggregation levels:** - daily: Day-by-day granularity - weekly: Weekly averages - monthly: Monthly… |
| POST |
query_query_askLearned /api/query/ask-learned |
Execute queries using learned templates from the Sprint 11 Self-Learning System. Reuses proven query patterns for 20x faster execution compared to cernion_ask. Falls back to LLM… |
| POST |
forecast_forecast_generationForecast /api/forecast/generation-forecast |
Regional Solar/Wind generation forecast based on ACTUAL installed capacity from MaStR, combined with weather forecasts from Visual Crossing API. **How it works:** 1. Queries… |
| POST |
energy-market_energy-market_production /api/energy-market/production |
Query generation data from SMARD.de and ENTSO-E Transparency Platform. **All parameters are required except resolution.** **Parameter Details:** - **energySource**: Energy source… |
| POST |
gas-storage_gas-storage_storageTrend /api/gas-storage/storage-trend |
Analyze gas storage trends over defined time periods. **Period options:** - week: Last 7 days - month: Last 30 days - quarter: Last 90 days - year: Last 365 days **Trend… |
| POST |
gas-storage_gas-storage_euStatistics /api/gas-storage/eu-statistics |
Get EU-wide aggregate gas storage statistics. **Metrics included:** - Total EU storage capacity - Current fill level (% and TWh) - EU average coverage days - Country breakdown… |
| POST |
energy-market_energy-market_prices /api/energy-market/prices |
Query electricity prices from ENTSO-E Transparency Platform and SMARD.de. **All parameters are required.** **Parameter Details:** - **market**: Price type - "day-ahead" (next day… |
| POST |
gas-storage_gas-storage_operatorStorage /api/gas-storage/operator-storage |
Get detailed storage data for a specific storage system operator including all managed facilities. **Use EIC codes to identify operators** (e.g., "21X000000001262B" for RWE Gas… |
| POST |
gas-storage_gas-storage_countryStorage /api/gas-storage/country-storage |
Get comprehensive gas storage data for European countries from AGSI+ platform. **Data includes:** - Current fill level (% and TWh) - Daily injection/withdrawal rates - Working… |
| GET |
assets_assets_biomass /api/assets/biomass |
**Default: Only active installations (status 35).** |
| GET |
assets_assets_combustion /api/assets/combustion |
**Default: Only active installations (status 35).** |
| GET |
assets_assets_list /api/assets/list |
Retrieves complete installation data from the German Marktstammdatenregister (MaStR). Supports filtering by grid operator (BDEW code or name), asset type, capacity, commissioning… |
| POST |
gas-storage_gas-storage_supplySecurityCheck /api/gas-storage/supply-security-check |
Assess gas supply security status for a country. **Security status levels:** - SECURE: >70% fill level - ADEQUATE: 50-70% fill level - WARNING: 30-50% fill level - CRITICAL: |
| GET |
assets_assets_storage /api/assets/storage |
**Default: Only active installations (status 35).** |
| POST |
energy-market_energy-market_co2Intensity /api/energy-market/co2-intensity |
Query CO2 intensity for any location in Germany from GrünstromIndex. **Only 'location' is required.** **Parameter Details:** - **location**: German city name or postal code… |
| GET |
api_api_listAliases /api/api/list-aliases |
|
| GET |
eic-codes_eic-codes_statistics /api/eic-codes/statistics |
Get comprehensive statistics about the EIC code database including 72,580+ total codes with breakdowns by type (party, resource, substation, area, operator, tie-line, location,… |
| GET |
api_api_openapi /api/api/openapi.json |
|
| POST |
residual-load_residual-load_loadForecastRegional /api/residual-load/load-forecast-regional |
LLM-based regional load forecast enriched with **real MaStR installation data** injected into the reasoning prompt. **What is real vs. LLM-estimated:** | Component | Data source… |
| GET |
assets_assets_all /api/assets/all |
Retrieves installations of all or selected types from a grid operator. **Default: Only active installations (status 35).** Ideal for asset management and portfolio overview.… |
| POST |
gas-storage_gas-storage_compareCountries /api/gas-storage/compare-countries |
Compare gas storage metrics across multiple European countries. **Available metrics:** - fill_percentage: Current storage fill level - capacity: Total storage capacity -… |
| POST |
grid-operations_grid-operations_connectionCapacityCheck /api/grid-operations/connection-capacity-check |
6-step analysis: inventory, capacity, simultaneity, decision, alternatives, cost estimates |
| POST |
grid-operations_grid-operations_redispatchExport /api/grid-operations/redispatch-export |
Returns installations that participate in redispatch (async job) |
| GET |
system_system_jobStatus /api/system/job-status/:jobId |
Job states: queued, running, succeeded, failed |
| GET |
grid-operations_grid-operations_marketPartners /api/grid-operations/market-partners |
Search for German energy market participants including grid operators, suppliers, and balancing responsible parties. **Search Types**: - **BDEW Code**: 13-digit code (e.g.,… |
| POST |
grid-operations_grid-operations_vnbLookup /api/grid-operations/vnb-lookup |
Resolve BDEW codes to MaStR Netzbetreiber IDs (SNB/GNB) for downstream grid-operator queries. |
| POST |
grid-operations_grid-operations_vnbdigitalLookup /api/grid-operations/vnbdigital-lookup |
Lookup VNBs and planning regions using VNBdigital. Provide one of: - **coordinates** for geolocation lookup - **postcodeId** from vnbdigital_search - **communityId** from… |
| GET |
assets_assets_hydro /api/assets/hydro |
**Default: Only active installations (status 35).** |
| POST |
entsoe_entsoe_generationForecast /api/entsoe/generation-forecast |
✅ FULLY WORKING - Comprehensive generation planning, all production types. Returns day-ahead generation forecasts by PSR type. |
| GET |
entsoe_entsoe_psrTypes /api/entsoe/psr-types |
Static reference data for PSR type codes used in generation queries. Common codes: B01=Biomass, B02=Fossil Brown coal/Lignite, B03=Fossil Coal-derived gas, B04=Fossil Gas,… |
| POST |
entsoe_entsoe_windSolarForecast /api/entsoe/wind-solar-forecast |
✅ FULLY WORKING - Renewable energy planning, grid balancing, trading strategies. Returns day-ahead forecasts for wind and solar generation. |
| POST |
grid-operations_grid-operations_vnbdigitalSearch /api/grid-operations/vnbdigital-search |
Search VNBdigital to resolve addresses, locations, or VNB names into IDs for follow-up lookups. **Use Cases:** - Identify addresses and locations for VNB lookup - Find… |
| POST |
entsoe_entsoe_actualGeneration /api/entsoe/actual-generation |
✅ FULLY WORKING - Energy mix analysis, renewable share monitoring, forecast validation. Returns actual generation data by PSR type (solar, wind, gas, nuclear, etc.). |
| POST |
entsoe_entsoe_loadForecast /api/entsoe/load-forecast |
✅ FULLY WORKING - Grid planning, demand forecasting for trading, peak load management. Returns day-ahead load/demand forecasts. |
| POST |
entsoe_entsoe_unavailability /api/entsoe/unavailability |
✅ FULLY WORKING - Outage monitoring (planned and unplanned), capacity forecasting. Supports production, transmission, and load unavailability types with PSR type filtering. |
| POST |
entsoe_entsoe_physicalFlows /api/entsoe/physical-flows |
✅ FULLY WORKING - Import/export dependency monitoring, grid stress assessment. Returns hourly or daily cross-border electricity flows with statistics. |
| POST |
entsoe_entsoe_dayAheadPrices /api/entsoe/day-ahead-prices |
✅ FULLY WORKING - Most reliable ENTSOE endpoint. Automatic EIC code selection, multi-format dates, 15-minute resolution. Use this as reference for working ENTSOE integration. |
| GET |
assets_assets_wind /api/assets/wind |
**Default: Only active installations (status 35).** |
| POST |
entsoe_entsoe_windSolarActual /api/entsoe/wind-solar-actual |
✅ FULLY WORKING - Renewable energy monitoring, forecast validation. Returns actual generation data for wind (onshore/offshore) and solar power. |
| GET |
assets_assets_solar /api/assets/solar |
Retrieves all photovoltaic installations of a grid operator. **Default: Only active installations (status 35).** Example: /api/assets/solar?bdewCode=4041407000008&redispatch=true… |
+ 50 more endpoints on the provider's documentation.
Cernion pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $100 / month | — |
|
| ULTRA | $499 / month | — |
|
