{"openapi":"3.1.0","info":{"title":"Capillary & Surface Tension API","version":"1.0.0","description":"Surface-tension and small-scale fluid-physics maths as an API, computed locally and deterministically. The capillary-rise endpoint applies Jurin's law, h = 2γ·cosθ / (ρ·g·r), to give the height a liquid climbs (or, for a contact angle above 90° like mercury, is depressed) in a narrow tube from its surface tension, the tube radius, the liquid density and the contact angle — and can solve the surface tension back from a measured rise. The laplace-pressure endpoint computes the Young-Laplace excess pressure across a curved interface: a liquid droplet ΔP = 2γ/r, a soap bubble ΔP = 4γ/r (two surfaces) and a cylindrical jet ΔP = γ/r. The poiseuille endpoint applies the Hagen-Poiseuille law, Q = π·r⁴·ΔP / (8·μ·L), for laminar flow in a pipe, returning the volumetric flow rate, the average velocity and the peak centreline velocity (twice the average) from the radius, the pressure drop, the fluid viscosity and the length. Surface tension is in N/m, lengths in m, density in kg/m³, viscosity in Pa·s and pressures in Pa; water is γ ≈ 0.0728 N/m at 20 °C. Everything is computed locally and deterministically, so it is instant and private. Ideal for microfluidics, fluid-engineering, lab-on-a-chip, inkjet and coating app developers, capillary-action and wicking tools, and physics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is surface tension and capillarity; for incompressible Bernoulli flow use a Bernoulli API and for pipe friction a Darcy API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/capillary-api","description":"oanor gateway"}],"tags":[{"name":"Capillary"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/capillary-rise":{"get":{"operationId":"get_v1_capillary_rise","tags":["Capillary"],"summary":"Capillary rise","description":"","parameters":[{"name":"surface_tension","in":"query","required":true,"description":"Surface tension γ (N/m)","schema":{"type":"string"},"example":"0.0728"},{"name":"radius","in":"query","required":true,"description":"Tube radius (m)","schema":{"type":"string"},"example":"0.0005"},{"name":"density","in":"query","required":false,"description":"Liquid density (kg/m³)","schema":{"type":"string"},"example":"1000"},{"name":"contact_angle","in":"query","required":false,"description":"Contact angle (deg)","schema":{"type":"string"},"example":"0"},{"name":"gravity","in":"query","required":false,"description":"Gravity (m/s²)","schema":{"type":"string"},"example":"9.80665"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Jurin's law: h = 2γ·cosθ / (ρ·g·r). A contact angle above 90° (e.g. mercury) gives a depression.","inputs":{"radius_m":0.0005,"gravity_ms2":9.80665,"density_kg_m3":1000,"contact_angle_deg":0,"surface_tension_n_m":0.0728},"direction":"rise (wetting, θ < 90°)","capillary_rise_m":0.029694136,"capillary_rise_mm":29.694136},"meta":{"timestamp":"2026-06-05T03:08:57.906Z","request_id":"5eb93a61-bfc5-40d0-bdbc-dd1066305296"},"status":"ok","message":"Capillary rise","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/laplace-pressure":{"get":{"operationId":"get_v1_laplace_pressure","tags":["Capillary"],"summary":"Young-Laplace pressure","description":"","parameters":[{"name":"surface_tension","in":"query","required":true,"description":"Surface tension γ (N/m)","schema":{"type":"string"},"example":"0.0728"},{"name":"radius","in":"query","required":true,"description":"Radius (m)","schema":{"type":"string"},"example":"0.001"},{"name":"shape","in":"query","required":false,"description":"droplet, bubble or cylinder","schema":{"type":"string"},"example":"droplet"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Young-Laplace: a liquid droplet ΔP = 2γ/r; a soap bubble has two surfaces so ΔP = 4γ/r; a cylindrical jet ΔP = γ/r.","inputs":{"shape":"droplet","radius_m":0.001,"surface_tension_n_m":0.0728},"formula_factor":2,"excess_pressure_pa":145.6,"excess_pressure_kpa":0.1456},"meta":{"timestamp":"2026-06-05T03:08:57.984Z","request_id":"aad444ef-5d52-4449-8bd2-72a0047863c8"},"status":"ok","message":"Laplace pressure","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/poiseuille":{"get":{"operationId":"get_v1_poiseuille","tags":["Capillary"],"summary":"Hagen-Poiseuille flow","description":"","parameters":[{"name":"radius","in":"query","required":true,"description":"Pipe radius (m)","schema":{"type":"string"},"example":"0.005"},{"name":"pressure_drop","in":"query","required":true,"description":"Pressure drop (Pa)","schema":{"type":"string"},"example":"1000"},{"name":"viscosity","in":"query","required":true,"description":"Dynamic viscosity (Pa·s)","schema":{"type":"string"},"example":"0.001"},{"name":"length","in":"query","required":true,"description":"Pipe length (m)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Hagen-Poiseuille: Q = π·r⁴·ΔP / (8·μ·L) for laminar flow. Peak (centreline) velocity is twice the average.","inputs":{"length_m":1,"radius_m":0.005,"viscosity_pa_s":0.001,"pressure_drop_pa":1000},"max_velocity_ms":6.25,"average_velocity_ms":3.125,"volumetric_flow_lpm":14.726216,"volumetric_flow_m3s":0.000245436926},"meta":{"timestamp":"2026-06-05T03:08:58.043Z","request_id":"80930176-54ce-449a-94ed-1e9462ca796b"},"status":"ok","message":"Poiseuille flow","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Surface tension in N/m, radii and lengths in m, density in kg/m³, viscosity in Pa·s, pressures in Pa. Water γ ≈ 0.0728 N/m at 20 °C.","service":"capillary-api","formulae":{"poiseuille":"Q = π·r⁴·ΔP / (8·μ·L)","capillary_rise":"h = 2γ·cosθ / (ρ·g·r)","laplace_droplet":"ΔP = 2γ/r"},"endpoints":{"GET /v1/meta":"This document.","GET /v1/poiseuille":"Laminar pipe flow rate and velocity from radius, pressure drop and viscosity.","GET /v1/capillary-rise":"Capillary rise (or depression) height from surface tension, radius and contact angle.","GET /v1/laplace-pressure":"Excess pressure inside a droplet, soap bubble or cylindrical jet."},"description":"Surface-tension and small-scale fluid calculator: capillary rise (Jurin's law), Young-Laplace excess pressure for droplets and bubbles, and Hagen-Poiseuille laminar pipe flow."},"meta":{"timestamp":"2026-06-05T03:08:58.111Z","request_id":"c5ee366d-147f-48e1-a52a-44ddfb7bd56d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":50000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2500,"monthly_call_quota":350000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":2000000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/capillary-api"}