{"openapi":"3.1.0","info":{"title":"Solar PV Design Calculations API","version":"1.0.0","description":"Design-stage string sizing, DC/AC ratio and clipping, POA irradiance transposition, PVWatts energy yield, row spacing, horizon shading, system loss stack, battery backup sizing, tariff savings, financial payback, module layout fit, NEC 690.8 current, module spec compare, and PAN/OND parsing from caller inputs only. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/solar-design/string-sizing":{"post":{"operationId":"size_pv_module_strings_for_an_inverter_mppt","summary":"Size PV module strings for an inverter MPPT","description":"Compute minimum and maximum modules per series string and maximum parallel strings per MPPT from module temperature coefficients, site temperatures and inverter DC limits.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"module":{"type":"object","properties":{"voc":{"type":"number","exclusiveMinimum":0},"vmp":{"type":"number","exclusiveMinimum":0},"isc":{"type":"number","exclusiveMinimum":0},"imp":{"type":"number","exclusiveMinimum":0},"tempCoeffVoc":{"type":"number"},"tempCoeffVocUnit":{"type":"string","enum":["V_per_C","fraction_per_C","percent_per_C","A_per_C"]},"tempCoeffVmp":{"type":"number"},"tempCoeffVmpUnit":{"type":"string","enum":["V_per_C","fraction_per_C","percent_per_C"]},"tempCoeffIsc":{"type":"number"},"tempCoeffIscUnit":{"type":"string","enum":["A_per_C","fraction_per_C","percent_per_C"]},"bifacialGain":{"default":0,"type":"number","minimum":0,"maximum":0.5}},"required":["voc","vmp","isc","tempCoeffVoc","tempCoeffVocUnit","tempCoeffVmp","tempCoeffVmpUnit","tempCoeffIsc","tempCoeffIscUnit"],"additionalProperties":false},"site":{"type":"object","properties":{"recordLowAmbient":{"type":"number"},"maxCellTemp":{"type":"number"}},"required":["recordLowAmbient","maxCellTemp"],"additionalProperties":false},"inverter":{"type":"object","properties":{"maxDcVoltage":{"type":"number","exclusiveMinimum":0},"mpptMin":{"type":"number","exclusiveMinimum":0},"mpptMax":{"type":"number","exclusiveMinimum":0},"maxInputCurrentPerMppt":{"type":"number","exclusiveMinimum":0},"maxIscPerMppt":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]}},"required":["maxDcVoltage","mpptMin","mpptMax"],"additionalProperties":false}},"required":["module","site","inverter"],"additionalProperties":false},"example":{"module":{"voc":49.9,"vmp":41.96,"isc":14,"imp":13.11,"tempCoeffVoc":-0.128,"tempCoeffVocUnit":"V_per_C","tempCoeffVmp":-0.003,"tempCoeffVmpUnit":"fraction_per_C","tempCoeffIsc":0.00728,"tempCoeffIscUnit":"A_per_C","bifacialGain":0},"site":{"recordLowAmbient":-10,"maxCellTemp":70},"inverter":{"maxDcVoltage":1500,"mpptMin":500,"mpptMax":1300,"maxInputCurrentPerMppt":30,"maxIscPerMppt":null}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"vocAtTmin":{"type":"number"},"vmpAtTmax":{"type":"number"},"vmpAtTmin":{"type":"number"},"iscAtTmax":{"type":"number"},"maxModulesBySystemVoltage":{"type":"number"},"minModulesByMppt":{"type":"number"},"maxModulesByMpptUpper":{"type":"number"},"recommendedRange":{"type":"array","items":{"type":"number"}},"maxStringsPerMppt":{"type":"number"},"feasible":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"vocAtTmin":54.379999999999995,"vmpAtTmax":36.2954,"vmpAtTmin":46.3658,"iscAtTmax":14.3276,"maxModulesBySystemVoltage":27,"minModulesByMppt":14,"maxModulesByMpptUpper":28,"recommendedRange":[14,27],"maxStringsPerMppt":2,"feasible":true,"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990","url":"https://github.com/pvlib/pvlib-python","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","recordLowAmbient is used as the cell temperature for Voc (night-to-dawn assumption).","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/dc-ac-ratio-check":{"post":{"operationId":"check_dc_ac_ratio_and_inverter_clipping","summary":"Check DC/AC ratio and inverter clipping","description":"Compute the DC/AC ratio and optionally estimate AC energy and clipping from a caller DC power series with constant efficiency or a PVWatts inverter curve.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dcNameplateKw":{"type":"number","exclusiveMinimum":0},"acRatingKw":{"type":"number","exclusiveMinimum":0},"inverterEfficiency":{"default":0.96,"type":"number","exclusiveMinimum":0,"maximum":1},"dcPowerSeriesKw":{"maxItems":105408,"type":"array","items":{"type":"number","minimum":0}},"intervalHours":{"default":1,"type":"number","exclusiveMinimum":0},"ratioWarnAbove":{"default":1.3,"type":"number","exclusiveMinimum":0},"useCecCurve":{"default":false,"type":"boolean"}},"required":["dcNameplateKw","acRatingKw"],"additionalProperties":false},"example":{"dcNameplateKw":29.7,"acRatingKw":25,"inverterEfficiency":0.96,"dcPowerSeriesKw":[0,2,8,15,22,27,29,27,22,15,8,2,0],"intervalHours":1,"ratioWarnAbove":1.3}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"dcAcRatio":{"type":"number"},"warnings":{"type":"array","items":{}},"acEnergyKwh":{"type":"number"},"clippedEnergyKwh":{"type":"number"},"clippingFraction":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"dcAcRatio":1.188,"warnings":[],"acEnergyKwh":165.24,"clippedEnergyKwh":4.679999999999996,"clippingFraction":0.02754237288135591,"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"PVWatts Version 5 Manual (Dobos 2014, NREL/TP-6A20-62641)","url":"https://www.nrel.gov/docs/fy14osti/62641.pdf","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Without dcPowerSeriesKw only the nameplate DC/AC ratio is returned.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/poa-irradiance-transpose":{"post":{"operationId":"transpose_ghi_dni_dhi_to_plane_of_array_irradiance","summary":"Transpose GHI/DNI/DHI to plane-of-array irradiance","description":"Compute plane-of-array irradiance with isotropic, Hay-Davies or Perez sky models and NREL SPA solar geometry from caller irradiance records.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"elevation":{"default":0,"type":"number"},"tilt":{"type":"number","minimum":0,"maximum":90},"azimuth":{"type":"number","minimum":0,"maximum":360},"albedo":{"default":0.2,"type":"number","minimum":0,"maximum":1},"model":{"default":"perez","type":"string","enum":["isotropic","haydavies","perez"]},"records":{"minItems":1,"maxItems":105408,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","minLength":1,"maxLength":64},"ghi":{"type":"number","minimum":0},"dni":{"type":"number","minimum":0},"dhi":{"type":"number","minimum":0}},"required":["time","ghi","dni","dhi"],"additionalProperties":false}},"pressurePa":{"default":101325,"type":"number","exclusiveMinimum":0},"temperatureC":{"default":12,"type":"number"},"deltaT":{"default":67,"type":"number"}},"required":["latitude","longitude","tilt","azimuth","records"],"additionalProperties":false},"example":{"latitude":51.5,"longitude":-0.13,"elevation":0,"tilt":30,"azimuth":180,"albedo":0.2,"model":"perez","records":[{"time":"2026-06-21T12:00:00Z","ghi":800,"dni":600,"dhi":250}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"apparentZenith":{"type":"number"},"solarAzimuth":{"type":"number"},"aoi":{"type":"number"},"dniExtra":{"type":"number"},"poaGlobal":{"type":"number"},"poaDirect":{"type":"number"},"poaSkyDiffuse":{"type":"number"},"poaGroundDiffuse":{"type":"number"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"records":[{"time":"2026-06-21T12:00:00Z","apparentZenith":28.05788760207966,"solarAzimuth":178.86045677515926,"aoi":2.0192198013423734,"dniExtra":1321.6235925714136,"poaGlobal":894.160192475058,"poaDirect":599.6274382774938,"poaSkyDiffuse":283.8147865003193,"poaGroundDiffuse":10.717967697244903}],"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990","url":"https://github.com/pvlib/pvlib-python","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Solar position uses NREL SPA as in pvlib method=nrel_numpy with bundled coefficient tables.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/energy-yield-estimate":{"post":{"operationId":"estimate_ac_energy_with_pvwatts_v5","summary":"Estimate AC energy with PVWatts v5","description":"Estimate AC energy from caller POA irradiance and temperatures using the PVWatts v5 DC and inverter models with a transparent loss stack.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dcNameplateW":{"type":"number","exclusiveMinimum":0},"gammaPdc":{"type":"number"},"acRatingW":{"type":"number","exclusiveMinimum":0},"inverterNominalEfficiency":{"default":0.96,"type":"number","exclusiveMinimum":0,"maximum":1},"lossesPercent":{"default":14.08,"type":"number","minimum":0,"maximum":100},"temperatureModel":{"type":"object","properties":{"type":{"type":"string","const":"pvsyst"},"uc":{"default":29,"type":"number","exclusiveMinimum":0},"uv":{"default":0,"type":"number","minimum":0},"alphaAbsorption":{"default":0.9,"type":"number","exclusiveMinimum":0,"maximum":1},"moduleEfficiency":{"default":0.1,"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["type"],"additionalProperties":false},"records":{"minItems":1,"maxItems":105408,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","minLength":1,"maxLength":64},"poa":{"type":"number","minimum":0},"ambientTemp":{"type":"number"},"windSpeed":{"default":1,"type":"number","minimum":0},"cellTemp":{"type":"number"}},"required":["time","poa"],"additionalProperties":false}},"monthly":{"minItems":12,"maxItems":12,"type":"array","items":{"type":"object","properties":{"poaKwhPerM2":{"type":"number","minimum":0},"avgAmbientTemp":{"type":"number"}},"required":["poaKwhPerM2","avgAmbientTemp"],"additionalProperties":false}},"intervalHours":{"default":1,"type":"number","exclusiveMinimum":0}},"required":["dcNameplateW","gammaPdc","acRatingW"],"additionalProperties":false},"example":{"dcNameplateW":29700,"gammaPdc":-0.0034,"acRatingW":25000,"inverterNominalEfficiency":0.96,"lossesPercent":14.08,"temperatureModel":{"type":"pvsyst","uc":29,"uv":0,"alphaAbsorption":0.9,"moduleEfficiency":0.1},"records":[{"time":"2026-06-21T12:00:00Z","poa":800,"ambientTemp":20,"windSpeed":1}],"intervalHours":1}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"cellTemp":{"type":"number"},"pdc":{"type":"number"},"pdcAfterLosses":{"type":"number"},"pac":{"type":"number"}},"additionalProperties":true}},"totalAcKwh":{"type":"number"},"lossStack":{"type":"object","properties":{"totalPercent":{"type":"number"}},"additionalProperties":true},"accuracyNote":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"records":[{"time":"2026-06-21T12:00:00Z","cellTemp":42.3448275862069,"pdc":22358.815448275862,"pdcAfterLosses":19210.69423315862,"pac":18483.439181716883}],"totalAcKwh":18.483439181716882,"lossStack":{"totalPercent":14.08},"accuracyNote":"interval_mode","sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"PVWatts Version 5 Manual (Dobos 2014, NREL/TP-6A20-62641)","url":"https://www.nrel.gov/docs/fy14osti/62641.pdf","retrievedAt":"2026-11-14","status":"ok"},"…"],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","PVWatts v5 DC and inverter models; cell temperature uses the PVsyst model when cellTemp is omitted.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/row-spacing":{"post":{"operationId":"compute_inter_row_spacing_and_gcr","summary":"Compute inter-row spacing and GCR","description":"Compute row height, shadow gap, row pitch and ground coverage ratio that avoid row-to-row shading at a design sun position.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"moduleSlopeLength":{"type":"number","exclusiveMinimum":0},"tilt":{"type":"number","minimum":0,"maximum":90},"arrayAzimuth":{"default":180,"type":"number","minimum":0,"maximum":360},"sun":{"type":"object","properties":{"elevation":{"type":"number"},"azimuth":{"type":"number","minimum":0,"maximum":360}},"required":["elevation","azimuth"],"additionalProperties":false},"designTimes":{"maxItems":48,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"elevation":{"default":0,"type":"number"},"groundSlope":{"default":0,"type":"number"}},"required":["moduleSlopeLength","tilt"],"additionalProperties":false},"example":{"moduleSlopeLength":2.278,"tilt":30,"arrayAzimuth":180,"sun":{"elevation":20,"azimuth":140},"groundSlope":0}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"rowHeight":{"type":"number"},"shadowGap":{"type":"number"},"rowPitch":{"type":"number"},"gcr":{"type":"number"},"sunElevation":{"type":"number"},"sunAzimuth":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"rowHeight":1.1389999999999998,"shadowGap":2.3972416933258462,"rowPitch":4.370047563146798,"gcr":0.5212757909572157,"sunElevation":20,"sunAzimuth":140,"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990","url":"https://github.com/pvlib/pvlib-python","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Spacing avoids row-to-row shading at the design sun position only; seasonal extremes should be checked separately."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/horizon-shading-loss":{"post":{"operationId":"estimate_far_field_horizon_shading_losses","summary":"Estimate far-field horizon shading losses","description":"Estimate beam and isotropic sky-diffuse losses caused by a caller far-field horizon profile against sun positions and beam POA.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"horizon":{"minItems":4,"maxItems":360,"type":"array","items":{"type":"object","properties":{"azimuth":{"type":"number","minimum":0,"maximum":360},"elevation":{"type":"number","minimum":0,"maximum":90}},"required":["azimuth","elevation"],"additionalProperties":false}},"records":{"minItems":1,"maxItems":105408,"type":"array","items":{"type":"object","properties":{"sunElevation":{"type":"number"},"sunAzimuth":{"type":"number","minimum":0,"maximum":360},"beamPoa":{"type":"number","minimum":0}},"required":["sunElevation","sunAzimuth","beamPoa"],"additionalProperties":false}},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"elevation":{"default":0,"type":"number"},"times":{"maxItems":105408,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"beamPoa":{"maxItems":105408,"type":"array","items":{"type":"number","minimum":0}}},"required":["horizon"],"additionalProperties":false},"example":{"horizon":[{"azimuth":0,"elevation":10},{"azimuth":90,"elevation":10},{"azimuth":180,"elevation":10},{"azimuth":270,"elevation":10}],"records":[{"sunElevation":25,"sunAzimuth":160,"beamPoa":500}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"beamLossFraction":{"type":"number"},"skyDiffuseLossFraction":{"type":"number"},"blockedHours":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"beamLossFraction":0,"skyDiffuseLossFraction":0.03015368960704569,"blockedHours":0,"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990","url":"https://github.com/pvlib/pvlib-python","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Far-field horizon only; near-field objects closer than the array scale are not modelled.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/system-loss-stack":{"post":{"operationId":"combine_pvwatts_system_loss_percentages","summary":"Combine PVWatts system loss percentages","description":"Combine individual loss percentages into a total system loss using PVWatts multiplicative derating, with optional defaults for missing categories.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"losses":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"number","minimum":0,"maximum":100}},"useDefaultsForMissing":{"default":true,"type":"boolean"}},"additionalProperties":false},"example":{"losses":{"soiling":2,"shading":3,"snow":0,"mismatch":2,"wiring":2,"connections":0.5,"lid":1.5,"nameplate":1,"age":0,"availability":3},"useDefaultsForMissing":true}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"totalPercent":{"type":"number"},"derate":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"percent":{"type":"number"},"source":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"totalPercent":14.075660688264469,"derate":0.8592433931173553,"items":[{"name":"soiling","percent":2,"source":"caller"},{"name":"shading","percent":3,"source":"caller"},"…"],"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"PVWatts Version 5 Manual (Dobos 2014, NREL/TP-6A20-62641)","url":"https://www.nrel.gov/docs/fy14osti/62641.pdf","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Losses combine multiplicatively per PVWatts v5: total = 100·[1 − Π(1 − l_i/100)]."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/battery-backup-sizing":{"post":{"operationId":"size_battery_backup_energy_and_inverter_power","summary":"Size battery backup energy and inverter power","description":"Size battery energy and inverter continuous/surge power needed to back up critical loads for a target autonomy with DoD and efficiency derates.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"loads":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":128},"powerKw":{"type":"number","exclusiveMinimum":0},"hoursPerDay":{"type":"number","exclusiveMinimum":0,"maximum":24},"surgeKw":{"type":"number","exclusiveMinimum":0},"dutyFactor":{"default":1,"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["name","powerKw","hoursPerDay"],"additionalProperties":false}},"autonomyHours":{"type":"number","exclusiveMinimum":0},"depthOfDischarge":{"type":"number","exclusiveMinimum":0,"maximum":1},"dischargeEfficiency":{"type":"number","exclusiveMinimum":0,"maximum":1},"temperatureDerate":{"default":1,"type":"number","exclusiveMinimum":0,"maximum":1},"inverterMargin":{"default":1.25,"type":"number","exclusiveMinimum":0},"pvRechargeKwhPerDay":{"default":0,"type":"number","minimum":0},"simultaneousStart":{"default":false,"type":"boolean"}},"required":["loads","autonomyHours","depthOfDischarge","dischargeEfficiency"],"additionalProperties":false},"example":{"loads":[{"name":"fridge+lights+router","powerKw":2,"hoursPerDay":24,"surgeKw":6}],"autonomyHours":10,"depthOfDischarge":0.9,"dischargeEfficiency":0.95,"temperatureDerate":1,"inverterMargin":1.25,"pvRechargeKwhPerDay":0}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"energyNeededKwh":{"type":"number"},"nominalCapacityKwh":{"type":"number"},"inverterContinuousKw":{"type":"number"},"inverterSurgeKw":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"energyNeededKwh":20,"nominalCapacityKwh":23.391812865497077,"inverterContinuousKw":2.5,"inverterSurgeKw":6,"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","temperatureDerate is a caller datasheet value; no battery thermal model is applied.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/tariff-savings":{"post":{"operationId":"estimate_bill_savings_under_a_tou_tariff","summary":"Estimate bill savings under a TOU tariff","description":"Compute bill savings from caller interval generation and load under a time-of-use tariff with export credit, net metering or no export value.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"intervalHours":{"default":1,"type":"number","exclusiveMinimum":0},"loadKwh":{"minItems":1,"maxItems":105408,"type":"array","items":{"type":"number","minimum":0}},"generationKwh":{"minItems":1,"maxItems":105408,"type":"array","items":{"type":"number","minimum":0}},"importPrice":{"minItems":1,"maxItems":105408,"type":"array","items":{"type":"number"}},"exportMode":{"default":"export_rate","type":"string","enum":["export_rate","net_metering_kwh","none"]},"exportPrice":{"default":0,"type":"number","minimum":0},"fixedCharges":{"default":0,"type":"number","minimum":0},"demandCharge":{"anyOf":[{"type":"object","properties":{"pricePerKw":{"type":"number","minimum":0},"window":{"minItems":1,"maxItems":105408,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["pricePerKw"],"additionalProperties":false},{"type":"null"}]},"billingPeriods":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["loadKwh","generationKwh","importPrice"],"additionalProperties":false},"example":{"intervalHours":1,"loadKwh":[0.5,0.5,0.5,0.5,0.5,0.5,0.5,1.5,1,0.8,0.8,0.8,0.9,0.9,0.8,0.8,1,2,2.5,2,1.5,1,0.7,0.5],"generationKwh":[0,0,0,0,0,0,0.2,0.8,1.5,2.2,2.8,3,3.1,2.9,2.4,1.7,0.9,0.3,0,0,0,0,0,0],"importPrice":[0.1,0.1,0.1,0.1,0.1,0.1,0.1,0.25,0.25,0.25,0.25,0.25,0.25,0.25,0.25,0.25,0.4,0.4,0.4,0.4,0.25,0.1,0.1,0.1],"exportMode":"export_rate","exportPrice":0.05,"fixedCharges":0,"demandCharge":null}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"billWithoutPv":{"type":"number"},"billWithPv":{"type":"number"},"savings":{"type":"number"},"importKwh":{"type":"number"},"exportKwh":{"type":"number"},"selfConsumedKwh":{"type":"number"},"selfConsumptionRate":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"billWithoutPv":6.02,"billWithPv":2.9799999999999995,"savings":3.04,"importKwh":14,"exportKwh":12.8,"selfConsumedKwh":9,"selfConsumptionRate":0.4128440366972478,"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Tariff prices and export rules are caller-supplied; no utility rate database is queried.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/financial-payback":{"post":{"operationId":"compute_pv_payback_npv_irr_and_lcoe","summary":"Compute PV payback, NPV, IRR and LCOE","description":"Compute simple payback, NPV, IRR and LCOE from capex, incentives, year-1 energy, degradation, O&M and price escalation.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"capex":{"type":"number","exclusiveMinimum":0},"upfrontIncentives":{"default":0,"type":"number","minimum":0},"year1EnergyKwh":{"type":"number","exclusiveMinimum":0},"degradation":{"default":0.005,"type":"number","minimum":-0.5,"maximum":1},"energyValuePerKwh":{"type":"number"},"energyEscalation":{"default":0.02,"type":"number","minimum":-0.5,"maximum":1},"omPerYear":{"default":0,"type":"number","minimum":0},"omEscalation":{"default":0.02,"type":"number","minimum":-0.5,"maximum":1},"years":{"type":"integer","minimum":1,"maximum":50},"discountRate":{"type":"number","minimum":-0.5,"maximum":1}},"required":["capex","year1EnergyKwh","energyValuePerKwh","years","discountRate"],"additionalProperties":false},"example":{"capex":20000,"upfrontIncentives":3000,"year1EnergyKwh":9000,"degradation":0.005,"energyValuePerKwh":0.25,"energyEscalation":0.02,"omPerYear":200,"omEscalation":0.02,"years":25,"discountRate":0.05}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"netCapex":{"type":"number"},"year1CashFlow":{"type":"number"},"npv":{"type":"number"},"irr":{"type":"number"},"paybackYears":{"type":"number"},"lcoe":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"netCapex":17000,"year1CashFlow":2050,"npv":16267.394915881545,"irr":0.12612992523272165,"paybackYears":7.889390667220237,"lcoe":0.1688917763747619,"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Incentives are caller numbers; no tax-credit rules are encoded.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/module-layout-fit":{"post":{"operationId":"fit_modules_onto_a_roof_polygon","summary":"Fit modules onto a roof polygon","description":"Maximise the number of modules on a roof-face polygon with caller setbacks, orientation, gaps and obstruction polygons.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"roof":{"minItems":3,"maxItems":200,"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}},"setback":{"type":"number","minimum":0},"module":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"gap":{"default":0.02,"type":"number","minimum":0},"orientations":{"default":["portrait","landscape"],"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["portrait","landscape"]}},"obstructions":{"default":[],"maxItems":50,"type":"array","items":{"type":"object","properties":{"polygon":{"minItems":3,"maxItems":100,"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}},"setback":{"default":0,"type":"number","minimum":0}},"required":["polygon"],"additionalProperties":false}},"gridOffsets":{"default":10,"type":"integer","minimum":1,"maximum":25}},"required":["roof","setback","module"],"additionalProperties":false},"example":{"roof":[[0,0],[10,0],[10,6],[0,6]],"setback":0.5,"module":{"width":1.134,"height":2.278},"gap":0.02,"orientations":["portrait","landscape"],"obstructions":[],"gridOffsets":10}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"best":{"type":"object","properties":{"orientation":{"type":"string"},"count":{"type":"number"},"rows":{"type":"number"},"columns":{"type":"number"}},"additionalProperties":true},"candidates":{"type":"array","items":{"type":"object","properties":{"orientation":{"type":"string"},"count":{"type":"number"}},"additionalProperties":true}},"placements":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"best":{"orientation":"portrait","count":14,"rows":2,"columns":7},"candidates":[{"orientation":"portrait","count":14},{"orientation":"landscape","count":12}],"placements":[{"x":0.5,"y":0.5,"w":1.134,"h":2.278},{"x":1.654,"y":0.5,"w":1.134,"h":2.278},"…"],"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Roof polygon is treated in the roof plane (2D metres). Setbacks are caller-supplied; jurisdiction rules vary.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/nec-690-current":{"post":{"operationId":"compute_nec_690_8_pv_circuit_current","summary":"Compute NEC 690.8 PV circuit current","description":"Compute PV circuit maximum current and minimum conductor ampacity using NEC 690.8 125% factors for the selected code edition.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"edition":{"default":"2023","type":"string","enum":["2017","2020","2023"]},"moduleIsc":{"type":"number","exclusiveMinimum":0},"parallelStrings":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"continuousFactor":{"default":1.25,"type":"number","exclusiveMinimum":0}},"required":["moduleIsc"],"additionalProperties":false},"example":{"edition":"2023","moduleIsc":14,"parallelStrings":2,"continuousFactor":1.25}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"maxCircuitCurrent":{"type":"number"},"minConductorAmpacity":{"type":"number"},"minOcpdRating":{"type":"number"},"perStringMaxCurrent":{"type":"number"},"edition":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"maxCircuitCurrent":35,"minConductorAmpacity":43.75,"minOcpdRating":43.75,"perStringMaxCurrent":17.5,"edition":"2023","sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"},{"source":"NFPA 70 National Electrical Code §690.8 factors (2017/2020/2023 editions); formula cited only, NFPA text not vendored","url":"https://www.nfpa.org/codes-and-standards/nfpa-70-standard-development/70","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Applies NEC 690.8(A)(1)(a)(1) and 690.8(B) 125% factors only; 2023 alternative methods are out of scope.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/module-spec-compare":{"post":{"operationId":"compare_module_datasheet_metrics","summary":"Compare module datasheet metrics","description":"Normalise and compare module datasheet values for efficiency, W/m², temperature-adjusted power, price per watt and warranty retention.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"modules":{"minItems":2,"maxItems":50,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":128},"pmax":{"type":"number","exclusiveMinimum":0},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0},"tempCoeffPmax":{"type":"number"},"price":{"type":"number","exclusiveMinimum":0},"warrantyYear25Retention":{"type":"number","minimum":0,"maximum":1},"noct":{"type":"number"},"pmaxNoct":{"type":"number"}},"required":["name","pmax"],"additionalProperties":false}},"referenceCellTemp":{"default":45,"type":"number"}},"required":["modules"],"additionalProperties":false},"example":{"modules":[{"name":"A","pmax":550,"width":1.134,"height":2.278,"tempCoeffPmax":-0.34,"price":165,"warrantyYear25Retention":0.874},{"name":"B","pmax":430,"width":1.134,"height":1.762,"tempCoeffPmax":-0.29,"price":140,"warrantyYear25Retention":0.889}],"referenceCellTemp":45}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"modules":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"efficiency":{"type":"number"},"wattsPerM2":{"type":"number"},"pricePerW":{"type":"number"},"pmaxAtRefTemp":{"type":"number"},"warrantyYear25Retention":{"type":"number"},"noct":{"type":"null"},"pmaxNoct":{"type":"null"}},"additionalProperties":true}},"ranking":{"type":"object","properties":{"efficiency":{"type":"array","items":{"type":"string"}},"wattsPerM2":{"type":"array","items":{"type":"string"}},"pricePerW":{"type":"array","items":{"type":"string"}},"pmaxAtRefTemp":{"type":"array","items":{"type":"string"}},"warrantyYear25Retention":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"modules":[{"name":"A","efficiency":0.2129099290351851,"wattsPerM2":212.90992903518512,"pricePerW":0.3,"pmaxAtRefTemp":512.6,"warrantyYear25Retention":0.874,"noct":null,"pmaxNoct":null},{"name":"B","efficiency":0.21520358258912933,"wattsPerM2":215.20358258912933,"pricePerW":0.32558139534883723,"pmaxAtRefTemp":405.06,"warrantyYear25Retention":0.889,"noct":null,"pmaxNoct":null}],"ranking":{"efficiency":["B","A"],"wattsPerM2":["B","A"],"pricePerW":["A","B"],"pmaxAtRefTemp":["A","B"],"warrantyYear25Retention":["B","A"]},"sources":[{"source":"Caller-supplied module, inverter, irradiance and site inputs processed locally","url":"https://www.brainiac.software/api/v1/solar-design","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Efficiency = pmax/(1000·area) at STC. Optional NOCT values are reported separately and never mixed with STC.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/solar-design/pan-ond-parse":{"post":{"operationId":"parse_pvsyst_pan_or_ond_text_files","summary":"Parse PVsyst PAN or OND text files","description":"Parse PVsyst PAN (module) and OND (inverter) text files into nested raw JSON and a normalised datasheet object.","tags":["solar-design"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fileType":{"type":"string","enum":["pan","ond"]},"content":{"type":"string","minLength":1,"maxLength":524288}},"required":["fileType","content"],"additionalProperties":false},"example":{"fileType":"pan","content":"PVObject_=pvModule\n  Version=7.2\n  PVObject_Commercial=pvCommercial\n    Manufacturer=ET SOLAR\n    Model=ET-M772BH550GL\n    Width=1.134\n    Height=2.278\n  PNom=550.0\n  Isc=14.0\n  Voc=49.9\n  Imp=13.11\n  Vmp=41.96\n  muISC=7.28\n  muVocSpec=-128.0\n  NCelS=72\n  BifacialityFactor=0.7\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"raw":{"type":"object","properties":{"PVObject_":{"type":"object","properties":{"PVObject_":{"type":"string"},"Version":{"type":"number"},"Flags":{"type":"string"},"PVObject_Commercial":{"type":"object","properties":{"PVObject_Commercial":{"type":"string"},"Comment":{"type":"string"},"Flags":{"type":"string"},"Manufacturer":{"type":"string"},"Model":{"type":"string"},"DataSource":{"type":"string"},"YearBeg":{"type":"number"},"Width":{"type":"number"},"Height":{"type":"number"},"Depth":{"type":"number"},"Weight":{"type":"number"},"NPieces":{"type":"number"},"PriceDate":{"type":"string"}},"additionalProperties":true},"Technol":{"type":"string"},"NCelS":{"type":"number"},"NCelP":{"type":"number"},"NDiode":{"type":"number"},"SubModuleLayout":{"type":"string"},"FrontSurface":{"type":"string"},"GRef":{"type":"number"},"TRef":{"type":"number"},"PNom":{"type":"number"},"PNomTolUp":{"type":"number"},"BifacialityFactor":{"type":"number"},"Isc":{"type":"number"},"Voc":{"type":"number"},"Imp":{"type":"number"},"Vmp":{"type":"number"},"muISC":{"type":"number"},"muVocSpec":{"type":"number"},"muPmpReq":{"type":"number"},"RShunt":{"type":"number"},"Rp_0":{"type":"number"},"Rp_Exp":{"type":"number"},"RSerie":{"type":"number"},"Gamma":{"type":"number"},"muGamma":{"type":"number"},"VMaxIEC":{"type":"number"},"VMaxUL":{"type":"number"},"Absorb":{"type":"number"},"ARev":{"type":"number"},"BRev":{"type":"number"},"RDiode":{"type":"number"},"VRevDiode":{"type":"number"},"IMaxDiode":{"type":"number"},"AirMassRef":{"type":"number"},"CellArea":{"type":"number"},"SandiaAMCorr":{"type":"number"},"PVObject_IAM":{"type":"object","properties":{"PVObject_IAM":{"type":"string"},"Flags":{"type":"string"},"IAMMode":{"type":"string"},"IAMProfile":{"type":"object","properties":{"IAMProfile":{"type":"string"},"NPtsMax":{"type":"number"},"NPtsEff":{"type":"number"},"LastCompile":{"type":"string"},"Mode":{"type":"number"},"Point_1":{"type":"array","items":{"type":"number"}},"Point_2":{"type":"array","items":{"type":"number"}},"Point_3":{"type":"array","items":{"type":"number"}},"Point_4":{"type":"array","items":{"type":"number"}},"Point_5":{"type":"array","items":{"type":"number"}},"Point_6":{"type":"array","items":{"type":"number"}},"Point_7":{"type":"array","items":{"type":"number"}},"Point_8":{"type":"array","items":{"type":"number"}},"Point_9":{"type":"array","items":{"type":"number"}}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true},"normalized":{"type":"object","properties":{"manufacturer":{"type":"string"},"model":{"type":"string"},"pNom":{"type":"number"},"voc":{"type":"number"},"isc":{"type":"number"},"vmp":{"type":"number"},"imp":{"type":"number"},"muIscAPerC":{"type":"number"},"muVocVPerC":{"type":"number"},"cellsSeries":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"bifacialityFactor":{"type":"number"},"iamProfile":{"type":"array","items":{"type":"array","items":{"type":"number"}}}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"raw":{"PVObject_":{"PVObject_":"pvModule","Version":7.2,"Flags":"$00900243","PVObject_Commercial":{"PVObject_Commercial":"pvCommercial","Comment":"ET SOLAR","Flags":"$0041","Manufacturer":"ET SOLAR","Model":"ET-M772BH550GL","DataSource":"Manufacturer 2021","YearBeg":2021,"Width":1.134,"Height":2.278,"Depth":0.035,"Weight":32,"NPieces":100,"PriceDate":"06/04/22 12:39"},"Technol":"mtSiMono","NCelS":72,"NCelP":2,"NDiode":3,"SubModuleLayout":"slTwinHalfCells","FrontSurface":"fsARCoating","GRef":1000,"TRef":25,"PNom":550,"PNomTolUp":0.9,"BifacialityFactor":0.7,"Isc":14,"Voc":49.9,"Imp":13.11,"Vmp":41.96,"muISC":7.28,"muVocSpec":-128,"muPmpReq":-0.34,"RShunt":300,"Rp_0":2000,"Rp_Exp":5.5,"RSerie":0.203,"Gamma":0.98,"muGamma":-0.0001,"VMaxIEC":1500,"VMaxUL":1500,"Absorb":0.9,"ARev":3.2,"BRev":16.716,"RDiode":0.01,"VRevDiode":-0.7,"IMaxDiode":30,"AirMassRef":1.5,"CellArea":165.1,"SandiaAMCorr":50,"PVObject_IAM":{"PVObject_IAM":"pvIAM","Flags":"$00","IAMMode":"UserProfile","IAMProfile":{"IAMProfile":"TCubicProfile","NPtsMax":9,"NPtsEff":9,"LastCompile":"$B18D","Mode":3,"Point_1":[0,1],"Point_2":[20,1],"Point_3":[30,1],"Point_4":[40,0.99],"Point_5":[50,0.98],"Point_6":[60,0.96],"Point_7":[70,0.89],"Point_8":[80,0.66],"Point_9":[90,0]}}}},"normalized":{"manufacturer":"ET SOLAR","model":"ET-M772BH550GL","pNom":550,"voc":49.9,"isc":14,"vmp":41.96,"imp":13.11,"muIscAPerC":0.00728,"muVocVPerC":-0.128,"cellsSeries":72,"width":1.134,"height":2.278,"bifacialityFactor":0.7,"iamProfile":[[0,1],[20,1],"…"]},"sources":[{"source":"PVsyst PAN/OND text format parsed locally (pvlib iotools.read_panond behaviour)","url":"https://github.com/pvlib/pvlib-python","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…","Binary/legacy (pre-6.x) files are rejected as unsupported_format.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}