---
title: "Market snapshot — current spot prices, CO₂ intensity, renewable forecast"
method: GET
path: "/api/dashboard/market-snapshot"
tags: ["Dashboard API"]
---

# Market snapshot — current spot prices, CO₂ intensity, renewable forecast

`GET /api/dashboard/market-snapshot`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/dashboard/market-snapshot`
- Auth: none declared

Aggregates current day-ahead spot prices, CO₂ intensity (with forecast), and wind/solar generation forecast for the next 24 hours into a single response.

Fixed upstream parameters: `market: day-ahead`, today's date, `forecastType: both`.

Optional overrides:
- `?location=Heidelberg` overrides the CO₂ intensity location (default: Deutschland)
- `?region=Bayern` enables the ENTSO-E wind/solar forecast (region-specific); omit to skip — `renewableForecast24h` will be null when no region is given

Cache TTL: 15 minutes (key: location + region).

## Query parameters

- `location` string
- `region` string
- `token` string

## Response `200`

Current market snapshot

- object
  - `spotPrice` object, nullable
    - `current` number: €/MWh
    - `avgToday` number: €/MWh
    - `minToday` number: €/MWh
    - `maxToday` number: €/MWh
    - `trend` 'rising' | 'falling' | 'stable'
    - `source` string
  - `co2` object, nullable
    - `current` number: gCO2eq/kWh
    - `avgToday` number
    - `signal` 'green' | 'yellow' | 'red'
    - `location` string
  - `renewableForecast24h` object, nullable
    - `solarPeakMW` number
    - `windPeakMW` number
    - `combinedPeakAt` string, date-time
  - `timestamp` string, date-time
  - `_errors` string[]

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)