# HALOWERK ladewerk

> HALOWERK ladewerk liefert maschinenlesbare results gegen Zahlung nach x402.
> Netz Base Mainnet, Zahlungsmittel USDC, Empfänger 0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E.

## So wird bezahlt

1. Route ohne Zahlungskopf aufrufen. Die Antwort ist 402 und trägt accepts, description und inputSchema.
2. Bedingungen mit einem x402-Client signieren.
3. Repeat the call with the proof in the PAYMENT-SIGNATURE header.

Eine 402-Antwort kostet nichts und löst keine Arbeit aus. Scheitert die Arbeit,
trägt die Antwort charged=false und es wird nicht abgerechnet.

## Endpunkte

### POST /v1/nearby

OSM-Ladepunkte im Umkreis von 0,1 bis 50 km: Koordinaten, Entfernung, Steckertypen, Zugang, Betreiber, Öffnungszeiten und Gebühren, soweit getaggt. Fahrradtags sind Voraussetzung; unbestätigte Schuko-Punkte können ausdrücklich zugeschaltet werden. Keine aktuelle Belegungsprüfung.

- Preis: 0.005 USDC
- MCP-Werkzeug: `charging_nearby`
- Eingabe: `["lat","lon","radius_km","connector","include_unconfirmed","limit"]`

### POST /v1/route

Eine zusammenhängende Route als points, Google-Polyline (Genauigkeit 5 oder 6) oder GPX-Track/Route. Bis 300 km, 2000 Punkte und 20.000 km² Suchfläche. Ladepunkte im Korridor von 50 bis 5000 m mit Fortschritt und Luftlinien-Abstand. Kein Routing oder Map-Matching.

- Preis: 0.010 USDC
- MCP-Werkzeug: `charging_along_route`
- Eingabe: `["points","polyline","polyline_precision","gpx","corridor_m","connector","include_unconfirmed","limit"]`

### POST /v1/detail

OSM-Objektkennung node/123, way/123 oder relation/123: Steckertypen, Akku-Schließfach, Kapazität, Öffnungszeiten, Gebühren, Betreiber, Zugang, Roh-Tags, Änderungsdatum und Quellenstand. Nicht erfasste Angaben bleiben null. Keine Live-Verfügbarkeit.

- Preis: 0.003 USDC
- MCP-Werkzeug: `charging_detail`
- Eingabe: `["id"]`

### POST /v1/range

Akku in Wh, Verbrauch in Wh/km, Startladung und Reserve sowie points, Polyline oder GPX. Liefert ein vereinfachtes Energiemodell mit Ladehalten an OSM-getaggten E-Bike-Punkten und passendem Stecker (Vorgabe Schuko). Vollladung je Halt angenommen. Luftlinien-Abstecher, keine Garantie von Betrieb, Öffnung oder Befahrbarkeit.

- Preis: 0.010 USDC
- MCP-Werkzeug: `charging_range_check`
- Eingabe: `["points","polyline","polyline_precision","gpx","corridor_m","connector","battery_wh","wh_per_km","start_percent","reserve_percent"]`

## Weitere Flächen

- OpenAPI: https://lade.halowerk.com/openapi.json
- Preise: https://lade.halowerk.com/pricing
- x402-Manifest: https://lade.halowerk.com/.well-known/x402
- Bazaar: https://lade.halowerk.com/.well-known/x402/bazaar
- MCP: https://lade.halowerk.com/mcp


## Missing a capability?

If you looked for something this service does not offer, say so.
One call, no payment, no sign-up, no account:

  POST https://bedarf.halowerk.com/capabilities/request
  Content-Type: application/json
  {"requested_capability": "what you would buy",
   "description": "the use case, one sentence",
   "callback_url": "optional - we call back once it exists"}

Only requested_capability is required, 3 to 160 characters.
Schema and status: https://bedarf.halowerk.com/openapi.json
Submissions are held for review and are never published verbatim.