# Mimer Svk — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Monitor Swedish electricity grid data by retrieving real-time consumption and production statistics, settlement prices, and frequency containment reserve information from Svenska kraftnät. Access comprehensive grid settlement data and exchange rates to analyze energy market trends and grid performance across Sweden.

**Category:** Government & Public Data | **Website:** [mimer.svk.se/](https://mimer.svk.se/) | **Docs:** [parse.bot/marketplace/6d5139e9-d21e-4929-ae5e-33d99e0d0740/mimer-svk-se-api](https://parse.bot/marketplace/6d5139e9-d21e-4929-ae5e-33d99e0d0740/mimer-svk-se-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mimer-svk-se-api-6d5139e9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_consumption_profiles

Fetch hourly or monthly consumption profile volumes (kWh) for a given date range and Swedish price area. Returns records with period timestamps and HL/LL kWh values. Monthly resolution (1) reliably returns data for all areas; hourly resolution (0) may return empty for individual areas.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Swedish price area code. |
| `from_date` | string | No | Start date in YYYY-MM-DD format. |
| `resolution` | integer | No | Time resolution: 0 for hourly, 1 for monthly. |
| `to_date` | string | No | End date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mimer-svk-se-api-6d5139e9/get_consumption_profiles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","from_date":"<string>","resolution":"<integer>","to_date":"<string>"}'
```

### get_consumption_statistics

Fetch hourly consumption statistics (kWh). Only SN0 (whole Sweden) reliably returns non-zero data; individual price areas (SN1-SN4) may return zeros or empty results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Swedish price area code. SN0 recommended for reliable data. |
| `from_date` | string | No | Start date in YYYY-MM-DD format. |
| `to_date` | string | No | End date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mimer-svk-se-api-6d5139e9/get_consumption_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","from_date":"<string>","to_date":"<string>"}'
```

### get_exchange_rates

Fetch daily exchange rates (SEK/EUR) used for support services settlement calculations. Returns one record per day with the exchange rate value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_date` | string | No | Start date in YYYY-MM-DD format. |
| `to_date` | string | No | End date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mimer-svk-se-api-6d5139e9/get_exchange_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from_date":"<string>","to_date":"<string>"}'
```

### get_fcr_data

Fetch Frequency Containment Reserve (FCR) ancillary service data including FCR-N, FCR-D Up, and FCR-D Down prices (EUR/MW) and volumes by bidding zone (SE1-SE4, DK2). Returns hourly records for the specified date range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `auction_type` | integer | No | Auction type filter. |
| `from_date` | string | No | Start date in YYYY-MM-DD format. |
| `product_type` | integer | No | Product type filter. |
| `to_date` | string | No | End date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mimer-svk-se-api-6d5139e9/get_fcr_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"auction_type":"<integer>","from_date":"<string>","product_type":"<integer>","to_date":"<string>"}'
```

### get_production_statistics

Fetch hourly production statistics (kWh) by power type. Only SN0 (whole Sweden) reliably returns non-zero data; individual price areas (SN1-SN4) may return zeros or empty results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Swedish price area code. SN0 recommended for reliable data. |
| `from_date` | string | No | Start date in YYYY-MM-DD format. |
| `power_type` | string | No | Power type code. TL = Total. |
| `to_date` | string | No | End date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mimer-svk-se-api-6d5139e9/get_production_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","from_date":"<string>","power_type":"<string>","to_date":"<string>"}'
```

### get_profile_settlement_prices

Fetch monthly profile settlement prices (Schablonavräkningspriser) in SEK/MWh for a given month range and price area. Returns records with HL/LL prices and average price per month.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Swedish price area code. |
| `from_month` | string | No | Start month in YYYY-MM format. |
| `to_month` | string | No | End month in YYYY-MM format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mimer-svk-se-api-6d5139e9/get_profile_settlement_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","from_month":"<string>","to_month":"<string>"}'
```