# Mimer Svk — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/mimer-svk/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/mimer-svk/get-consumption-profiles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/mimer-svk/get-consumption-statistics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/mimer-svk/get-exchange-rates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/mimer-svk/get-fcr-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/mimer-svk/get-production-statistics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/mimer-svk/get-profile-settlement-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","from_month":"<string>","to_month":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.