# HALOWERK Energy

> Strompreis-Prognose, Negativpreis-Wahrscheinlichkeit und Dispatch-Entscheidungen für Batterie-, EV- und Trading-Agenten.

Paid per call over x402. Asset USDC on Base Mainnet, recipient 0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E.

## How to pay

1. Call the route without a payment header. The 402 response carries accepts, description and inputSchema.
2. Sign the terms with an x402 client.
3. Repeat the call with the proof in the PAYMENT-SIGNATURE header.

A 402 response costs nothing and triggers no work. If the work fails, the answer carries charged=false and nothing is settled.

## Free surfaces

- https://energy.halowerk.com/x402-resources
- https://energy.halowerk.com/next-actions
- https://energy.halowerk.com/about
- https://energy.halowerk.com/llms.txt
- https://energy.halowerk.com/docs
- https://energy.halowerk.com/catalog
- https://energy.halowerk.com/openapi.json
- https://energy.halowerk.com/pricing

## Endpoints

### POST /v3/dispatch-plan

Schedules a deadline-bound compute, DePIN, battery or power-trading workload into an actionable German or European power window. Returns exact timing, expected EUR cost and savings, uncertainty, freshness, expiry and decision trace.

- Price: 0.02 USDC (per_request)
- Schema: https://energy.halowerk.com/v3/dispatch-plan/schema
- Example body:

```json
{
  "opportunity_id": "bazaar_discovery_probe",
  "power_kw": 25,
  "energy_kwh": 50,
  "deadline": "2099-01-01T06:00:00.000Z",
  "risk_profile": "balanced",
  "constraints": {
    "must_run_continuously": true
  }
}
```

### POST /v3/market-brief

Returns licensed ENTSO-E and SMARD spot-market context for compute, DePIN, battery and power-trading agents: published day-ahead prices, volatility, load, renewable share when available, the observed share of published negative-price hours, uncertainty, freshness and expiry.

- Price: 0.05 USDC (per_request)
- Schema: https://energy.halowerk.com/v3/market-brief/schema
- Example body:

```json
{
  "region": "DE-LU",
  "horizon_hours": 24,
  "use_case": "trading"
}
```

### GET /research

GET-Fallback mit maschinenlesbarer 402-Antwort für POST /research.

- Price: 0.05 USDC (per_request)
- Schema: https://energy.halowerk.com/research/schema?method=GET
- Example body:

```json
{}
```

### GET /articles/{id}

GET-Fallback mit maschinenlesbarer 402-Antwort für POST /articles/{id}.

- Price: 0.01 USDC (per_request)
- Schema: https://energy.halowerk.com/articles/{id}/schema?method=GET
- Example body:

```json
{}
```

### GET /tasks

GET-Fallback mit maschinenlesbarer 402-Antwort für POST /tasks.

- Price: 0.10 USDC (per_request)
- Schema: https://energy.halowerk.com/tasks/schema?method=GET
- Example body:

```json
{}
```

### POST /research

Aggregierte Energie-Recherche für DE/EU aus Live-Datenquellen.

- Price: 0.05 USDC (per_request)
- Schema: https://energy.halowerk.com/research/schema?method=POST
- Example body:

```json
{
  "query": "German electricity market summary today"
}
```

### GET /demo/paid-sample

Cheapest end-to-end x402 purchase test. Always returns a 402 challenge without payment and the current full NegPrice decision after a valid USDC payment.

- Price: 0.001 USDC (per_request)
- Schema: https://energy.halowerk.com/demo/paid-sample/schema
- Example body:

```json
{}
```

### POST /energy/decision

EV, battery, and flexible-load agents buy this endpoint to receive an executable action with timing, expected value, confidence, and expiry.

- Price: 0.01 USDC (per_request)
- Schema: https://energy.halowerk.com/energy/decision/schema
- Example body:

```json
{
  "goal": "minimize_cost",
  "device": "ev",
  "location": "Germany",
  "duration_hours": 2,
  "constraints": {
    "target_soc": 80,
    "max_power_kw": 11
  }
}
```

### POST /research/quick

Research and market-monitoring agents buy this endpoint to answer a focused question with a compact live market snapshot.

- Price: 0.003 USDC (per_request)
- Schema: https://energy.halowerk.com/research/quick/schema
- Example body:

```json
{
  "query": "Summarize the German electricity market for the next 24 hours."
}
```

### POST /articles/{id}

Volltext eines Energie-Fachartikels.

- Price: 0.01 USDC (per_request)
- Schema: https://energy.halowerk.com/articles/{id}/schema?method=POST
- Example body:

```json
{}
```

### POST /tasks

Asynchroner Deep-Dive Task mit Mindest-Bounty.

- Price: 0.10 USDC (per_request)
- Schema: https://energy.halowerk.com/tasks/schema?method=POST
- Example body:

```json
{
  "task_description": "Deep research on German battery arbitrage",
  "bounty": "0.10"
}
```

### POST /price/spot

Trading and dispatch agents buy this endpoint to obtain the current German EPEX spot price for immediate decisions.

- Price: 0.001 USDC (per_request)
- Schema: https://energy.halowerk.com/price/spot/schema
- Example body:

```json
{}
```

### POST /price/forecast

Energy-trading and flexible-load agents buy this endpoint to compare the next 24 hours of EPEX prices and volatility.

- Price: 0.005 USDC (per_request)
- Schema: https://energy.halowerk.com/price/forecast/schema
- Example body:

```json
{}
```

### POST /carbon/now

Aktuelle CO2-Intensität des deutschen Strommix.

- Price: 0.001 USDC (per_request)
- Schema: https://energy.halowerk.com/carbon/now/schema
- Example body:

```json
{}
```

### POST /grid/load

Grid-monitoring and dispatch agents buy this endpoint to obtain the latest German system load from SMARD.

- Price: 0.001 USDC (per_request)
- Schema: https://energy.halowerk.com/grid/load/schema
- Example body:

```json
{}
```

### POST /renewable/share

Carbon-aware and ESG agents buy this endpoint to measure the current renewable share and generation mix in Germany.

- Price: 0.001 USDC (per_request)
- Schema: https://energy.halowerk.com/renewable/share/schema
- Example body:

```json
{}
```

### POST /flexibility/window

EV, heat-pump, and flexible-load agents buy this endpoint to identify the cheapest upcoming operating hours.

- Price: 0.01 USDC (per_request)
- Schema: https://energy.halowerk.com/flexibility/window/schema
- Example body:

```json
{}
```

### POST /signals/buy-sell

Trading bots buy this endpoint to receive a multi-factor buy/sell signal with RSI, Z-score, trend, and confidence.

- Price: 0.02 USDC (per_request)
- Schema: https://energy.halowerk.com/signals/buy-sell/schema
- Example body:

```json
{}
```

### POST /bundle/trading

Energy-trading agents buy this endpoint to receive an eight-source market bundle with key metrics, insights, and raw evidence.

- Price: 0.02 USDC (per_request)
- Schema: https://energy.halowerk.com/bundle/trading/schema
- Example body:

```json
{
  "query": "Assess DE-LU day-ahead trading conditions for the next 24 hours."
}
```

### POST /history/prices

Stundendaten für EPEX-Preise nach Periode.

- Price: 0.05 USDC (per_request)
- Schema: https://energy.halowerk.com/history/prices/schema
- Example body:

```json
{
  "period": "last-7d"
}
```

### POST /history/prices/stats

Statistik für eine historische Preisperiode.

- Price: 0.01 USDC (per_request)
- Schema: https://energy.halowerk.com/history/prices/stats/schema
- Example body:

```json
{
  "period": "last-7d"
}
```

### POST /subscribe/price-alert

Webhook-Subscription für Strompreis-Thresholds.

- Price: 0.10 USDC (per_request)
- Schema: https://energy.halowerk.com/subscribe/price-alert/schema
- Example body:

```json
{
  "webhook_url": "https://agent.example/webhooks/energy"
}
```

### POST /subscribe/co2-low

Webhook-Subscription für niedrige CO2-Intensität.

- Price: 0.10 USDC (per_request)
- Schema: https://energy.halowerk.com/subscribe/co2-low/schema
- Example body:

```json
{
  "webhook_url": "https://agent.example/webhooks/energy"
}
```

### POST /optimizer/cheapest-window

Flexible-load agents buy this endpoint to schedule a contiguous operating window at the lowest average electricity price.

- Price: 0.005 USDC (per_request)
- Schema: https://energy.halowerk.com/optimizer/cheapest-window/schema
- Example body:

```json
{
  "duration_hours": 2
}
```

### POST /price/negative-forecast

Stunden mit negativen Strompreisen in den nächsten 24 Stunden.

- Price: 0.005 USDC (per_request)
- Schema: https://energy.halowerk.com/price/negative-forecast/schema
- Example body:

```json
{}
```

### POST /predict/negative-price

Battery, EV, and trading agents buy this endpoint to receive calibrated 2h/4h/6h negative-price probabilities, reviewed threshold profiles and an executable response policy.

- Price: 0.001 USDC (per_request)
- Schema: https://energy.halowerk.com/predict/negative-price/schema
- Example body:

```json
{
  "policy_profile": "balanced"
}
```

### POST /summary/today

Token-effiziente Tageszusammenfassung mit konkreter Handlungsempfehlung.

- Price: 0.01 USDC (per_request)
- Schema: https://energy.halowerk.com/summary/today/schema
- Example body:

```json
{}
```

### POST /region

Preis, CO2, Grünstrom und Wetter für eine PLZ-Region.

- Price: 0.005 USDC (per_request)
- Schema: https://energy.halowerk.com/region/schema
- Example body:

```json
{
  "plz": "48599"
}
```

### POST /events/grid

Ereignisfeed für Dunkelflaute, Sturm, negative Preise und Rekorde.

- Price: 0.005 USDC (per_request)
- Schema: https://energy.halowerk.com/events/grid/schema
- Example body:

```json
{}
```

## Contact

- Operator: Daniel Wesseling, Die Netzhandwerker, 48599 Gronau, Deutschland
- E-Mail: api@halowerk.com
- Legal notice: https://halowerk.com/impressum
- Missing capability: https://bedarf.halowerk.com/capabilities/request