{"uid":"cap_13KGvSJkgXxOYMabRJSVF","slug":"halowerk-building-heat-demand-estimator-6c91e1c9","name":"Halowerk Building Heat Demand Estimator","description":"Computes a transparent planning estimate for space-heating demand. The method is not DIN, VDI, GEG or PHPP and must not be used as regulatory proof. It combines transmission heat loss from each envelope component, ventilation heat loss from heated volume and air changes, monthly heating degree days from the nearest DWD 1991-2020 temperature-normal station, stated internal gains and optional domestic hot water.","url":"https://solar.halowerk.com/building-heat-demand","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","maximum":56,"minimum":47,"description":"Latitude in Germany; the DWD normal dataset used here covers Germany."},"lon":{"type":"number","maximum":16,"minimum":5},"profile":{"type":"object","properties":{"indoor_temp_c":{"type":"number","default":20,"maximum":30,"minimum":5},"internal_gains_w":{"type":"number","default":0,"maximum":100000,"minimum":0},"heating_base_temp_c":{"type":"number","default":15,"maximum":25,"minimum":0}},"additionalProperties":false},"envelope":{"type":"array","items":{"type":"object","required":["name","area_m2","u_value_w_m2k"],"properties":{"name":{"type":"string","maxLength":80,"minLength":1},"area_m2":{"type":"number","maximum":100000,"minimum":0.1},"u_value_w_m2k":{"type":"number","maximum":8,"minimum":0.01}},"additionalProperties":false},"maxItems":40,"minItems":1},"ventilation":{"type":"object","properties":{"air_changes_per_hour":{"type":"number","default":0.5,"maximum":5,"minimum":0},"heat_recovery_efficiency":{"type":"number","default":0,"maximum":0.95,"minimum":0}},"additionalProperties":false},"heated_volume_m3":{"type":"number","maximum":1000000,"minimum":10},"system_efficiency":{"type":"number","default":1,"maximum":1.5,"minimum":0.5},"thermal_bridge_w_k":{"type":"number","default":0,"maximum":100000,"minimum":0},"heated_floor_area_m2":{"type":"number","maximum":100000,"minimum":5},"max_station_distance_km":{"type":"number","default":80,"maximum":200,"minimum":1},"domestic_hot_water_kwh_year":{"type":"number","default":0,"maximum":1000000,"minimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a-UaZH78l-OhwKiO83tOW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a transparent planning estimate of annual and monthly space-heating demand for a building in Germany, combining envelope transmission losses, ventilation losses, DWD climate normals, internal gains, and optional DHW.","exampleAgentPrompt":"Estimate the annual space-heating demand for my house near Munich (lat 48.1, lon 11.6) — it has 280 m³ heated volume, 120 m² floor area, and four envelope components: 80 m² roof at U=0.2, 120 m² walls at U=0.35, 30 m² windows at U=1.3, and 80 m² floor at U=0.4; ventilation is 0.5 ACH with no heat recovery, indoor target 20°C, and I'd also like to include 1800 kWh/year for domestic hot water.","exampleUseCases":[{"title":"Sizing a heat pump for a new build","prompt":"I'm planning a new single-family house near Freiburg (lat 47.99, lon 7.85) with 350 m³ heated volume, 140 m² floor area — walls are 150 m² at U=0.25, roof 90 m² at U=0.15, windows 25 m² at U=1.1, floor 90 m² at U=0.3. Ventilation is 0.4 ACH with 75% heat recovery. Can you calculate the annual and monthly heating demand so I can size the heat pump correctly?"},{"title":"Comparing insulation retrofit scenarios","prompt":"My Berlin apartment block (lat 52.5, lon 13.4) has 1200 m³ heated volume and 480 m² floor area. Current envelope: 600 m² walls at U=1.2, 250 m² roof at U=0.8, 80 m² windows at U=2.8, 250 m² floor at U=0.9, 0.6 ACH ventilation. What's the annual heating demand, and then recalculate after a retrofit to walls U=0.25, roof U=0.2, windows U=1.1 so I can compare the energy savings?"},{"title":"Checking heating demand for energy certificate prep","prompt":"For a small office building near Cologne (lat 50.93, lon 6.96) with 800 m³ heated volume, 300 m² floor area, envelope: 400 m² facade at U=0.45, 200 m² roof at U=0.2, 100 m² glazing at U=1.5, 200 m² slab at U=0.35; internal gains of 5000 W, ventilation 1.2 ACH with 60% heat recovery — give me a monthly heating demand breakdown so I can prepare for an energy consultation."}],"resultDescription":"Returns a month-by-month and annual heating demand breakdown in kWh, split into transmission losses (per envelope component), ventilation losses, and domestic hot water; includes the DWD climate station used, its distance, heating degree days per month, and total annual heating energy demand adjusted for system efficiency.","failureModes":["Coordinates outside Germany (lat 47–56, lon 5–16) → validation error, no DWD station available","No DWD station within max_station_distance_km → error indicating nearest station is too far","Envelope array empty or missing required fields (name, area_m2, u_value_w_m2k) → schema validation error","heated_volume_m3 below minimum (10 m³) or above maximum → validation error","u_value_w_m2k out of range (0.01–8) → validation error","Payment not included or insufficient (requires $0.004 USDC via x402) → 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a fast, transparent heating energy estimate for a building in Germany using actual DWD 1991–2020 climate normals, and you can supply envelope U-values and geometry. It is not a regulatory calculation (not DIN 4108, VDI, GEG, or PHPP-compliant) but is well-suited for early-stage design comparisons, retrofit scenario analysis, or sizing heating systems where a quick physics-based estimate is sufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:35:58.982Z","isFirstParty":false}