{"uid":"cap_dNdJV2bRuXtR4kYtPKuiI","slug":"site-climate-solar-resource-monthly-sunlight-pv-yield-a45a3ec2","name":"Site Climate – Solar Resource (Monthly Sunlight & PV Yield)","description":"Monthly sunlight (peak sun hours) at a latitude and longitude, resource class, and optional solar PV yield for a system size.","url":"https://site-climate.x402tookit.com/solar-resource?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","description":"Latitude, -90 to 90"},"lon":{"type":"number","description":"Longitude, -180 to 180"},"systemKw":{"type":"number","description":"PV system size in kW, for a yield estimate"},"performanceRatio":{"type":"number","description":"System losses factor 0.5 to 0.95 (default 0.75)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"unit":{"type":["null","string"]},"period":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"latitude":{"type":["null","number"]},"bestMonth":{"type":["null","string"]},"longitude":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"pvEstimate":{"type":["null","object"],"properties":{"systemKw":{"type":["null","number"]},"annualKwh":{"type":["null","number"]},"monthlyKwh":{"type":["null","object"],"properties":{"May":{"type":["null","number"]},"July":{"type":["null","number"]},"June":{"type":["null","number"]},"April":{"type":["null","number"]},"March":{"type":["null","number"]},"August":{"type":["null","number"]},"January":{"type":["null","number"]},"October":{"type":["null","number"]},"December":{"type":["null","number"]},"February":{"type":["null","number"]},"November":{"type":["null","number"]},"September":{"type":["null","number"]}}},"kwhPerKwYear":{"type":["null","number"]},"averageKwhPerDay":{"type":["null","number"]},"performanceRatio":{"type":["null","number"]}}},"worstMonth":{"type":["null","string"]},"attribution":{"type":["null","string"]},"resourceClass":{"type":["null","string"]},"gridElevationM":{"type":["null","number"]},"bestToWorstRatio":{"type":["null","number"]},"annualPeakSunHours":{"type":["null","number"]},"monthlyPeakSunHours":{"type":["null","object"],"properties":{"May":{"type":["null","number"]},"July":{"type":["null","number"]},"June":{"type":["null","number"]},"April":{"type":["null","number"]},"March":{"type":["null","number"]},"August":{"type":["null","number"]},"January":{"type":["null","number"]},"October":{"type":["null","number"]},"December":{"type":["null","number"]},"February":{"type":["null","number"]},"November":{"type":["null","number"]},"September":{"type":["null","number"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oV5gd6RwvW8Yjj7jSnAbH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns monthly peak sun hours, solar resource class, and optional PV energy yield estimate for any latitude/longitude coordinate.","exampleAgentPrompt":"What are the monthly peak sun hours and solar resource class at latitude 33.45, longitude -112.07 in Phoenix, and if I install a 8 kW solar system there with a performance ratio of 0.80, how much electricity would it generate each year?","exampleUseCases":[{"title":"Rooftop solar feasibility check","prompt":"I'm thinking about putting solar panels on my house near Austin, Texas — coordinates 30.25 latitude, -97.75 longitude. Can you look up the monthly peak sun hours and tell me whether it's a good solar resource? Also estimate the annual kWh output for a 6 kW system with a performance ratio of 0.75."},{"title":"Off-grid cabin site assessment","prompt":"We're evaluating a remote site at 46.8 latitude, -121.7 longitude in Washington State for an off-grid solar setup. What's the solar resource class there, which month gets the most sun, and how many kilowatt-hours per year could we expect from a 3 kW system at a 0.70 performance ratio?"},{"title":"Solar farm location comparison","prompt":"I need the monthly peak sun hours and solar resource rating for a potential solar farm site at 35.5 latitude, 25.1 longitude in Crete, Greece. Also run the PV yield estimate for a 500 kW system using the default performance ratio so I can compare it to other candidate sites."}],"resultDescription":"Returns a structured object with monthly peak sun hours for all 12 months, the solar resource class (e.g. high, excellent), the best month for solar, the latitude and longitude echoed back, data source and disclaimer, and — when systemKw is provided — a pvEstimate object containing annual kWh and per-month kWh breakdown for the specified system size and performance ratio.","failureModes":["Latitude out of range (-90 to 90) or longitude out of range (-180 to 180) returns a validation error","Performance ratio outside 0.5–0.95 range may return an error or be clamped","Remote or oceanic coordinates with no underlying climate data may return degraded or null monthly values","Missing required lat or lon query parameters returns a 400-level error","systemKw not provided means pvEstimate field will be null in the response"],"whenToPreferThis":"Choose this endpoint when you need authoritative monthly solar irradiance data (peak sun hours) and solar resource classification for any geographic coordinate, especially when you also want a quick PV yield estimate without running a full energy simulation. It is ideal for site feasibility checks, comparing solar potential across locations, or pre-screening candidate sites. Prefer it over weather history endpoints when you specifically need solar resource metrics rather than general climate data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:47.725Z","isFirstParty":false,"canonicalSlug":"site-climate-solar-resource-monthly-sunlight-pv-yield-a45a3ec2"}