# Global Solar Atlas PV Output Lookup

> Global Solar Atlas PV Output Lookup is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns long-term average solar resource data (PV output, GHI, DNI, diffuse irradiation, air temperature, elevation) for any latitude/longitude from the World Bank / Solargis Global Solar Atlas.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/energy/global-solar-atlas-pv?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/global-solar-atlas-pv-output-lookup-b5981914
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PNHuQFQwPGR6bUrrzJ0I5

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 global-solar-atlas-pv-output-lookup-b5981914
```

Example prompt: What's the long-term average solar potential at latitude 52.5, longitude 13.4? I need the annual PV output in kWh per kWp, plus GHI, DNI, diffuse irradiation, and air temperature from the Global Solar Atlas.

## When to prefer this

Choose this endpoint when you need standardized, long-term average solar resource data (not real-time or forecast) for any global coordinate, particularly for feasibility studies, energy modeling, or site screening. It wraps the authoritative World Bank / Solargis Global Solar Atlas, so prefer it over generic weather APIs when PV-specific metrics (kWh/kWp) and irradiation components (GHI, DNI, diffuse) are required. It is not suitable for real-time irradiance, short-term forecasting, or plant-level yield guarantees.

## Known failure modes

- Coordinates out of range (-90 to 90 lat, -180 to 180 lon) — returns validation error
- Location over ocean or area with no Solargis coverage — upstream API may return null or error
- Missing required lat or lon query parameters — returns 400 bad request
- Upstream Global Solar Atlas API unavailable — proxy returns 5xx error
- Non-numeric strings passed as lat/lon — returns parsing or validation error

## How this service works

Global Solar Atlas long-term average solar resource at one latitude and longitude: specific PV output (kWh per kWp per year), GHI, DNI, diffuse irradiation and air temperature, from the World Bank / Solargis public API. Not a yield guarantee for a specific plant.

## Output

A JSON object containing the queried latitude and longitude, long-term average specific PV output (kWh/kWp/year), global horizontal irradiation (GHI, kWh/m²), direct normal irradiation (DNI, kWh/m²), diffuse irradiation (kWh/m²), mean air temperature (°C), elevation (m), data period, source URL, and the timestamp the data was checked.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "string",
       "description": "Latitude, -90 to 90 (e.g. 52.5)"
      },
      "lon": {
       "type": "string",
       "description": "Longitude, -180 to 180 (e.g. 13.4)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": 52.5,
  "lon": 13.4,
  "period": {
   "to": "2025",
   "from": "satregion"
  },
  "source": "https://api.globalsolaratlas.info/data/lta",
  "airTempC": 10.1,
  "checkedAt": "2026-10-23T09:38:22.166Z",
  "elevationM": 36,
  "dniKwhPerM2": 985,
  "ghiKwhPerM2": 1073,
  "pvOutKwhPerKwp": 1072,
  "diffuseKwhPerM2": 562
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/global-solar-atlas-pv-output-lookup-b5981914/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)