{"openapi":"3.1.0","info":{"title":"Solar Resource API","version":"1.0.0","description":"Solar irradiance and agroclimatology for any location on Earth — as an API over NASA POWER (Prediction Of Worldwide Energy Resources), derived from NASA satellite and reanalysis data. Get the solar resource needed to size and assess PV and CSP systems: global (GHI), direct-normal (DNI) and diffuse horizontal irradiance, clear-sky irradiance and the clearness index — either as long-term monthly climatology normals for quick site assessment, or as a daily time series for a date range (1981-present). The same call also serves meteorology — temperature, wind speed, relative humidity and precipitation — making it ideal for solar energy, agriculture, building-energy modelling and climate work. From cloudy Berlin to the Sahara, it turns a coordinate into bankable solar and climate data. A solar-resource / agroclimatology data source — distinct from PV-system energy simulation (PVGIS) and historical-weather records. Open data from NASA POWER.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/solar-api","description":"oanor gateway"}],"tags":[{"name":"Solar"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/climatology":{"get":{"operationId":"get_v1_climatology","tags":["Solar"],"summary":"Long-term monthly solar & climate normals","description":"","parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude","schema":{"type":"string"},"example":"52.52"},{"name":"lon","in":"query","required":false,"description":"Longitude","schema":{"type":"string"},"example":"13.41"},{"name":"params","in":"query","required":false,"description":"Parameters (comma-separated)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"climatology","location":{"lat":52.52,"lon":13.41},"parameters":{"T2M":{"name":"Temperature at 2 m","units":"C","monthly":{"ANN":9.68,"APR":9.13,"AUG":19.92,"DEC":0.86,"FEB":0.4,"JAN":-0.73,"JUL":20.47,"JUN":18.26,"MAR":3.74,"MAY":14.05,"NOV":4.56,"OCT":9.66,"SEP":15.28}},"RH2M":{"name":"Relative humidity 2 m","units":"%","monthly":{"ANN":79.79,"APR":77.46,"AUG":66.18,"DEC":94.15,"FEB":90.48,"JAN":93.7,"JUL":65,"JUN":65.98,"MAR":85.08,"MAY":72.78,"NOV":92.16,"OCT":83.25,"SEP":71.83}},"WS10M":{"name":"Wind speed at 10 m","units":"m/s","monthly":{"ANN":4.51,"APR":4.32,"AUG":3.91,"DEC":5.1,"FEB":5.03,"JAN":5.24,"JUL":4.09,"JUN":4.19,"MAR":4.85,"MAY":4.21,"NOV":4.6,"OCT":4.44,"SEP":4.14}},"PRECTOTCORR":{"name":"Precipitation (corrected)","units":"mm/day","monthly":{"ANN":1.65,"APR":0.95,"AUG":1.87,"DEC":1.55,"FEB":1.36,"JAN":1.75,"JUL":2.6,"JUN":1.89,"MAR":1.3,"MAY":1.71,"NOV":1.62,"OCT":1.57,"SEP":1.62}},"ALLSKY_SFC_SW_DWN":{"name":"Global horizontal irradiance (GHI)","units":"kW-hr/m^2/day","monthly":{"ANN":2.8318,"APR":4.0358,"AUG":4.2439,"DEC":0.4817,"FEB":1.3474,"JAN":0.6442,"JUL":4.9445,"JUN":5.2846,"MAR":2.4415,"MAY":4.8814,"NOV":0.787,"OCT":1.7153,"SEP":3.1027}}}},"meta":{"timestamp":"2026-06-01T17:03:18.484Z","request_id":"5f70791b-b64a-42b4-8c9f-111a86410316"},"status":"ok","message":"Climatology retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/solar":{"get":{"operationId":"get_v1_solar","tags":["Solar"],"summary":"Daily solar irradiance over a date range","description":"","parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude","schema":{"type":"string"},"example":"52.52"},{"name":"lon","in":"query","required":false,"description":"Longitude","schema":{"type":"string"},"example":"13.41"},{"name":"start","in":"query","required":false,"description":"Start date YYYYMMDD (1981+)","schema":{"type":"string"},"example":"20230601"},{"name":"end","in":"query","required":false,"description":"End date YYYYMMDD (<=366 days)","schema":{"type":"string"},"example":"20230831"},{"name":"params","in":"query","required":false,"description":"Parameters (comma-separated)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"end":"20230831","start":"20230601","location":{"lat":52.52,"lon":13.41},"parameters":{"ALLSKY_KT":{"name":"Clearness index","daily":{"20230601":0.64,"20230602":0.57,"20230603":0.72,"20230604":0.68,"20230605":0.64,"20230606":0.38,"20230607":0.48,"20230608":0.48,"20230609":0.58,"20230610":0.53,"20230611":0.63,"20230612":0.61,"20230613":0.57,"20230614":0.44,"20230615":0.4,"20230616":0.27,"20230617":0.39,"20230618":0.56,"20230619":0.31,"20230620":0.31,"20230621":0.49,"20230622":0.48,"20230623":0.08,"20230624":0.64,"20230625":0.4,"20230626":0.49,"20230627":0.48,"20230628":0.52,"20230629":0.39,"20230630":0.15,"20230701":0.4,"20230702":0.47,"20230703":0.42,"20230704":0.48,"20230705":0.39,"20230706":0.47,"20230707":0.66,"20230708":0.67,"20230709":0.62,"20230710":0.42,"20230711":0.63,"20230712":0.47,"20230713":0.5,"20230714":0.54,"20230715":0.53,"20230716":0.56,"20230717":0.53,"20230718":0.56,"20230719":0.37,"20230720":0.41,"20230721":0.28,"20230722":0.45,"20230723":0.34,"20230724":0.42,"20230725":0.43,"20230726":0.48,"20230727":0.29,"20230728":0.35,"20230729":0.32,"20230730":0.46,"20230731":0.24,"20230801":0.35,"20230802":0.4,"20230803":0.37,"20230804":0.46,"20230805":0.44,"20230806":0.22,"20230807":0.39,"20230808":0.4,"20230809":0.49,"20230810":0.53,"20230811":0.54,"20230812":0.32,"20230813":0.52,"20230814":0.54,"20230815":0.55,"20230816":0.45,"20230817":0.37,"20230818":0.59,"20230819":0.63,"20230820":0.57,"20230821":0.5,"20230822":0.35,"20230823":0.54,"20230824":0.54,"20230825":0.39,"20230826":0.46,"20230827":0.24,"20230828":0.41,"20230829":0.18,"20230830":0.38,"20230831":0.44},"units":"dimensionless"},"ALLSKY_SFC_SW_DNI":{"name":"Direct normal irradiance (DNI)","daily":{"20230601":8.1072,"20230602":6.5206,"20230603":10.4527,"20230604":9.2114,"20230605":7.6291,"20230606":2.3304,"20230607":3.0931,"20230608":3.744,"20230609":6.1812,"20230610":5.3364,"20230611":7.7398,"20230612":6.5609,"20230613":5.7773,"20230614":3.5378,"20230615":1.691,"20230616":0.655,"20230617":1.8838,"20230618":6.1298,"20230619":0.9084,"20230620":0.9874,"20230621":2.5877,"20230622":3.0084,"20230623":0.0571,"20230624":7.878,"20230625":2.442,"20230626":4.5746,"20230627":4.7078,"20230628":4.1923,"20230629":2.0244,"20230630":0.0478,"20230701":2.003,"20230702":4.0075,"20230703":2.5582,"20230704":3.9209,"20230705":2.7089,"20230706":4.0138,"20230707":8.8176,"20230708":9.2081,"20230709":7.2542,"20230710":2.6314,"20230711":6.8402,"20230712":3.7162,"20230713":3.7963,"20230714":4.5905,"20230715":4.9488,"20230716":5.4619,"20230717":4.6819,"20230718":5.2632,"20230719":1.4465,"20230720":2.9556,"20230721":0.5261,"20230722":1.9706,"20230723":0.2726,"20230724":1.9759,"20230725":1.6366,"20230726":2.6436,"20230727":1.1093,"20230728":1.8648,"20230729":0.9293,"20230730":2.4766,"20230731":0.3326,"20230801":1.5226,"20230802":2.3798,"20230803":2.0645,"20230804":3.3218,"20230805":1.5559,"20230806":0,"20230807":0.6403,"20230808":1.7882,"20230809":3.1142,"20230810":3.9826,"20230811":5.2498,"20230812":1.3982,"20230813":2.8891,"20230814":4.097,"20230815":5.1871,"20230816":3.9194,"20230817":1.8883,"20230818":5.6609,"20230819":6.6622,"20230820":5.3777,"20230821":3.816,"20230822":1.4849,"20230823":4.5091,"20230824":3.8275,"20230825":1.753,"20230826":2.9095,"20230827":0.0204,"20230828":0.9029,"20230829":0.131,"20230830":0.7704,"20230831":2.1307},"units":"kW-hr/m^2/day"},"ALLSKY_SFC_SW_DWN":{"name":"Global horizontal irradiance (GHI)","daily":{"20230601":7.2583,"20230602":6.4255,"20230603":8.0923,"20230604":7.662,"20230605":7.314,"20230606":4.3399,"20230607":5.4602,"20230608":5.5202,"20230609":6.6523,"20230610":6.1039,"20230611":7.2458,"20230612":7.0378,"20230613":6.5854,"20230614":5.0374,"20230615":4.5768,"20230616":3.0646,"20230617":4.553,"20230618":6.5138,"20230619":3.5311,"20230620":3.5383,"20230621":5.6117,"20230622":5.5342,"20230623":0.9636,"20230624":7.398,"20230625":4.561,"20230626":5.6839,"20230627":5.5171,"20230628":5.9551,"20230629":4.4746,"20230630":1.7474,"20230701":4.5869,"20230702":5.4173,"20230703":4.758,"20230704":5.4881,"20230705":4.4688,"20230706":5.3779,"20230707":7.5192,"20230708":7.614,"20230709":7.0022,"20230710":4.7328,"20230711":7.0138,"20230712":5.3038,"20230713":5.5802,"20230714":6.0223,"20230715":5.9218,"20230716":6.1649,"20230717":5.808,"20230718":6.1099,"20230719":4.0406,"20230720":4.5084,"20230721":3.0559,"20230722":4.8845,"20230723":3.6108,"20230724":4.4484,"20230725":4.5257,"20230726":5.1204,"20230727":3.0833,"20230728":3.6206,"20230729":3.3204,"20230730":4.7774,"20230731":2.4343,"20230801":3.5736,"20230802":4.0594,"20230803":3.7896,"20230804":4.6543,"20230805":4.4424,"20230806":2.2346,"20230807":3.883,"20230808":3.9569,"20230809":4.7594,"20230810":5.1355,"20230811":5.2572,"20230812":3.036,"20230813":4.9805,"20230814":5.1204,"20230815":5.1523,"20230816":4.2199,"20230817":3.3732,"20230818":5.3945,"20230819":5.6933,"20230820":5.113,"20230821":4.4945,"20230822":3.1356,"20230823":4.7614,"20230824":4.7004,"20230825":3.3487,"20230826":3.9814,"20230827":2.011,"20230828":3.4474,"20230829":1.5346,"20230830":3.1459,"20230831":3.5743},"units":"kW-hr/m^2/day"},"CLRSKY_SFC_SW_DWN":{"name":"Clear-sky GHI","daily":{"20230601":7.9186,"20230602":8.118,"20230603":8.2512,"20230604":7.6788,"20230605":7.5098,"20230606":7.1832,"20230607":7.1371,"20230608":7.0469,"20230609":7.2622,"20230610":7.3411,"20230611":7.6958,"20230612":7.6435,"20230613":7.5497,"20230614":7.4244,"20230615":7.3656,"20230616":7.2079,"20230617":7.2984,"20230618":7.3289,"20230619":6.3734,"20230620":6.7783,"20230621":7.1705,"20230622":7.1626,"20230623":6.2952,"20230624":7.8211,"20230625":7.447,"20230626":7.0126,"20230627":7.9308,"20230628":7.7642,"20230629":7.5996,"20230630":5.628,"20230701":7.345,"20230702":7.8293,"20230703":7.5446,"20230704":7.3572,"20230705":7.3495,"20230706":7.4112,"20230707":7.6188,"20230708":7.6625,"20230709":7.1897,"20230710":6.3031,"20230711":7.5175,"20230712":6.9499,"20230713":7.0843,"20230714":6.9696,"20230715":7.249,"20230716":7.5437,"20230717":7.1911,"20230718":7.4482,"20230719":6.4414,"20230720":7.0898,"20230721":6.5306,"20230722":6.9605,"20230723":6.2988,"20230724":6.792,"20230725":6.7658,"20230726":7.0243,"20230727":6.7421,"20230728":6.8482,"20230729":6.601,"20230730":6.5858,"20230731":6.5928,"20230801":6.7963,"20230802":6.8196,"20230803":6.919,"20230804":6.695,"20230805":6.3209,"20230806":5.8711,"20230807":6.4226,"20230808":6.6367,"20230809":6.6708,"20230810":6.5578,"20230811":6.4522,"20230812":6.1399,"20230813":6.1594,"20230814":5.9458,"20230815":5.7502,"20230816":5.9957,"20230817":5.3573,"20230818":5.6453,"20230819":5.8042,"20230820":5.5879,"20230821":5.4979,"20230822":5.1686,"20230823":5.394,"20230824":5.4257,"20230825":5.07,"20230826":5.6182,"20230827":4.9963,"20230828":5.5536,"20230829":4.6642,"20230830":4.8226,"20230831":5.3909},"units":"kW-hr/m^2/day"},"ALLSKY_SFC_SW_DIFF":{"name":"Diffuse horizontal irradiance","daily":{"20230601":1.9063,"20230602":2.5728,"20230603":1.7198,"20230604":1.6646,"20230605":2.1132,"20230606":2.6028,"20230607":2.993,"20230608":2.6354,"20230609":2.3326,"20230610":2.5334,"20230611":2.1475,"20230612":2.5918,"20230613":2.6621,"20230614":2.6808,"20230615":3.1272,"20230616":2.2877,"20230617":2.9297,"20230618":2.3522,"20230619":2.5644,"20230620":2.6177,"20230621":3.5849,"20230622":3.1517,"20230623":0.8002,"20230624":2.0237,"20230625":2.946,"20230626":2.255,"20230627":2.7182,"20230628":3.192,"20230629":3.0864,"20230630":1.4501,"20230701":2.9441,"20230702":2.8337,"20230703":2.9482,"20230704":2.8855,"20230705":2.7012,"20230706":2.8675,"20230707":1.7806,"20230708":1.6639,"20230709":2.1084,"20230710":2.6515,"20230711":2.6062,"20230712":2.5922,"20230713":3.0545,"20230714":2.8358,"20230715":2.447,"20230716":2.6146,"20230717":2.683,"20230718":2.7914,"20230719":2.9376,"20230720":2.6275,"20230721":2.4936,"20230722":3.4661,"20230723":2.969,"20230724":3.0938,"20230725":3.0535,"20230726":3.3382,"20230727":2.3897,"20230728":2.237,"20230729":2.5759,"20230730":3.06,"20230731":1.9608,"20230801":2.4437,"20230802":2.4866,"20230803":2.4055,"20230804":2.6674,"20230805":3.337,"20230806":1.8828,"20230807":3.1164,"20230808":2.5882,"20230809":2.8819,"20230810":2.8147,"20230811":2.0467,"20230812":2.1257,"20230813":3.1694,"20230814":2.5409,"20230815":1.9188,"20230816":1.9474,"20230817":2.1127,"20230818":1.8655,"20230819":1.6356,"20230820":1.7724,"20230821":2.2836,"20230822":2.2032,"20230823":2.1245,"20230824":2.4074,"20230825":2.1689,"20230826":2.1185,"20230827":1.709,"20230828":2.7146,"20230829":1.2629,"20230830":2.4624,"20230831":2.2526},"units":"kW-hr/m^2/day"}}},"meta":{"timestamp":"2026-06-01T17:03:19.428Z","request_id":"0e58522b-0b9b-4f15-b119-78584997b907"},"status":"ok","message":"Solar resource retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Parameters, units & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"NASA POWER provides solar-resource and meteorological data for any point on Earth, derived from NASA satellite and reanalysis data. /v1/climatology?lat=52.5&lon=13.4 returns long-term monthly climatology normals (and an annual value) — by default GHI (solar irradiance), temperature, wind, humidity and precipitation — ideal for solar-site assessment and agroclimatology; choose parameters with params=ALLSKY_SFC_SW_DWN,T2M,WS10M,… /v1/solar?lat=52.5&lon=13.4&start=20230601&end=20230831 returns the daily series over a range (up to 366 days), defaulting to the solar-resource set: global (GHI), direct-normal (DNI) and diffuse irradiance, clear-sky GHI and the clearness index — the raw resource data for sizing PV and CSP systems. Values are kWh/m²/day for irradiance, °C for temperature, m/s for wind, % for humidity and mm/day for precipitation; missing values are null. Daily data spans 1981-present. Data from NASA POWER (freely available). A solar-resource / agroclimatology data source — distinct from PV-system energy simulation (PVGIS) and historical-weather records. Ideal for solar energy, agriculture, building-energy and climate applications.","source":"NASA POWER — Prediction Of Worldwide Energy Resources (power.larc.nasa.gov)","endpoints":["/v1/climatology","/v1/solar","/v1/meta"],"parameters":{"T2M":"Temperature at 2 m","RH2M":"Relative humidity 2 m","WS10M":"Wind speed at 10 m","WS50M":"Wind speed at 50 m","T2M_MAX":"Max temperature 2 m","T2M_MIN":"Min temperature 2 m","ALLSKY_KT":"Clearness index","PRECTOTCORR":"Precipitation (corrected)","ALLSKY_SFC_SW_DNI":"Direct normal irradiance (DNI)","ALLSKY_SFC_SW_DWN":"Global horizontal irradiance (GHI)","CLRSKY_SFC_SW_DWN":"Clear-sky GHI","ALLSKY_SFC_SW_DIFF":"Diffuse horizontal irradiance"}},"meta":{"timestamp":"2026-06-01T17:03:19.510Z","request_id":"413258a1-0883-4706-8514-1d643f6feba3"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2320,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":665,"monthly_call_quota":46500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2140,"monthly_call_quota":233000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5750,"monthly_call_quota":840000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/solar-api"}