# Citiview Solar Potential API

> Citiview Solar Potential API is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Returns NREL PVWatts-based solar potential for any address or coordinates, including yearly/monthly energy output, sun hours, capacity factor, estimated savings, install cost, and payback period.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/solar?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-solar-potential-api-25812317
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BULe8nvb6l011VkfUE_Wz

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 citiview-solar-potential-api-25812317
```

Example prompt: What's the solar potential for 123 Main Street, Austin TX — assume a 7kW system, $3.00 per watt install cost, and we pay $0.14 per kWh for electricity? I want to know the yearly output, estimated savings, and how many years to pay it back.

## When to prefer this

Choose this endpoint when you need fast, NREL PVWatts-backed solar energy estimates for a specific address or coordinates without building your own PVWatts integration. It is especially useful for agents that need financial feasibility data (savings, payback) alongside raw energy output in a single call. Prefer it over raw PVWatts API calls when you also need install cost and ROI estimates bundled together.

## Known failure modes

- Invalid or unrecognizable address returns an error or empty result
- Coordinates outside supported geographic coverage (non-US locations may be unsupported by PVWatts)
- Missing required 'input' wrapper in request body returns 400 validation error
- Extremely high or low system_kw values may produce unrealistic estimates
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Solar potential for any address or coordinates: yearly and monthly output of a rooftop system (NREL PVWatts), sun hours, capacity factor, plus estimated yearly savings, install cost and simple paybac…

## Output

Returns a structured response with yearly and monthly AC energy output (kWh), peak sun hours, capacity factor, estimated yearly electricity savings in dollars, total system install cost, and simple payback period in years — all derived from NREL PVWatts modeling for the given location and system parameters.

## 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",
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "near": {
       "type": "string",
       "description": "Address or place"
      },
      "tilt": {
       "type": "number"
      },
      "azimuth": {
       "type": "number"
      },
      "system_kw": {
       "type": "number",
       "description": "Default 5"
      },
      "cost_per_watt": {
       "type": "number",
       "description": "Default 2.75"
      },
      "price_per_kwh": {
       "type": "number",
       "description": "Default 0.16"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-solar-potential-api-25812317/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)