/v1/fret-position
Fret distance from the nut
Try it live
10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.
It works. Grab an API key and use it in your project.
Get an API keyCode snippets
curl "https://api.oanor.com/guitar-api/v1/fret-position" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/guitar-api/v1/fret-position", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/guitar-api/v1/fret-position");
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/guitar-api/v1/fret-position",
headers={"x-oanor-key": "oanor_test_..."}
)
Example response
A real response from this endpoint, captured by the latest health check.
{
"data": {
"note": "Fret distance from the nut = scale length × (1 − 2^(−fret/12)) — equal temperament, where each fret is the twelfth root of two higher in pitch. The 12th fret sits exactly halfway (the octave), and the frets crowd together toward the bridge. The rule of 18 (≈ 17.817) is the old luthier's approximation of the same maths.",
"inputs": {
"fret_number": 12,
"scale_length_in": 25.5
},
"distance_from_nut_in": 12.75,
"remaining_to_bridge_in": 12.75,
"spacing_from_previous_in": 0.7582
},
"meta": {
"timestamp": "2026-06-06T23:54:00.359Z",
"request_id": "6a20607d-cb93-480a-b00f-e4c6c5a6c276"
},
"status": "ok",
"message": "Fret position",
"success": true
}