{"openapi":"3.1.0","info":{"title":"usgs-water-flow","version":"0.1.0","description":"listed:true — OpenAPI pre-register shape. Discovery submit HOLD until Board origin list.","x-guidance":"POST /v1/usgs-water-flow with application/json per requestBody schema. Unauthenticated probes receive HTTP 402 (x402 exact USDC on Base / eip155:8453). After payment settles, empty or invalid bodies return 400 with charged:false. Free health: GET /healthz and GET /readyz. Contact nicsins@gmail.com.","contact":{"email":"nicsins@gmail.com"}},"paths":{"/v1/usgs-water-flow":{"post":{"operationId":"usgs_water_flow","summary":"USGS NWIS instantaneous values (keyless). sites or stateCd (+ parameterCd default discharge 00060) → trimmed IV series.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"sites":{"type":"string","maxLength":200,"description":"Comma-separated USGS site numbers"},"site":{"type":"string","maxLength":32},"stateCd":{"type":"string","maxLength":2,"description":"US state code e.g. VA"},"state":{"type":"string","maxLength":2},"parameterCd":{"type":"string","maxLength":64,"default":"00060","description":"Comma-separated parameter codes (default 00060 discharge)"},"parameter":{"type":"string","maxLength":64},"period":{"type":"string","maxLength":16,"description":"ISO period e.g. P1D"},"startDT":{"type":"string","maxLength":32},"endDT":{"type":"string","maxLength":32},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Max values per series"},"request_id":{"type":"string"}}}}}},"responses":{"200":{"description":"ok envelope","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"skill":{"type":"string"},"charged":{"type":"boolean"},"summary":{"type":"string"},"data":{},"request_id":{"type":"string"}},"required":["ok"]}}}},"400":{"description":"empty/invalid after settle — charged:false"},"402":{"description":"payment required"},"503":{"description":"service disabled (kill-switch)"}}}},"/healthz":{"get":{"operationId":"healthz","security":[],"summary":"Liveness","responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/readyz":{"get":{"operationId":"readyz","security":[],"summary":"Readiness","responses":{"200":{"description":"ready","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}},"503":{"description":"not ready"}}}}}}