{"uid":"cap_T14qMHrp6SVI8nzEOF5ZD","slug":"halowerk-solar-clear-sky-yield-calculator-1596abd5","name":"Halowerk Solar Clear-Sky Yield Calculator","description":"This is an astronomical and geometric calculation, not a forecast. It assumes a cloudless sky and states the models used; real yield is lower whenever there is cloud, haze, snow, soiling or high cell temperature. The system_derate factor covers cabling, controller and temperature losses as one flat number and defaults to 0.8. Shading is not modelled here. Times are UTC. Use the figure as an upper bound for sizing, not as an expected daily production.","url":"https://solar.halowerk.com/clear-sky-yield","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"date":{"type":"string","description":"Day as YYYY-MM-DD."},"albedo":{"type":"number","default":0.2,"maximum":1,"minimum":0},"panel_wp":{"type":"number","default":415,"maximum":100000,"minimum":1,"description":"Module rating at standard test conditions."},"tilt_deg":{"type":"number","default":30,"maximum":90,"minimum":0},"azimuth_deg":{"type":"number","default":180,"maximum":360,"minimum":0,"description":"Module azimuth, 180 is south, 0 is north."},"elevation_m":{"type":"number","default":0,"maximum":6000,"minimum":-500},"step_minutes":{"type":"integer","default":15,"maximum":60,"minimum":5},"system_derate":{"type":"number","default":0.8,"maximum":1,"minimum":0.1},"include_series":{"type":"boolean","default":true}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_apF3zVAwEwEaIeDyLMwA6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the theoretical maximum daily solar energy yield for a single PV panel under cloudless-sky conditions using astronomical and geometric models, returning hourly/sub-hourly irradiance and integrated energy output.","exampleAgentPrompt":"Calculate the clear-sky solar yield for a 415W panel at latitude 48.85, longitude 2.35 on 2025-07-15, tilted 30 degrees facing south (azimuth 180), at ground level, using a system derate of 0.8, and include the 15-minute power series.","exampleUseCases":[{"title":"Off-grid cabin battery sizing","prompt":"I'm designing an off-grid solar system for a cabin at latitude 46.5, longitude -121.7 — can you calculate the theoretical maximum daily yield for a 415W panel on June 21st, tilted 35 degrees facing south, with the default derate factor, so I can size the battery bank?"},{"title":"Solar RV trip energy planning","prompt":"My RV has a 200W solar panel mounted flat (0 degree tilt, azimuth 180) at latitude 36.1, longitude -115.2. What's the clear-sky energy output for August 10th at 1000m elevation, stepping every 15 minutes, so I can see when peak production hits during the day?"},{"title":"Comparing panel orientations for rooftop install","prompt":"I want to compare east-facing vs south-facing solar panel output — can you run the clear-sky yield calculation for a 415W panel at latitude 51.5, longitude -0.12 on September 22nd, first with azimuth 90 degrees and tilt 30, then with azimuth 180 and tilt 30, using 0.75 system derate?"}],"resultDescription":"Returns a computed clear-sky daily energy yield in watt-hours for the specified panel, plus an optional time-series of per-step plane-of-array irradiance and instantaneous power values at the requested resolution (default 15-minute intervals). The result represents a theoretical upper bound assuming perfectly clear skies; real yield will be lower due to clouds, soiling, shading, and temperature effects.","failureModes":["Invalid latitude/longitude values outside allowed ranges return validation errors","Date strings not in YYYY-MM-DD format are rejected","panel_wp below 1 or above 100,000 causes schema validation failure","system_derate outside 0.1–1.0 range is rejected","Polar locations near solstice extremes may produce edge-case irradiance results","elevation_m outside -500 to 6000m range causes rejection","step_minutes below 5 or above 60 is invalid"],"whenToPreferThis":"Choose this endpoint when you need a fast, physics-based upper-bound estimate of daily solar yield for panel sizing, off-grid system design, or feasibility studies — especially when you have precise GPS coordinates, panel specs, and a specific date. It is not a weather forecast and does not account for clouds or shading, so use it as a planning ceiling rather than a production forecast. Prefer this over weather-coupled irradiance APIs when you want a deterministic, repeatable geometric baseline without needing real-time meteorological data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:47.692Z","isFirstParty":false}