# 2s.io Solar Irradiance & PV-Yield Forecast

> 2s.io Solar Irradiance & PV-Yield Forecast is a paid API for AI agents from 2s.io, paid per call via x402, $0.0036/call, status unknown (last checked 2026-10-14).

Returns a 1–16 day daily solar forecast (GHI, peak sun hours, sunshine hours, estimated kWp yield) for any global coordinate

## Facts

- Endpoint: GET https://2s.io/api/energy/solar-forecast?utm_source=zero.xyz
- Price: $0.0036/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-solar-irradiance-pv-yield-forecast-67c47545
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xNNGKfYKd--F7v5OmQgjV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-solar-irradiance-pv-yield-forecast-67c47545
```

Example prompt: Can you give me a 7-day solar irradiance and estimated PV yield forecast for latitude 34.05, longitude -118.25 — I want to know peak sun hours and how many kWh per kWp I can expect each day?

## When to prefer this

Choose this endpoint when you need short-term (1–16 day) daily solar forecasts for any global location, especially for rooftop solar yield estimation, agrivoltaic planning, or EV charge scheduling. Prefer over NREL energy.solar-resource when you need forward-looking forecasts (not long-run historical averages) and when the location is outside the US or you need near-term operational planning data.

## Known failure modes

- Missing required latitude or longitude returns a 400 error
- Latitude outside -90 to 90 or longitude outside -180 to 180 returns validation error
- Days parameter exceeding 16 or below 1 returns a schema validation error
- Payment failure (x402) if USDC balance insufficient
- Upstream forecast model unavailable may return 503 or empty data
- Coordinates over ocean or polar regions may have reduced data quality

## How this service works

Solar irradiance + PV-yield forecast for any coordinate (free/keyless, global). Returns a daily 1-16 day forecast: GHI (kWh/m²), peak sun hours, sunshine hours, and estimated yield per kWp of panels (at a 0.75 performance ratio). For rooftop-solar planning, agrivoltaics, and EV-charge scheduling. Complements energy.solar-resource (NREL long-run averages, US).

## Output

A daily array of up to 16 days of solar data for the given coordinate, including GHI (kWh/m²), peak sun hours, sunshine hours, and estimated PV yield per kWp of installed panels (at 0.75 performance ratio)

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "latitude",
      "longitude"
     ],
     "properties": {
      "days": {
       "type": "integer",
       "maximum": 16,
       "minimum": 1
      },
      "latitude": {
       "type": "number",
       "maximum": 90,
       "minimum": -90
      },
      "longitude": {
       "type": "number",
       "maximum": 180,
       "minimum": -180
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-solar-irradiance-pv-yield-forecast-67c47545/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)