{"uid":"cap_BULe8nvb6l011VkfUE_Wz","slug":"citiview-solar-potential-api-25812317","name":"Citiview Solar Potential API","description":"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…","url":"https://agents.citiviewgroup.com/v1/solar?utm_source=zero.xyz","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"},"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_746BCC525izIMpwaZGKYh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Homeowner evaluating rooftop solar ROI","prompt":"I'm thinking about getting solar panels on my house at 456 Oak Avenue, Denver CO. Can you run the numbers for a standard 5kW system at $2.75 per watt and our local rate of $0.18 per kWh — tell me the yearly output, savings, and payback period?"},{"title":"Real estate agent assessing solar viability","prompt":"I'm listing a property at 789 Sunset Blvd, San Diego CA and want to highlight its solar potential to buyers. What would a 6kW rooftop system generate per year there, and what's the estimated install cost and savings at $0.25 per kWh?"},{"title":"Solar installer quoting a commercial lead","prompt":"We have a prospect at coordinates 40.7128 latitude, -74.0060 longitude in New York. Can you estimate the annual energy output, sun hours, and payback for a 10kW system at $2.50 per watt with electricity at $0.22 per kWh?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:47:57.486Z","isFirstParty":false,"canonicalSlug":"citiview-solar-potential-api-25812317"}