# LION Location Solar Enrichment

> LION Location Solar Enrichment is a paid API for AI agents from lionx402.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns geocoded location data, solar irradiation potential, site characteristics (building, land use, flood, amenities), and terrain info for a given address or coordinate.

## Facts

- Endpoint: GET https://lionx402.com/api/x402/location-solar-enrichment-json
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lion-location-solar-enrichment-90dcd29d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bn3TkkYe3dkEIVx2bRM3v

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 lion-location-solar-enrichment-90dcd29d
```

Example prompt: What's the solar irradiation potential and site profile for 1600 Amphitheatre Parkway, Mountain View, CA — I want to know the annual PV yield, building type, flood exposure, and nearby amenities?

## When to prefer this

Use this endpoint when you need a combined geospatial + solar energy profile for a specific location in a single call, especially for real estate due diligence, solar feasibility studies, or site selection workflows. It bundles geocoding, building analysis, terrain, flood risk, amenity density, and solar irradiation into one pay-per-call response without requiring an API key. Prefer over separate geocoding + solar APIs when cost efficiency and agent-native keyless access (x402/USDC) matter.

## Known failure modes

- Location not found or ambiguous address returns resolved:false with reduced confidence
- Coordinates outside PVGIS coverage area may return null solar fields
- Flood exposure is a coarse heuristic only, not a certified flood assessment
- Payment in USDC on Base required; missing or failed x402 payment returns 402 error
- Rate limits or upstream OpenStreetMap/PVGIS outages may cause partial data

## How this service works

Location + solar PV potential for sites/properties (?address= or ?lat=&lon=)

## Output

A JSON object containing geocoded lat/lon with bounding box and place type, solar data from PVGIS (optimal tilt, annual irradiation in kWh/m², PV yield per kWp), terrain elevation, building details (levels, height, footprint area, building type), land use classes, road access info, flood exposure band based on elevation heuristics, and amenity density counts by category (food, health, retail, transit, education, recreation). All data is attributed to OpenStreetMap, Open-Elevation, and EU PVGIS and includes a confidence score and timestamp.

## 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"
      },
      "address": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "service": "LION Verified Company",
  "asset_id": "LION",
  "resolved": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lion-location-solar-enrichment-90dcd29d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lionx402.com](https://www.zero.xyz/host/lionx402.com/llms.txt)