# SMARD German Electricity Market API

> German power market data from the grid regulator: load, generation by source, day-ahead prices

- Vendor: `smardgermanelectricitymarketap` · version 1.0 · category Energy · tags electricity price api, energy market api, germany power api, day ahead price api, renewable generation api, grid load api, smard api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/smardgermanelectricitymarketap
- This document: https://apiclay.com/docs/smardgermanelectricitymarketap.md
- OpenAPI 3.1: https://apiclay.com/api/smardgermanelectricitymarketap/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `smardgermanelectricitymarketap`
- Updated: 2026-11-18

## About

## SMARD German Electricity Market API

Electricity market data published by Germany's Federal Network Agency (Bundesnetzagentur) on SMARD: grid load, generation by source (solar, wind, coal, gas, nuclear, hydro, biomass) and day-ahead wholesale prices, for Germany, neighbouring zones and each transmission operator, from quarter-hour to yearly resolution since 2015.

Data comes from **smard.de** (https://www.smard.de). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://www.smard.de) and returns it unchanged.

Typical flow: `/index` for a series' block timestamps, then `/series` with one of them.

### Routes

#### GET `/index` - Available timestamps
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| filter | path | number | yes | Series id: `410` grid load, `4169` day-ahead price DE-LU, `4068` solar, `4067` wind onshore, `1225` wind offshore, `1223` lignite, `4069` hard coal, `4071` natural gas, `1224` nuclear, `1226` hydro, `4066` biomass. |
| region | path | string | yes | `DE`, `AT`, `LU`, `DE-LU`, `DE-AT-LU`, `50Hertz`, `Amprion`, `TenneT`, `TransnetBW`. |
| resolution | path | string | yes | `quarterhour`, `hour`, `day`, `week`, `month` or `year`. |

Returns: `timestamps[]`, each the start (Unix ms) of one data block.

#### GET `/series` - Data series
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| filter | path | number | yes | Series id: `410` grid load, `4169` day-ahead price DE-LU, `4068` solar, `4067` wind onshore, `1225` wind offshore, `1223` lignite, `4069` hard coal, `4071` natural gas, `1224` nuclear, `1226` hydro, `4066` biomass. |
| region | path | string | yes | `DE`, `AT`, `LU`, `DE-LU`, `DE-AT-LU`, `50Hertz`, `Amprion`, `TenneT`, `TransnetBW`. |
| resolution | path | string | yes | `quarterhour`, `hour`, `day`, `week`, `month` or `year`. |
| timestamp | path | number | yes | A block start from `/index`, e.g. `1767222000000`. |

Returns: `series[[timestamp_ms, value]]` (MW or MWh for load and generation, EUR/MWh for prices; `null` for periods not yet published) and `meta_data`.

### License

SMARD data is published by the Bundesnetzagentur under CC BY 4.0; credit "Bundesnetzagentur | SMARD.de".

### Caveats

- Each block covers a week (hourly) or a year (daily) depending on resolution.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by smard.de.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /index — Available timestamps
- Gateway: `GET https://api.apiclay.com/v1/api/smardgermanelectricitymarketap/index`
- Public query params: `filter` (string, required), `region` (string, required), `resolution` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /series — Data series
- Gateway: `GET https://api.apiclay.com/v1/api/smardgermanelectricitymarketap/series`
- Public query params: `filter` (string, required), `region` (string, required), `resolution` (string, required), `timestamp` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/smardgermanelectricitymarketap/index?filter=<filter>&region=<region>&resolution=<resolution>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
