Solar Legality Oracle
Solar Legality Oracle is a deterministic, pay-per-call API for the legal status of plug-in / balcony solar across all 50 US states — per-state status, main utilities, and any enacted legislation (bill, wattage cap, effective date), plus derived freshness. Every paid response is ECDSA-signed and hash-chained. Paid in USDC on Base via x402 — no accounts, no API keys.
Normalized legal status
Each state carries a stable legal_status enum alongside the verbatim badge. As of 2026, 9 states have enacted plug-in solar laws; the rest fall under general interconnection rules.
| legal_status | Meaning | Example |
|---|---|---|
| legal_signed | Plug-in solar law enacted / signed | Colorado (HB26-1007, 1,920W cap) |
| passed_pending | Passed legislature, awaiting the Governor | Rhode Island |
| permissive | No specific statute, leaning permissive | California |
| gray_area | General interconnection rules only; check your utility | Alabama |
| other | Anything not matching the above | — |
Derived fields (faithful, no new facts)
Alongside the source record, every response computes purely derived values — nothing is invented:
legal_status— normalized enum from the verbatim status badgedays_since_reviewandfreshness— fromlast_reviewedutilities_count— number of listed main utilitieshas_legislation— whether a bill is on record
Endpoints
GET /solar-legality?state=— signed record + derived + license · $0.005GET /solar-legality/all— signed dataset for all 50 states · $0.02GET /solar-legality/preview?state=— free, unsigned, rate-limitedGET /provable/head·/provable/verify— the tamper-evident query chain
Machine-readable: /.well-known/x402 · /openapi.json · /llms.txt · /ai/summary.json. Built on the open x402 protocol; part of the nsgoods suite. Data from PlugInSolarHub under CC BY 4.0.
Frequently asked questions
Is plug-in solar legal in my US state?
It varies. The API returns one of five normalized statuses — legal_signed, passed_pending, permissive, gray_area, or other — with the verbatim badge, utilities, and any legislation. As of 2026, 9 states have enacted plug-in solar laws.
Where does the data come from and can I reuse it?
Compiled by PlugInSolarHub and licensed CC BY 4.0 — reusable with attribution. Every response carries the license and a not-legal-advice disclaimer.
How does an agent pay?
Over x402 on Base mainnet in USDC: the agent calls a paid endpoint, receives HTTP 402 with the price, submits a signed USDC payment, and retries. The free preview needs no payment.