{"uid":"cap_7QWJN0Xi-Y2JZNRXsg_Uu","slug":"lion-location-solar-enrichment-a8ae6ce7","name":"LION Location Solar Enrichment","description":"Keyless off-chain and on-chain data for AI agents. No API key, no signup - payment is the only gate. Pay-per-call in USDC on Base via x402.","url":"https://lion-x402.lionmaster-operations.workers.dev/api/x402/location-solar-enrichment-json","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":{"site":{"building":{"levels":3,"height_m":18,"distance_m":0,"building_type":"commercial","footprint_area_m2":8211},"land_use":{"classes_nearby":["commercial","grass"],"dominant_class":"commercial"},"road_access":{"road_name":"Charleston Road","distance_m":35,"nearest_road_class":"service"},"flood_exposure":{"basis":"coarse heuristic (elevation + distance-to-water); NOT a flood certification","elevation_m":9,"exposure_band":"low","distance_to_water_m":1200},"amenity_density":{"food":11,"health":0,"retail":1,"transit":2,"education":0,"recreation":17}},"as_of":"2026-06-02T00:00:00.000Z","solar":{"source":"PVGIS","optimal_tilt_deg":30,"annual_irradiation_kwh_m2":1850.4,"optimal_pv_yield_kwh_per_kwp":1620.2},"geocode":{"lat":37.4221,"lon":-122.0841,"importance":0.55,"place_rank":30,"place_type":"company","place_class":"office","bounding_box":[37.4218,37.4224,-122.0846,-122.0836],"country_code":"us"},"terrain":{"elevation_m":9},"asset_id":"LION_LOCATION_SOLAR_001","resolved":true,"confidence":0.9,"attribution":["OpenStreetMap contributors (ODbL)","Open-Elevation","EU PVGIS"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hRq2PxXIt4FZMeeOCVSrD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns geocoded location data enriched with solar irradiation potential, terrain elevation, building characteristics, land use, flood exposure, road access, and amenity density for a given address or coordinate.","exampleAgentPrompt":"What's the solar energy potential and site profile for the Googleplex at 1600 Amphitheatre Parkway, Mountain View, CA — I need annual irradiation, optimal panel tilt, building info, and flood risk.","exampleUseCases":[{"title":"Solar farm site feasibility screening","prompt":"I'm evaluating potential locations for a distributed solar farm network across three counties. Can you pull the solar irradiation potential, elevation, flood risk, and building footprint data for these five addresses so I can rank them by viability and avoid flood-prone zones?"},{"title":"Urban real estate investment analysis","prompt":"We're looking at five commercial properties for development — I need you to analyze the solar potential, nearby amenities like transit and retail, land use type, road access quality, and any flood exposure for each one so we can compare which neighborhoods have the best growth potential."},{"title":"Renewable energy rooftop assessment","prompt":"Our residential solar installation team needs a quick assessment of this property before we send an installer — what's the annual solar irradiation, optimal panel tilt angle, building dimensions, nearby road access, and any flood or terrain issues that could affect installation?"}],"resultDescription":"A JSON object containing: geocoded coordinates and place metadata, annual solar irradiation (kWh/m²) and optimal PV yield from PVGIS, optimal tilt angle, terrain elevation, building dimensions and type, flood exposure band, dominant land use, nearest road name and class, and counts of nearby amenities by category (food, health, retail, transit, education, recreation). Also includes confidence score, attribution sources, and a timestamp.","failureModes":["Location cannot be geocoded — unrecognized or ambiguous address returns resolved:false","PVGIS coverage gap — solar data unavailable for polar or ocean locations","Payment not sent — endpoint returns HTTP 402 requiring USDC payment on Base","Rate or payload errors from underlying OSM/Open-Elevation APIs","Low confidence score when building/terrain data is sparse for rural areas"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, multi-dimensional site assessment combining solar potential, terrain, building, flood, land use, and amenity data in a single call without API key management. Ideal for real estate screening, solar feasibility studies, site selection workflows, and urban analytics where pay-per-call pricing is preferable to subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:38.494Z","isFirstParty":false}