Solar Legality Oracle
Solar Legality Oracle is a pay-per-call x402 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, cap in watts, effective date). Responses are ECDSA-signed with a public hash-chain proof, and there is a free preview. Paid in USDC on Base — no accounts, no API keys.
01 Endpoints
| Endpoint | What you get | Price |
|---|---|---|
| GET /solar-legality?state= | Signed full record for one state + legal_status + license | $0.005 |
| GET /solar-legality/all | Signed dataset for all 50 states | $0.02 |
| GET /solar-legality/preview?state= | State + badge + legal_status (unsigned) | FREE |
| GET /provable/head | Hash-chain head + query count | FREE |
| GET /health | Liveness + states_count + last_updated | FREE |
Machine-readable: /.well-known/x402 · OpenAPI · /llms.txt
02 legal_status
Each state carries a normalized legal_status alongside the verbatim status badge:
| 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 | — |
03 Frequently asked questions
What does this API tell me?
For any US state it returns the current plug-in / balcony solar legal status, the main utilities, and any enacted legislation (bill number, wattage cap, certification requirement, effective date), as a signed JSON record.
How do agents pay?
Via the x402 protocol on Base mainnet in USDC. An agent calls a paid endpoint, receives HTTP 402 Payment Required with the price, submits a signed USDC payment, and retries. A free preview needs no payment.
Where does the data come from and can I reuse it?
The dataset is compiled by PlugInSolarHub and licensed CC BY 4.0, so it is reusable with attribution. Every response includes the license and a disclaimer. Educational only, not legal advice.