{"openapi":"3.1.0","info":{"title":"Lever & Simple Machine API","version":"1.0.0","description":"Lever, moment-balance and simple-machine mechanical-advantage maths as an API, computed locally and deterministically. The lever endpoint applies the lever law, effort·effort_arm = load·load_arm, and solves for whichever of the effort, the load, the effort arm or the load arm you leave out, returning the mechanical advantage MA = effort_arm/load_arm = load/effort and whether the lever multiplies force or speed. The moment endpoint computes a single moment of force, M = F·d, or balances a seesaw about a pivot: from the force and distance on each side it tells you whether it is balanced, the net moment and which way it rotates, or solves the one value you omit to bring it into equilibrium. The machine endpoint gives the ideal mechanical advantage of a simple machine — an inclined plane (length/height), a screw (2πR/pitch), a wheel and axle (R/r), a wedge (length/thickness) or a pulley system (number of supporting strands) — and, given an efficiency and an effort, the actual mechanical advantage and the output force. Everything is computed locally and deterministically, so it is instant and private. Ideal for physics and engineering-education tools, mechanics and statics apps, and machine-design and DIY calculators. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is levers and simple-machine mechanical advantage; for gear and belt drive ratios use a gear or belt-drive API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/lever-api","description":"oanor gateway"}],"tags":[{"name":"Lever"},{"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/lever":{"get":{"operationId":"get_v1_lever","tags":["Lever"],"summary":"Lever law & mechanical advantage","description":"","parameters":[{"name":"load","in":"query","required":false,"description":"Load force","schema":{"type":"string"},"example":"100"},{"name":"effort","in":"query","required":false,"description":"Effort force","schema":{"type":"string"}},{"name":"effort_arm","in":"query","required":false,"description":"Effort arm (distance to fulcrum)","schema":{"type":"string"},"example":"2"},{"name":"load_arm","in":"query","required":false,"description":"Load arm (distance to fulcrum)","schema":{"type":"string"},"example":"0.5"},{"name":"class","in":"query","required":false,"description":"Lever class 1|2|3 (optional label)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"formula":"effort·effort_arm = load·load_arm; MA = effort_arm/load_arm = load/effort.","load_arm":0.5,"effort_arm":2,"load_force":100,"effort_force":25,"advantage_type":"force multiplier (MA > 1)","mechanical_advantage":4},"meta":{"timestamp":"2026-06-04T10:18:48.639Z","request_id":"ab4bf347-75a6-4f25-81ee-4ac2d8cc02ba"},"status":"ok","message":"Lever law & mechanical advantage","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/machine":{"get":{"operationId":"get_v1_machine","tags":["Lever"],"summary":"Simple-machine mechanical advantage","description":"","parameters":[{"name":"machine","in":"query","required":true,"description":"inclined_plane|screw|wheel_and_axle|wedge|pulley","schema":{"type":"string"},"example":"inclined_plane"},{"name":"length","in":"query","required":false,"description":"Length (inclined plane / wedge)","schema":{"type":"string"},"example":"5"},{"name":"height","in":"query","required":false,"description":"Height (inclined plane)","schema":{"type":"string"},"example":"1"},{"name":"handle_radius","in":"query","required":false,"description":"Handle radius (screw)","schema":{"type":"string"}},{"name":"pitch","in":"query","required":false,"description":"Pitch (screw)","schema":{"type":"string"}},{"name":"wheel_radius","in":"query","required":false,"description":"Wheel radius (wheel & axle)","schema":{"type":"string"}},{"name":"axle_radius","in":"query","required":false,"description":"Axle radius (wheel & axle)","schema":{"type":"string"}},{"name":"supporting_strands","in":"query","required":false,"description":"Supporting strands (pulley)","schema":{"type":"string"}},{"name":"efficiency","in":"query","required":false,"description":"Efficiency 0–1 for actual MA","schema":{"type":"string"}},{"name":"effort","in":"query","required":false,"description":"Effort force for output force","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"height":1,"length":5,"formula":"inclined plane L/h; screw 2πR/pitch; wheel&axle R/r; wedge L/t; pulley = supporting strands.","machine":"inclined_plane","ideal_mechanical_advantage":5},"meta":{"timestamp":"2026-06-04T10:18:48.743Z","request_id":"bab1c24c-2161-4a31-a3db-d645c67f2649"},"status":"ok","message":"Simple-machine mechanical advantage","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/moment":{"get":{"operationId":"get_v1_moment","tags":["Lever"],"summary":"Moment / seesaw balance","description":"","parameters":[{"name":"force","in":"query","required":false,"description":"Force for a single moment M=F·d","schema":{"type":"string"},"example":"50"},{"name":"distance","in":"query","required":false,"description":"Distance (moment arm)","schema":{"type":"string"},"example":"0.3"},{"name":"left_force","in":"query","required":false,"description":"Left-side force (for balance)","schema":{"type":"string"}},{"name":"left_distance","in":"query","required":false,"description":"Left-side distance","schema":{"type":"string"}},{"name":"right_force","in":"query","required":false,"description":"Right-side force (omit one to solve)","schema":{"type":"string"}},{"name":"right_distance","in":"query","required":false,"description":"Right-side distance","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mode":"single_moment","force":50,"formula":"M = F · d.","distance":0.3,"moment_nm":15},"meta":{"timestamp":"2026-06-04T10:18:48.859Z","request_id":"8d0cd80f-8364-45bb-a626-5f2a1346a989"},"status":"ok","message":"Moment / seesaw balance","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":"lever","note":"Lever, moment balance and simple-machine mechanical advantage — computed locally and deterministically, no key, no third-party service.","machines":["inclined_plane","screw","wheel_and_axle","wedge","pulley"],"endpoints":["/v1/lever","/v1/moment","/v1/machine","/v1/meta"]},"meta":{"timestamp":"2026-06-04T10:18:48.965Z","request_id":"4c503013-976c-4af1-8d46-e2af5453d900"},"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":2000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":40000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":1500000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/lever-api"}