{"openapi":"3.1.0","info":{"title":"Drag & Terminal Velocity API","version":"1.0.0","description":"Aerodynamic drag and terminal-velocity maths as an API, computed locally and deterministically. The drag endpoint computes the drag force on a body moving through a fluid, F_d = ½·ρ·Cd·A·v² — half the fluid density times the drag coefficient, the reference area and the velocity squared — together with the dynamic pressure ½·ρ·v², from a fluid (air, water, seawater, oil and more, or a custom density), a drag coefficient (given directly or from a built-in shape table) the area and the speed. The terminal endpoint computes the terminal velocity of a falling object, v_t = √(2·m·g/(ρ·Cd·A)) — the steady speed at which drag balances gravity — from the mass and area, or for a sphere from its diameter and material density, in metres per second, km/h and mph (a belly-down skydiver reaches about 55 m/s, 200 km/h). The shapes endpoint lists typical drag coefficients for spheres, cubes, cylinders, flat plates, streamlined bodies, skydivers, cars, parachutes and more. Everything is computed locally and deterministically, so it is instant and private. Ideal for aerodynamics and ballistics tools, skydiving, model-rocketry and motorsport apps, sphere-settling and sedimentation calculators, and physics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is drag and terminal velocity; for vacuum projectile and SUVAT kinematics use a physics API and for pipe friction pressure drop use a Darcy-Weisbach API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/drag-api","description":"oanor gateway"}],"tags":[{"name":"Drag"},{"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/drag":{"get":{"operationId":"get_v1_drag","tags":["Drag"],"summary":"Drag force","description":"","parameters":[{"name":"fluid","in":"query","required":false,"description":"air|water|seawater|oil… (default air)","schema":{"type":"string"},"example":"air"},{"name":"density","in":"query","required":false,"description":"Or fluid density (kg/m³)","schema":{"type":"string"}},{"name":"drag_coefficient","in":"query","required":false,"description":"Cd","schema":{"type":"string"},"example":"0.47"},{"name":"shape","in":"query","required":false,"description":"Or a shape (sphere, cube, car…)","schema":{"type":"string"},"example":"sphere"},{"name":"area","in":"query","required":true,"description":"Reference area (m²)","schema":{"type":"string"},"example":"0.01"},{"name":"velocity","in":"query","required":true,"description":"Velocity (m/s)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fluid":"air","area_m2":0.01,"formula":"F_d = ½·ρ·Cd·A·v²; dynamic pressure q = ½·ρ·v².","velocity_ms":10,"drag_force_n":0.287875,"density_kg_m3":1.225,"drag_force_kgf":0.029355,"drag_coefficient":0.47,"dynamic_pressure_pa":61.25,"drag_coefficient_source":"given"},"meta":{"timestamp":"2026-06-04T10:18:46.192Z","request_id":"d505717d-7dcf-4588-846e-d7a2abe2ee90"},"status":"ok","message":"Drag force","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/shapes":{"get":{"operationId":"get_v1_shapes","tags":["Drag"],"summary":"Drag-coefficient reference","description":"","parameters":[{"name":"shape","in":"query","required":false,"description":"A shape to look up (or omit for all)","schema":{"type":"string"},"example":"parachute"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"shape":"parachute","drag_coefficient":1.75},"meta":{"timestamp":"2026-06-04T10:18:46.299Z","request_id":"3ca5efa6-7633-4439-b138-0352bc1a9942"},"status":"ok","message":"Drag-coefficient reference","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/terminal":{"get":{"operationId":"get_v1_terminal","tags":["Drag"],"summary":"Terminal velocity","description":"","parameters":[{"name":"mass","in":"query","required":false,"description":"Mass (kg)","schema":{"type":"string"},"example":"80"},{"name":"area","in":"query","required":false,"description":"Reference area (m²)","schema":{"type":"string"},"example":"0.7"},{"name":"diameter","in":"query","required":false,"description":"Or sphere diameter (m)","schema":{"type":"string"}},{"name":"object_density","in":"query","required":false,"description":"Sphere material density (kg/m³)","schema":{"type":"string"}},{"name":"drag_coefficient","in":"query","required":false,"description":"Cd (or shape)","schema":{"type":"string"},"example":"1.0"},{"name":"shape","in":"query","required":false,"description":"Shape for Cd","schema":{"type":"string"}},{"name":"fluid","in":"query","required":false,"description":"Fluid (default air)","schema":{"type":"string"},"example":"air"},{"name":"gravity","in":"query","required":false,"description":"Gravity (default 9.80665)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fluid":"air","area_m2":0.7,"formula":"v_t = √(2·m·g / (ρ·Cd·A)).","mass_kg":80,"gravity_ms2":9.80665,"density_kg_m3":1.225,"drag_coefficient":1,"terminal_velocity":{"velocity_ms":42.776305,"velocity_kmh":153.994697,"velocity_mph":95.687868},"drag_coefficient_source":"given"},"meta":{"timestamp":"2026-06-04T10:18:46.396Z","request_id":"73a2e897-093b-41ee-92ab-230b2af8218d"},"status":"ok","message":"Terminal velocity","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":"drag","note":"Aerodynamic drag & terminal velocity — computed locally and deterministically, no key, no third-party service.","fluids":["air","water","seawater","oil","helium","co2"],"shapes":["sphere","smooth_sphere","cube","cube_angled","cylinder","long_cylinder","short_cylinder","flat_plate","flat_plate_perpendicular","angled_cube","streamlined_body","airfoil","teardrop","hemisphere","hemisphere_hollow","cone","skydiver_belly","skydiver_headdown","car","bicycle","person_standing","parachute","raindrop"],"endpoints":["/v1/drag","/v1/terminal","/v1/shapes","/v1/meta"]},"meta":{"timestamp":"2026-06-04T10:18:46.471Z","request_id":"a7bfb1a0-2587-42d7-93a2-d6508ec12a18"},"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":500,"monthly_call_quota":40000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1500,"monthly_call_quota":300000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4900,"monthly_call_quota":2000000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/drag-api"}