{"uid":"cap_X4I6bzrNa17y6mprSZXrn","slug":"tbs-weather-climate-api-solar-radiation-irradiance-forecast-aa108767","name":"TBS Weather & Climate API — Solar Radiation & Irradiance Forecast","description":"Solar radiation and irradiance forecast for any lat/lon. Returns shortwave (global horizontal) and direct radiation in W/m2 and sunshine duration. For solar energy production forecasting, photovoltaic (PV) yield estimation and renewable-energy planning agents.","url":"https://x402.tbs-digital.com/weather/solar?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","properties":{"lat":{"type":"number","description":"Latitude -90..90 (requires lon)"},"lon":{"type":"number","description":"Longitude -180..180 (requires lat)"},"city":{"type":"string","description":"City name (alternative to lat/lon)"},"timezone":{"type":"string","description":"Optional IANA timezone"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"solar":{"type":"object"},"source":{"type":"string"},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"name":{"type":"string"},"country":{"type":"string"}}},"timezone":{"type":"string"},"request_id":{"type":"string"},"generated_at":{"type":"string"},"utc_offset_seconds":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"solar":{"sunshine_duration_s":39600,"direct_radiation_wm2":410,"shortwave_radiation_wm2":512,"direct_normal_irradiance_wm2":620,"global_tilted_irradiance_wm2":545},"source":"open-meteo","location":{"lat":48.85,"lon":2.35,"name":"Paris","country":"FR"},"timezone":"Europe/Paris","request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-09T12:00:00.000Z","utc_offset_seconds":7200}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ALzKsh6qS5VyuDSl4RSGq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns shortwave (global horizontal) and direct normal irradiance (W/m²) and sunshine duration forecasts for any latitude/longitude or city, for solar energy and PV yield estimation.","exampleAgentPrompt":"What's the solar radiation forecast for Austin, Texas — give me the shortwave global horizontal and direct irradiance in W/m² so I can estimate how much power my rooftop solar panels will generate this week?","exampleUseCases":[{"title":"Rooftop PV yield estimation","prompt":"I've got a 10kW solar panel system on my roof in Phoenix, Arizona — can you pull the solar irradiance forecast for Phoenix so I can estimate how much electricity I'll generate over the next few days?"},{"title":"Solar farm site assessment","prompt":"We're evaluating a location at latitude 36.7, longitude -119.8 for a utility-scale solar farm. Can you get me the shortwave and direct radiation forecast so our engineers can run yield projections?"},{"title":"Renewable energy portfolio monitoring","prompt":"Pull the solar radiation and sunshine duration forecast for Berlin, Germany for the next week — I need to update our renewable energy generation estimates for our portfolio report."}],"resultDescription":"A JSON object containing a solar forecast keyed by datetime, with shortwave (global horizontal) irradiance and direct radiation values in W/m², sunshine duration, location details (lat, lon, name, country), timezone, UTC offset, a unique request_id, and generation timestamp. Optionally includes payer address and network for x402 payment tracking.","failureModes":["Missing both lat/lon and city — returns error requiring at least one location input","Invalid latitude (outside -90..90) or longitude (outside -180..180) — returns validation error","Unrecognized city name — may return empty results or geocoding failure","Invalid IANA timezone string — may cause timezone parsing error","Payment failure via x402 protocol — request rejected before data is returned","Upstream weather model unavailability — may return 503 or empty solar data"],"whenToPreferThis":"Choose this endpoint when you specifically need solar radiation and irradiance data (shortwave, direct, sunshine duration) for PV yield modeling, solar farm planning, or renewable energy forecasting. Prefer it over general weather endpoints when the primary need is energy-oriented solar metrics rather than temperature, wind, or precipitation. It is especially suitable for agents building photovoltaic production forecasts or comparing solar potential across geographic locations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:48:36.627Z","isFirstParty":false,"canonicalSlug":"tbs-weather-climate-api-solar-radiation-irradiance-forecast-aa108767"}