{"openapi":"3.1.0","info":{"title":"Antenna Length API","version":"1.0.0","description":"Antenna length maths as an API, computed locally and deterministically. The dipole endpoint gives the total and per-leg length of a half-wave dipole for a frequency, in metres, feet, inches and centimetres, applying a velocity factor (about 0.95 for wire) and also reporting the classic 468 ÷ f(MHz) feet rule of thumb. The quarterwave endpoint gives the element length of a quarter-wave vertical or monopole, with the 234 ÷ f(MHz) rule. The element endpoint computes the length of an element at any fraction of a wavelength — full-wave, half-wave, quarter-wave, fifth-wave, five-eighths or a custom fraction. Frequencies accept Hz, kHz, MHz and GHz, and the velocity factor is configurable. Everything is computed locally and deterministically, so it is instant and private. These are starting lengths: real antennas need trimming and tuning for the lowest SWR, as end effects and surroundings shift the resonant length. Ideal for amateur-radio and RF tools, antenna and IoT design, and electronics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is antenna geometry; for general wavelength, frequency and photon energy use a wavelength API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/antenna-api","description":"oanor gateway"}],"tags":[{"name":"Antenna"},{"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/dipole":{"get":{"operationId":"get_v1_dipole","tags":["Antenna"],"summary":"Half-wave dipole length","description":"","parameters":[{"name":"frequency","in":"query","required":true,"description":"Frequency","schema":{"type":"string"},"example":"14.2"},{"name":"frequency_unit","in":"query","required":false,"description":"hz|khz|mhz|ghz (default mhz)","schema":{"type":"string"},"example":"mhz"},{"name":"velocity_factor","in":"query","required":false,"description":"default 0.95","schema":{"type":"string"},"example":"0.95"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Half-wave dipole = 0.5 · λ · velocity factor (≈0.95 for wire). Each leg is half the total. Rule of thumb: 468 ÷ f(MHz) feet.","input":{"frequency_mhz":14.2,"velocity_factor":0.95},"each_leg":{"cm":501.41,"feet":16.4506,"inches":197.407,"metres":5.0141},"total_length":{"cm":1002.83,"feet":32.9011,"inches":394.814,"metres":10.0283},"full_wavelength_m":21.1121,"rule_of_thumb_feet":32.958},"meta":{"timestamp":"2026-06-04T01:59:16.266Z","request_id":"4d6e1f11-7e2e-4763-bdb7-64767e3339a3"},"status":"ok","message":"Half-wave dipole","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/element":{"get":{"operationId":"get_v1_element","tags":["Antenna"],"summary":"Element of any wavelength fraction","description":"","parameters":[{"name":"frequency","in":"query","required":true,"description":"Frequency","schema":{"type":"string"},"example":"146"},{"name":"type","in":"query","required":false,"description":"fullwave|halfwave|quarterwave|fifthwave|5/8","schema":{"type":"string"},"example":"halfwave"},{"name":"fraction","in":"query","required":false,"description":"Or a custom fraction","schema":{"type":"string"}},{"name":"frequency_unit","in":"query","required":false,"description":"hz|khz|mhz|ghz","schema":{"type":"string"},"example":"mhz"},{"name":"velocity_factor","in":"query","required":false,"description":"default 0.95","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Element length = fraction · λ · velocity factor. Pass type (fullwave/halfwave/quarterwave/fifthwave/5-8) or an explicit fraction.","input":{"fraction":0.5,"frequency_mhz":146,"velocity_factor":0.95},"element_length":{"cm":97.54,"feet":3.2,"inches":38.4,"metres":0.9754},"full_wavelength_m":2.0534},"meta":{"timestamp":"2026-06-04T01:59:16.359Z","request_id":"7c4b9af9-78c8-46e8-b30e-ae4949fbb8b6"},"status":"ok","message":"Arbitrary element","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/quarterwave":{"get":{"operationId":"get_v1_quarterwave","tags":["Antenna"],"summary":"Quarter-wave element length","description":"","parameters":[{"name":"frequency","in":"query","required":true,"description":"Frequency","schema":{"type":"string"},"example":"14.2"},{"name":"frequency_unit","in":"query","required":false,"description":"hz|khz|mhz|ghz","schema":{"type":"string"},"example":"mhz"},{"name":"velocity_factor","in":"query","required":false,"description":"default 0.95","schema":{"type":"string"},"example":"0.95"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Quarter-wave vertical/monopole = 0.25 · λ · velocity factor. Needs a ground plane or radials. Rule of thumb: 234 ÷ f(MHz) feet.","input":{"frequency_mhz":14.2,"velocity_factor":0.95},"element_length":{"cm":501.41,"feet":16.4506,"inches":197.407,"metres":5.0141},"full_wavelength_m":21.1121,"rule_of_thumb_feet":16.479},"meta":{"timestamp":"2026-06-04T01:59:16.444Z","request_id":"ee377d91-7b22-4643-86d9-aa71ac749036"},"status":"ok","message":"Quarter-wave element","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":{"note":"Starting lengths only — trim and tune for lowest SWR; surroundings and end effects shift resonance.","service":"antenna","endpoints":{"/v1/dipole":"Half-wave dipole total and per-leg length (m/ft/in) for a frequency.","/v1/element":"Element length for any fraction of a wavelength (full/half/quarter/fifth/5-8 or custom).","/v1/quarterwave":"Quarter-wave vertical/monopole element length."},"description":"Antenna length maths: half-wave dipole, quarter-wave vertical and arbitrary elements from a frequency and velocity factor.","velocity_factor_default":0.95},"meta":{"timestamp":"2026-06-04T01:59:16.541Z","request_id":"1d8b9bc7-9ebf-4fcf-aac7-9d1d19755c6c"},"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":11735,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1325,"monthly_call_quota":21350,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3315,"monthly_call_quota":263500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7115,"monthly_call_quota":1360000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/antenna-api"}