Spec

Code snippets

curl "https://api.oanor.com/gearratio-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/gearratio-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/gearratio-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/gearratio-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "notes": "Teeth counts or diameters are unitless ratios; speed in rpm, torque in any consistent unit. A ratio > 1 is a reduction (more torque, less speed). Idler gears only reverse direction.",
        "service": "gearratio-api",
        "formulae": {
            "ratio": "ratio = N_driven/N_driver",
            "speed": "output = input/ratio",
            "train": "overall = Π(driven_i/driver_i)",
            "torque": "output = input·ratio·efficiency"
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ratio": "Gear ratio (from teeth or diameters) with output speed and torque.",
            "GET /v1/solve": "Solve the missing one of input speed, output speed and ratio.",
            "GET /v1/train": "Compound-train overall ratio from a list of stages, with output speed and torque."
        },
        "description": "Gear-train ratio calculator: single-pair ratio with speed and torque, compound-train overall ratio, and speed/ratio solving."
    },
    "meta": {
        "timestamp": "2026-06-04T18:38:22.764Z",
        "request_id": "1911ad03-0aff-4a22-8eeb-56f329b4382d"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}