{"openapi":"3.1.0","info":{"title":"Hydrology & Open-Channel Calc","version":"1.0.0","description":"Manning flow, normal and critical depth, Froude number, weir flow, rational method, time of concentration and orifice flow. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Hydrology & Open-Channel Calc: Manning flow, normal and critical depth, Froude number, weir flow, rational method, time of concentration and orifice flow. Use /manning-flow for channel flow and velocity, /normal-depth for depth at a given flow, /critical-depth for critical depth, /froude-number for flow regime, /weir-flow for weir discharge, /rational-method for peak runoff, /time-of-concentration for Kirpich and NRCS lag and /orifice-flow for orifice discharge. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://hydrology-calc.x402tookit.com"}],"paths":{"/critical-depth":{"get":{"operationId":"critical_depth","summary":"Critical depth where Froude number is 1 (Q^2/g = A^3/T) for rectangular, trapezoidal, triangular or circular channels.","description":"Critical depth where Froude number is 1 (Q^2/g = A^3/T) for rectangular, trapezoidal, triangular or circular channels.","tags":["critical-depth","froude","open-channel","hydraulics"],"parameters":[{"name":"shape","in":"query","required":true,"description":"rectangular, trapezoidal, triangular or circular","schema":{"type":"string"}},{"name":"flow","in":"query","required":true,"description":"Discharge in m3/s (units si) or ft3/s (units us)","schema":{"type":"number"}},{"name":"bottomWidth","in":"query","required":false,"description":"Bottom width in metres or feet (rectangular, trapezoidal)","schema":{"type":"number"}},{"name":"sideSlope","in":"query","required":false,"description":"Side slope z, horizontal run per 1 vertical (trapezoidal, triangular)","schema":{"type":"number"}},{"name":"diameter","in":"query","required":false,"description":"Pipe diameter in metres or feet (circular)","schema":{"type":"number"}},{"name":"units","in":"query","required":false,"description":"si (default) or us","schema":{"type":"string"}},{"name":"gravity","in":"query","required":false,"description":"Gravity in m/s2 or ft/s2 (default 9.81 si, 32.2 us)","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"shape":{"type":["null","string"]},"units":{"type":["null","string"]},"gravity":{"type":["null","number"]},"criticalDepth":{"type":["null","number"]},"criticalVelocity":{"type":["null","number"]},"minimumSpecificEnergy":{"type":["null","number"]},"flowAreaAtCritical":{"type":["null","number"]},"topWidthAtCritical":{"type":["null","number"]},"rectangularClosedForm":{"type":["null","number"]},"requestedFlow":{"type":["null","number"]},"bottomWidth":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"rectangular, width 5: critical depth 0.741533 m at 10 m3/s; critical velocity 2.697 m/s.","reasons":["Critical flow satisfies Q^2 / g = A^3 / T (Froude number 1), solved by bisection.","Rectangular closed form y_c = (q^2 / g)^(1/3) = 0.741533, with q = Q / b.","…1 more"],"shape":"rectangular","units":"si","gravity":9.81,"criticalDepth":0.741532735,"criticalVelocity":2.6971163,"minimumSpecificEnergy":1.1122991,"flowAreaAtCritical":3.7076637,"topWidthAtCritical":5,"rectangularClosedForm":0.741532735,"requestedFlow":10,"bottomWidth":5,"degraded":false,"notChecked":["whether the actual flow is sub- or supercritical (see /froude-number and /normal-depth)","non-hydrostatic effects near drops and weirs","…1 more"],"source":"computed locally (critical flow: Q^2 / g = A^3 / T; rectangular y_c = (q^2 / g)^(1/3))","asOf":"2026-10-21T06:26:57.308Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/critical-depth"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/critical-depth"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/critical-depth"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/critical-depth"}}]}}},"/froude-number":{"get":{"operationId":"froude_number","summary":"Froude number V / sqrt(g A/T) and flow regime (subcritical, critical, supercritical) for an open-channel section.","description":"Froude number V / sqrt(g A/T) and flow regime (subcritical, critical, supercritical) for an open-channel section.","tags":["froude","flow-regime","open-channel","hydraulics"],"parameters":[{"name":"shape","in":"query","required":true,"description":"rectangular, trapezoidal, triangular or circular","schema":{"type":"string"}},{"name":"depth","in":"query","required":true,"description":"Flow depth in metres or feet (circular: below the diameter)","schema":{"type":"number"}},{"name":"flow","in":"query","required":false,"description":"Discharge in m3/s or ft3/s (send flow or velocity)","schema":{"type":"number"}},{"name":"velocity","in":"query","required":false,"description":"Mean velocity in m/s or ft/s (send velocity or flow)","schema":{"type":"number"}},{"name":"bottomWidth","in":"query","required":false,"description":"Bottom width in metres or feet (rectangular, trapezoidal)","schema":{"type":"number"}},{"name":"sideSlope","in":"query","required":false,"description":"Side slope z, horizontal run per 1 vertical (trapezoidal, triangular)","schema":{"type":"number"}},{"name":"diameter","in":"query","required":false,"description":"Pipe diameter in metres or feet (circular)","schema":{"type":"number"}},{"name":"units","in":"query","required":false,"description":"si (default) or us","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"shape":{"type":["null","string"]},"units":{"type":["null","string"]},"depth":{"type":["null","number"]},"velocity":{"type":["null","number"]},"flow":{"type":["null","number"]},"froudeNumber":{"type":["null","number"]},"hydraulicDepth":{"type":["null","number"]},"waveCelerity":{"type":["null","number"]},"specificEnergy":{"type":["null","number"]},"flowArea":{"type":["null","number"]},"topWidth":{"type":["null","number"]},"flowRegime":{"type":["null","string"]},"bottomWidth":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"SUPERCRITICAL","summary":"Froude number 2.258: supercritical flow (velocity 5 m/s vs wave speed 2.215 m/s).","reasons":["Fr = V / sqrt(g x A / T); below 1 disturbances travel upstream (subcritical), above 1 they cannot (supercritical).","A hydraulic jump forms if downstream conditions force the flow back to subcritical."],"shape":"rectangular","units":"si","depth":0.5,"velocity":5,"flow":5,"froudeNumber":2.2576182,"hydraulicDepth":0.5,"waveCelerity":2.2147235,"specificEnergy":1.77421,"flowArea":1,"topWidth":2,"flowRegime":"SUPERCRITICAL","bottomWidth":2,"degraded":false,"notChecked":["non-uniform or unsteady flow","air entrainment and roughness waves at high Froude numbers","…1 more"],"source":"computed locally (Fr = V / sqrt(g D_h), D_h = A / T)","asOf":"2026-10-21T06:26:57.559Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/froude-number"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/froude-number"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/froude-number"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/froude-number"}}]}}},"/manning-flow":{"get":{"operationId":"manning_flow","summary":"Manning flow, velocity and hydraulic radius for rectangular, trapezoidal, triangular or part-full circular channels, SI or US.","description":"Manning flow, velocity and hydraulic radius for rectangular, trapezoidal, triangular or part-full circular channels, SI or US.","tags":["manning","open-channel","flow","hydraulics"],"parameters":[{"name":"shape","in":"query","required":true,"description":"rectangular, trapezoidal, triangular or circular","schema":{"type":"string"}},{"name":"depth","in":"query","required":true,"description":"Flow depth in metres (units si) or feet (units us); for circular, not above the diameter","schema":{"type":"number"}},{"name":"n","in":"query","required":true,"description":"Manning roughness n (for example 0.013 concrete pipe, 0.035 natural channel)","schema":{"type":"number"}},{"name":"slope","in":"query","required":true,"description":"Channel bed slope, dimensionless (m/m or ft/ft), for example 0.001","schema":{"type":"number"}},{"name":"bottomWidth","in":"query","required":false,"description":"Bottom width in metres or feet (rectangular, trapezoidal)","schema":{"type":"number"}},{"name":"sideSlope","in":"query","required":false,"description":"Side slope z, horizontal run per 1 vertical (trapezoidal, triangular)","schema":{"type":"number"}},{"name":"diameter","in":"query","required":false,"description":"Pipe diameter in metres or feet (circular)","schema":{"type":"number"}},{"name":"units","in":"query","required":false,"description":"si (metres, constant 1.0; default) or us (feet, constant 1.486)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"shape":{"type":["null","string"]},"units":{"type":["null","string"]},"depth":{"type":["null","number"]},"n":{"type":["null","number"]},"slope":{"type":["null","number"]},"flowArea":{"type":["null","number"]},"wettedPerimeter":{"type":["null","number"]},"hydraulicRadius":{"type":["null","number"]},"topWidth":{"type":["null","number"]},"hydraulicDepth":{"type":["null","number"]},"velocity":{"type":["null","number"]},"flow":{"type":["null","number"]},"flowUnit":{"type":["null","string"]},"velocityUnit":{"type":["null","string"]},"froudeNumber":{"type":["null","number"]},"flowRegime":{"type":["null","string"]},"fullPipeFlow":{},"fractionOfFullFlow":{},"depthOverDiameter":{},"bottomWidth":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"rectangular, width 3, depth 1 m: Q = 2.8455 m3/s, V = 0.9485 m/s, hydraulic radius 0.6 m.","reasons":["Q = (1 / n) x A x R^(2/3) x S^(1/2) with A = 3, wetted perimeter P = 5, R = A / P.","Froude number 0.3028: subcritical flow.","…1 more"],"shape":"rectangular","units":"si","depth":1,"n":0.015,"slope":0.0004,"flowArea":3,"wettedPerimeter":5,"hydraulicRadius":0.6,"topWidth":3,"hydraulicDepth":1,"velocity":0.94850488,"flow":2.8455146,"flowUnit":"m3/s","velocityUnit":"m/s","froudeNumber":0.3028343,"flowRegime":"SUBCRITICAL","fullPipeFlow":null,"fractionOfFullFlow":null,"depthOverDiameter":null,"bottomWidth":3,"degraded":false,"notChecked":["whether n suits your channel, vegetation, bends or sediment","uniform-flow assumption (backwater, drawdown and transitions are ignored)","…1 more"],"source":"computed locally (Manning equation Q = (k/n) A R^(2/3) S^(1/2); k = 1 SI, 1.486 US)","asOf":"2026-10-21T06:26:57.821Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/manning-flow"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/manning-flow"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/manning-flow"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/manning-flow"}}]}}},"/normal-depth":{"get":{"operationId":"normal_depth","summary":"Normal (uniform-flow) depth for a given discharge in a rectangular, trapezoidal, triangular or circular channel by bisection.","description":"Normal (uniform-flow) depth for a given discharge in a rectangular, trapezoidal, triangular or circular channel by bisection.","tags":["normal-depth","manning","open-channel","hydraulics"],"parameters":[{"name":"shape","in":"query","required":true,"description":"rectangular, trapezoidal, triangular or circular","schema":{"type":"string"}},{"name":"flow","in":"query","required":true,"description":"Discharge in m3/s (units si) or ft3/s (units us)","schema":{"type":"number"}},{"name":"n","in":"query","required":true,"description":"Manning roughness n (for example 0.013 concrete, 0.035 natural channel)","schema":{"type":"number"}},{"name":"slope","in":"query","required":true,"description":"Channel bed slope, dimensionless (m/m or ft/ft)","schema":{"type":"number"}},{"name":"bottomWidth","in":"query","required":false,"description":"Bottom width in metres or feet (rectangular, trapezoidal)","schema":{"type":"number"}},{"name":"sideSlope","in":"query","required":false,"description":"Side slope z, horizontal run per 1 vertical (trapezoidal, triangular)","schema":{"type":"number"}},{"name":"diameter","in":"query","required":false,"description":"Pipe diameter in metres or feet (circular)","schema":{"type":"number"}},{"name":"units","in":"query","required":false,"description":"si (default) or us","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"shape":{"type":["null","string"]},"units":{"type":["null","string"]},"normalDepth":{"type":["null","number"]},"velocity":{"type":["null","number"]},"flowArea":{"type":["null","number"]},"hydraulicRadius":{"type":["null","number"]},"topWidth":{"type":["null","number"]},"froudeNumber":{"type":["null","number"]},"flowRegime":{"type":["null","string"]},"requestedFlow":{"type":["null","number"]},"depthOverDiameter":{},"bottomWidth":{"type":["null","number"]},"sideSlope":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"trapezoidal, bottom width 2, side slope 1.5H:1V: normal depth 1.71151 m at 8 m3/s, velocity 1.023 m/s, subcritical (Froude 0.3122).","reasons":["Depth found by bisection until Manning's discharge matches the given flow.","Uniform flow assumed."],"shape":"trapezoidal","units":"si","normalDepth":1.7115095,"velocity":1.0234215,"flowArea":7.8169161,"hydraulicRadius":0.95667337,"topWidth":7.1345285,"froudeNumber":0.3121655,"flowRegime":"SUBCRITICAL","requestedFlow":8,"depthOverDiameter":null,"bottomWidth":2,"sideSlope":1.5,"degraded":false,"notChecked":["gradually varied flow and backwater","whether the channel can carry the flow below bank-full or freeboard limits","…1 more"],"source":"computed locally (Manning equation solved by bisection on depth)","asOf":"2026-10-21T06:26:58.087Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/normal-depth"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/normal-depth"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/normal-depth"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/normal-depth"}}]}}},"/orifice-flow":{"get":{"operationId":"orifice_flow","summary":"Orifice discharge Q = Cd A sqrt(2 g h) for a round or given-area opening, with typical Cd by edge type, SI or US.","description":"Orifice discharge Q = Cd A sqrt(2 g h) for a round or given-area opening, with typical Cd by edge type, SI or US.","tags":["orifice","flow","hydraulics","discharge"],"parameters":[{"name":"head","in":"query","required":true,"description":"Head h from the water surface to the orifice centre in metres (si) or feet (us)","schema":{"type":"number"}},{"name":"diameter","in":"query","required":false,"description":"Orifice diameter in metres or feet (send diameter or area)","schema":{"type":"number"}},{"name":"area","in":"query","required":false,"description":"Orifice area in m2 or ft2 (send area or diameter)","schema":{"type":"number"}},{"name":"edge","in":"query","required":false,"description":"sharp (Cd 0.61, default), short-tube (0.82), rounded (0.98) or borda (0.51); or send cd","schema":{"type":"string"}},{"name":"cd","in":"query","required":false,"description":"Discharge coefficient override, 0.3 to 1","schema":{"type":"number"}},{"name":"units","in":"query","required":false,"description":"si (default) or us","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"units":{"type":["null","string"]},"head":{"type":["null","number"]},"area":{"type":["null","number"]},"cd":{"type":["null","number"]},"edge":{"type":["null","string"]},"idealVelocity":{"type":["null","number"]},"flow":{"type":["null","number"]},"flowUnit":{"type":["null","string"]},"flowIdeal":{"type":["null","number"]},"flowLitersPerSecond":{"type":["null","number"]},"flowGallonsPerMinute":{},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"Orifice area 0.007854 m2 under 2 m head with Cd 0.61: Q = 0.030011 m3/s.","reasons":["Torricelli speed sqrt(2 g h) = 6.2642 m/s; Q = Cd x A x that speed.","Cd 0.61 is a typical value for a sharp opening (sharp-edged 0.60 to 0.62, short tube 0.80 to 0.82, rounded 0.95 to 0.99, Borda re-entrant about 0.51)."],"units":"si","head":2,"area":0.0078539816,"cd":0.61,"edge":"sharp","idealVelocity":6.2641839,"flow":0.030011259,"flowUnit":"m3/s","flowIdeal":0.049198785,"flowLitersPerSecond":30.011259,"flowGallonsPerMinute":null,"degraded":false,"notChecked":["submerged orifices (head must be the difference across the opening)","approach velocity and nearby wall effects (Cd drops with partial contraction suppression)","…2 more"],"source":"computed locally (Torricelli v = sqrt(2 g h); Q = Cd A sqrt(2 g h); typical Cd from standard hydraulics texts)","asOf":"2026-10-21T06:26:58.339Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/orifice-flow"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/orifice-flow"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/orifice-flow"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/orifice-flow"}}]}}},"/rational-method":{"get":{"operationId":"rational_method","summary":"Peak runoff Q = C i A by the rational method, from a runoff coefficient, surface type or weighted sub-areas, SI or US.","description":"Peak runoff Q = C i A by the rational method, from a runoff coefficient, surface type or weighted sub-areas, SI or US.","tags":["rational-method","runoff","stormwater","hydrology"],"parameters":[{"name":"rainfallIntensity","in":"query","required":true,"description":"Design rainfall intensity i in mm/h (units si) or in/h (units us), for the time of concentration","schema":{"type":"number"}},{"name":"area","in":"query","required":true,"description":"Catchment area in hectares (units si) or acres (units us)","schema":{"type":"number"}},{"name":"c","in":"query","required":false,"description":"Runoff coefficient 0 to 1 (send one of c, surface or subareas)","schema":{"type":"number"}},{"name":"surface","in":"query","required":false,"description":"Surface type for a typical C range (midpoint used): pavement, roof, brick, gravel, lawn-sandy-flat, lawn-sandy-average, lawn-sandy-steep, lawn-heavy-flat, ... (see reasons)","schema":{"type":"string"}},{"name":"subareas","in":"query","required":false,"description":"Weighted C from pairs c:area separated by semicolons, e.g. 0.9:2;0.3:8 (areas in the same unit as area)","schema":{"type":"string"}},{"name":"units","in":"query","required":false,"description":"si (mm/h, hectares, m3/s; default) or us (in/h, acres, ft3/s)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"units":{"type":["null","string"]},"flow":{"type":["null","number"]},"flowUnit":{"type":["null","string"]},"runoffCoefficient":{"type":["null","number"]},"coefficientRange":{},"rainfallIntensity":{"type":["null","number"]},"area":{"type":["null","number"]},"flowLitersPerSecond":{"type":["null","number"]},"runoffVolumePerHour":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"Peak runoff Q = 0.69444 m3/s from 10 ha at C 0.5 and 50 mm/h.","reasons":["C = 0.5 as given.","Q = C i A / 360 (the constant converts mm/h x ha to m3/s).","…1 more"],"units":"si","flow":0.69444444,"flowUnit":"m3/s","runoffCoefficient":0.5,"coefficientRange":null,"rainfallIntensity":50,"area":10,"flowLitersPerSecond":694.44444,"runoffVolumePerHour":2500,"degraded":false,"notChecked":["time of concentration and the intensity-duration-frequency curve (the intensity is taken as given)","storage, routing and attenuation","…2 more"],"source":"computed locally (Q = C i A / 360 in SI with i mm/h and A ha giving m3/s; Q = C i A in US with i in/h and A acres giving ft3/s)","asOf":"2026-10-21T06:26:58.590Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/rational-method"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/rational-method"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/rational-method"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/rational-method"}}]}}},"/time-of-concentration":{"get":{"operationId":"time_of_concentration","summary":"Time of concentration by the Kirpich formula and the NRCS lag equation, with the limits of each stated.","description":"Time of concentration by the Kirpich formula and the NRCS lag equation, with the limits of each stated.","tags":["time-of-concentration","kirpich","nrcs","hydrology"],"parameters":[{"name":"flowPathLength","in":"query","required":true,"description":"Longest flow path length in metres (units si) or feet (units us)","schema":{"type":"number"}},{"name":"slope","in":"query","required":true,"description":"Average slope of the flow path, dimensionless (m/m or ft/ft), for example 0.02","schema":{"type":"number"}},{"name":"method","in":"query","required":false,"description":"both (default), kirpich or nrcs-lag","schema":{"type":"string"}},{"name":"curveNumber","in":"query","required":false,"description":"NRCS runoff curve number 30 to 100 (required for nrcs-lag and both)","schema":{"type":"number"}},{"name":"units","in":"query","required":false,"description":"si (default) or us","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"units":{"type":["null","string"]},"flowPathLength":{"type":["null","number"]},"slope":{"type":["null","number"]},"kirpich":{"type":["null","object"],"properties":{"tcMinutes":{"type":["null","number"]},"tcHours":{"type":["null","number"]},"formula":{"type":["null","string"]}}},"nrcsLag":{"type":["null","object"],"properties":{"lagHours":{"type":["null","number"]},"tcHours":{"type":["null","number"]},"tcMinutes":{"type":["null","number"]},"maxRetentionInches":{"type":["null","number"]},"watershedSlopePercent":{"type":["null","number"]},"curveNumber":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"Time of concentration over 1000 m at slope 0.01: Kirpich 23.444 min; NRCS lag 95.457 min.","reasons":["Kirpich: derived from small agricultural basins in Tennessee and Pennsylvania (about 0.4 to 45 ha, slopes about 3 to 10%); it tends to be applied well outside that range, so treat other results with c…","Slope 0.01 is outside the commonly cited 0.03 to 0.10 range for Kirpich.","…1 more"],"units":"si","flowPathLength":1000,"slope":0.01,"kirpich":{"tcMinutes":23.44416,"tcHours":0.3907359,"formula":"tc = 0.0195 L^0.77 S^-0.385 (L in m)"},"nrcsLag":{"lagHours":0.9545747,"tcHours":1.590958,"tcMinutes":95.45747,"maxRetentionInches":3.333333,"watershedSlopePercent":1,"curveNumber":75},"degraded":false,"notChecked":["flow path composition (overland, shallow concentrated and channel segments are not separated)","urbanisation, channel lining or detention (Kirpich is for natural small basins)","…1 more"],"source":"computed locally (Kirpich 1940: tc = 0.0195 L^0.77 S^-0.385 min, L in m; NRCS NEH Part 630 ch. 15 lag equation, tc = lag / 0.6)","asOf":"2026-10-21T06:26:58.841Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/time-of-concentration"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/time-of-concentration"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/time-of-concentration"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/time-of-concentration"}}]}}},"/weir-flow":{"get":{"operationId":"weir_flow","summary":"Discharge over a sharp-crested rectangular (Francis), V-notch or Cipolletti weir from head, SI or US units.","description":"Discharge over a sharp-crested rectangular (Francis), V-notch or Cipolletti weir from head, SI or US units.","tags":["weir","flow","hydraulics","v-notch"],"parameters":[{"name":"type","in":"query","required":true,"description":"rectangular, v-notch or cipolletti","schema":{"type":"string"}},{"name":"head","in":"query","required":true,"description":"Head over the crest H in metres (si) or feet (us), measured upstream of the drawdown","schema":{"type":"number"}},{"name":"crestLength","in":"query","required":false,"description":"Crest length L in metres or feet (rectangular, cipolletti)","schema":{"type":"number"}},{"name":"contractions","in":"query","required":false,"description":"Rectangular end contractions 0, 1 or 2 for the Francis correction (default 2)","schema":{"type":"integer"}},{"name":"notchAngleDeg","in":"query","required":false,"description":"V-notch included angle in degrees, 10 to 120 (default 90)","schema":{"type":"number"}},{"name":"cd","in":"query","required":false,"description":"Discharge coefficient Cd: rectangular then uses the (2/3) Cd sqrt(2g) form instead of Francis; V-notch default 0.585","schema":{"type":"number"}},{"name":"units","in":"query","required":false,"description":"si (metres, m3/s; default) or us (feet, ft3/s)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"type":{"type":["null","string"]},"units":{"type":["null","string"]},"head":{"type":["null","number"]},"crestLength":{},"notchAngleDeg":{"type":["null","number"]},"contractions":{},"flow":{"type":["null","number"]},"flowUnit":{"type":["null","string"]},"coefficient":{"type":["null","number"]},"flowPerUnitLength":{},"warnings":{"type":["array","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"v-notch weir at head 0.2 m: Q = 0.024722 m3/s.","reasons":["Q = (8/15) Cd sqrt(2g) tan(theta/2) H^2.5 with Cd = 0.585, theta = 90 degrees.","Coefficient on H^2.5: 1.382 (compare the 90 degree rule of thumb Q = 1.38 H^2.5 in SI, 2.5 H^2.5 in US)."],"type":"v-notch","units":"si","head":0.2,"crestLength":null,"notchAngleDeg":90,"contractions":null,"flow":0.024721743,"flowUnit":"m3/s","coefficient":1.3819874,"flowPerUnitLength":null,"warnings":[],"degraded":false,"notChecked":["approach velocity, submergence and an unventilated nappe","head-measurement location and crest condition","…1 more"],"source":"computed locally (Francis Q = 1.84 (L - 0.1 n H) H^1.5; V-notch Q = (8/15) Cd sqrt(2g) tan(theta/2) H^2.5; Cipolletti Q = 1.859 L H^1.5, SI)","asOf":"2026-10-21T06:26:59.093Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/weir-flow"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/weir-flow"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/weir-flow"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hydrology-calc.x402tookit.com/weir-flow"}}]}}}}}