---
title: "Retailer procurement-risk simulation (Scale, white-label permitted)"
method: POST
path: "/v1/simulate/retailer"
---

# Retailer procurement-risk simulation (Scale, white-label permitted)

`POST /v1/simulate/retailer`

## Request

- Base URL: `https://voltcast.com/api`
- URL: `https://voltcast.com/api/v1/simulate/retailer`
- Auth: HTTP bearer

## Request body

- object
  - `zone` string, required
  - `profile` 'baseload' | 'household' | 'business'
  - `hedge_ratio` number
  - `fixed_price_eur_mwh` number
  - `from` string, date
  - `to` string, date

## Response `200`

Monthly profile-weighted spot costs blended with the hedged share; p5/p50/p95 portfolio cost, cost-at-risk, profile premium vs baseload.

---

[API](https://skmtc.dev/voltcast/apis/voltcast-api.md) · [All operations](https://skmtc.dev/voltcast/apis/voltcast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voltcast/apis/voltcast-api/revisions/9c39e52e3eed?raw)