# EPEX SPOT — 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.

> Access real-time and historical European power market data including day-ahead and intraday pricing results, monitor auction statuses across market areas, and stay updated with the latest newsroom articles from EPEX SPOT. Track power prices and market activity across different European regions to make informed trading and investment decisions.

**Category:** Finance & Markets | **Website:** [epexspot.com/](https://epexspot.com/) | **Docs:** [parse.bot/marketplace/5128529e-8481-4b52-bf6a-7f8febbd89b3/epexspot-com-api](https://parse.bot/marketplace/5128529e-8481-4b52-bf6a-7f8febbd89b3/epexspot-com-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/epex-spot/`
**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 auction status

Retrieve current auction status for all markets on the platform, including operational messages and last update timestamp. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/epex-spot/get-auction-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market areas

Retrieve the list of available market areas/bidding zones and filter options including modalities, auctions, sub-modalities, and products. No parameters required; returns the full set of options available on the platform.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/epex-spot/get-market-areas \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market results

Fetch market results for a given trading modality, market area, and delivery date. Returns hourly price data with timestamps. The full day's results are returned in one response. An empty results array indicates no data is available for the given parameters (e.g. future date not yet published).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `auction` | string | No | Auction name. |
| `delivery_date` | string | No | Delivery date in YYYY-MM-DD format. Omitting defaults to the current UTC date. |
| `market_area` | string | No | Market area/bidding zone code. |
| `modality` | string | No | Trading modality. |
| `product` | string | No | Product resolution. |
| `sub_modality` | string | No | Market segment. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/epex-spot/get-market-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"auction":"<string>","delivery_date":"<string>","market_area":"<string>","modality":"<string>","product":"<string>","sub_modality":"<string>"}'
```

### Get newsroom articles

Fetch latest market news and press releases from the EPEX SPOT newsroom. Returns article titles, dates, categories, and links. No parameters required; returns the most recent articles displayed on the newsroom page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/epex-spot/get-newsroom-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## 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.