{"openapi":"3.1.0","info":{"title":"Hydrostatic Pressure API","version":"1.0.0","description":"Fluid-statics maths as an API, computed locally and deterministically. The pressure endpoint computes the pressure at a depth in a fluid — the gauge pressure ρ·g·h and the absolute pressure (gauge plus atmospheric) — in pascals, kilopascals, bar, psi and atmospheres, for water, seawater, oil, mercury and more, or a custom density; depths accept metres, feet or centimetres, which makes it handy for diving (about 10 m of seawater adds one atmosphere). The force endpoint computes the resultant hydrostatic force on a submerged vertical rectangular surface — an aquarium wall, a tank side, a dam face or a flood gate — as F = ρ·g·h_c·A from its width and the top and bottom depths, and gives the depth of the centre of pressure, which sits below the centroid. The buoyancy endpoint applies Archimedes' principle, F_b = ρ_fluid·g·V, to give the buoyant force and the displaced mass, and — if you supply the object's density or mass — tells you whether it floats or sinks and what fraction sits below the waterline. Everything is computed locally and deterministically, so it is instant and private. Ideal for civil and marine engineering tools, diving and aquarium apps, tank and dam design, and physics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is fluid statics; for pump power and head use a pump API and for pipe flow rate use a pipe-flow API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hydrostatic-api","description":"oanor gateway"}],"tags":[{"name":"Hydrostatic"},{"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/buoyancy":{"get":{"operationId":"get_v1_buoyancy","tags":["Hydrostatic"],"summary":"Buoyancy & flotation","description":"","parameters":[{"name":"volume","in":"query","required":true,"description":"Displaced volume (m³)","schema":{"type":"string"},"example":"0.01"},{"name":"fluid","in":"query","required":false,"description":"Fluid (default water)","schema":{"type":"string"},"example":"water"},{"name":"density","in":"query","required":false,"description":"Or explicit fluid density","schema":{"type":"string"}},{"name":"object_density","in":"query","required":false,"description":"Object density (for flotation)","schema":{"type":"string"},"example":"500"},{"name":"mass","in":"query","required":false,"description":"Or object mass (kg)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Buoyant force = ρ_fluid·g·V_displaced (Archimedes).","fluid":"water","floats":true,"volume_m3":0.01,"buoyant_force":{"N":98.067,"kN":0.09807,"kgf":10},"object_weight_N":49.033,"displaced_mass_kg":10,"submerged_percent":50,"submerged_fraction":0.5,"fluid_density_kg_m3":1000},"meta":{"timestamp":"2026-06-04T01:59:04.529Z","request_id":"c5a661a2-f687-401f-b8f6-2eae872ed2fd"},"status":"ok","message":"Buoyancy & flotation","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/force":{"get":{"operationId":"get_v1_force","tags":["Hydrostatic"],"summary":"Force on a submerged wall","description":"","parameters":[{"name":"width","in":"query","required":true,"description":"Width of the surface","schema":{"type":"string"},"example":"3"},{"name":"height","in":"query","required":false,"description":"Height (surface starts at top_depth)","schema":{"type":"string"},"example":"2"},{"name":"top_depth","in":"query","required":false,"description":"Depth of the top edge (default 0)","schema":{"type":"string"},"example":"0"},{"name":"bottom_depth","in":"query","required":false,"description":"Or depth of the bottom edge","schema":{"type":"string"}},{"name":"fluid","in":"query","required":false,"description":"Fluid (default water)","schema":{"type":"string"},"example":"water"},{"name":"density","in":"query","required":false,"description":"Or explicit density","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"F = ρ·g·hc·A on a vertical surface; hc = centroid depth. Centre of pressure is below the centroid by I/(hc·A).","fluid":"water","width_m":3,"top_depth_m":0,"density_kg_m3":1000,"bottom_depth_m":2,"resultant_force":{"N":58839.9,"kN":58.8399,"kgf":6000},"surface_area_m2":6,"centroid_depth_m":1,"center_of_pressure_depth_m":1.3333},"meta":{"timestamp":"2026-06-04T01:59:04.632Z","request_id":"48ed1ee7-be54-49f9-9b95-b18970e96919"},"status":"ok","message":"Hydrostatic force on a wall","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/pressure":{"get":{"operationId":"get_v1_pressure","tags":["Hydrostatic"],"summary":"Pressure at depth","description":"","parameters":[{"name":"depth","in":"query","required":true,"description":"Depth","schema":{"type":"string"},"example":"10"},{"name":"depth_unit","in":"query","required":false,"description":"m|ft|cm (default m)","schema":{"type":"string"},"example":"m"},{"name":"fluid","in":"query","required":false,"description":"water|seawater|oil|mercury|… (default water)","schema":{"type":"string"},"example":"water"},{"name":"density","in":"query","required":false,"description":"Or explicit density (kg/m³)","schema":{"type":"string"}},{"name":"atmospheric_pa","in":"query","required":false,"description":"Atmospheric pressure (default 101325)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Gauge pressure = ρ·g·h. Absolute = gauge + atmospheric (101325 Pa default). For diving, ~10 m of seawater adds about 1 atm.","fluid":"water","depth_m":10,"density_kg_m3":1000,"gauge_pressure":{"pa":98066.5,"atm":0.96784,"bar":0.98067,"kpa":98.0665,"psi":14.2233},"head_m_of_fluid":10,"absolute_pressure":{"pa":199391.5,"atm":1.96784,"bar":1.99392,"kpa":199.3915,"psi":28.9193}},"meta":{"timestamp":"2026-06-04T01:59:04.732Z","request_id":"012a046c-15b0-44e0-88d4-5083fbd070b9"},"status":"ok","message":"Pressure at depth","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":{"api":"hydrostatic","note":"Fluid-statics maths — computed locally and deterministically, no key, no third-party service.","fluids":["water","freshwater","seawater","saltwater","oil","diesel","gasoline","petrol","ethanol","mercury","glycerin","glycol","milk","honey"],"endpoints":["/v1/pressure","/v1/force","/v1/buoyancy","/v1/meta"]},"meta":{"timestamp":"2026-06-04T01:59:04.805Z","request_id":"817b3c07-ed24-4956-b8ee-720b6c66aacf"},"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":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":40000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":300000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7500,"monthly_call_quota":2500000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hydrostatic-api"}