{"openapi":"3.1.0","info":{"title":"Angular Size API","version":"1.0.0","description":"Angular-size astronomy and optics maths as an API, computed locally and deterministically. The angular-size endpoint computes the angular diameter an object subtends, δ = 2·arctan(d/(2D)), from its physical size and its distance, returning the angle in radians, degrees, arcminutes and arcseconds, along with the small-angle approximation δ ≈ d/D — the Sun and Moon are each about half a degree (31 arcminutes) across. The distance endpoint inverts the relation, D = d/(2·tan(δ/2)), to give an object's distance from its known true size and its measured angular size, the basis of the standard-ruler distance method. The object-size endpoint computes an object's physical diameter, d = 2·D·tan(δ/2), from its distance and angular size. Size and distance use any one consistent unit, and angles may be given in radians, degrees, arcminutes or arcseconds. Everything is computed locally and deterministically, so it is instant and private. Ideal for astronomy, telescope, astrophotography, surveying and optics app developers, field-of-view and rangefinding tools, and physics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is angular size; for stellar magnitude and parallax distance use a star-magnitude API and for sidereal time a sidereal API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/angularsize-api","description":"oanor gateway"}],"tags":[{"name":"AngularSize"},{"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/angular-size":{"get":{"operationId":"get_v1_angular_size","tags":["AngularSize"],"summary":"Angular diameter","description":"","parameters":[{"name":"size","in":"query","required":true,"description":"Object diameter","schema":{"type":"string"},"example":"3474"},{"name":"distance","in":"query","required":true,"description":"Distance (same units)","schema":{"type":"string"},"example":"384400"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Angular diameter δ = 2·arctan(d/(2D)). For distant objects the small-angle approximation δ ≈ d/D (radians) is accurate to well under 1 %.","inputs":{"size":3474,"distance":384400},"angular_size":{"degrees":0.51780485,"radians":0.009037399467,"arcminutes":31.068291,"arcseconds":1864.0975},"small_angle_approx_radians":0.009037460978},"meta":{"timestamp":"2026-06-05T11:30:24.318Z","request_id":"b3eee7ea-a3f2-4ab6-9356-51e026e1fa58"},"status":"ok","message":"Angular size","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/distance":{"get":{"operationId":"get_v1_distance","tags":["AngularSize"],"summary":"Distance","description":"","parameters":[{"name":"size","in":"query","required":true,"description":"Object diameter","schema":{"type":"string"},"example":"3474"},{"name":"arcminutes","in":"query","required":false,"description":"Angular size (arcmin)","schema":{"type":"string"},"example":"31.07"},{"name":"degrees","in":"query","required":false,"description":"Or degrees","schema":{"type":"string"}},{"name":"arcseconds","in":"query","required":false,"description":"Or arcsec","schema":{"type":"string"}},{"name":"radians","in":"query","required":false,"description":"Or radians","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Distance D = d / (2·tan(δ/2)). Knowing an object's true size and how big it looks gives its distance — the basis of the 'standard ruler' method.","inputs":{"size":3474,"angular_size_radians":0.009037896643},"distance":384378.85380881},"meta":{"timestamp":"2026-06-05T11:30:24.426Z","request_id":"72ab91a6-5061-407f-991b-21a645d00097"},"status":"ok","message":"Distance","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/object-size":{"get":{"operationId":"get_v1_object_size","tags":["AngularSize"],"summary":"Object size","description":"","parameters":[{"name":"distance","in":"query","required":true,"description":"Distance","schema":{"type":"string"},"example":"384400"},{"name":"arcminutes","in":"query","required":false,"description":"Angular size (arcmin)","schema":{"type":"string"},"example":"31.07"},{"name":"degrees","in":"query","required":false,"description":"Or degrees","schema":{"type":"string"}},{"name":"arcseconds","in":"query","required":false,"description":"Or arcsec","schema":{"type":"string"}},{"name":"radians","in":"query","required":false,"description":"Or radians","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Physical size d = 2·D·tan(δ/2). The diameter is in the same units as the distance.","size":3474.19111839,"inputs":{"distance":384400,"angular_size_radians":0.009037896643}},"meta":{"timestamp":"2026-06-05T11:30:24.515Z","request_id":"8dff9ca6-99f6-46e9-ae0b-ee27857828f4"},"status":"ok","message":"Object size","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":{"notes":"Size and distance use any one consistent unit. Angles accept radians, degrees, arcminutes or arcseconds. The Sun and Moon are each about 0.5° (≈ 31 arcmin) across.","service":"angularsize-api","formulae":{"distance":"D = d/(2·tan(δ/2))","object_size":"d = 2·D·tan(δ/2)","angular_size":"δ = 2·arctan(d/(2D))"},"endpoints":{"GET /v1/meta":"This document.","GET /v1/distance":"Distance from object size and angular size.","GET /v1/object-size":"Physical size from distance and angular size.","GET /v1/angular-size":"Angular diameter (radians/degrees/arcmin/arcsec) from object size and distance."},"description":"Angular-size calculator: angular diameter of an object from its size and distance, and solving the distance or the physical size from an angular measurement."},"meta":{"timestamp":"2026-06-05T11:30:24.610Z","request_id":"a91447c0-e462-45f0-b30e-52b5a4e4d68d"},"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":3400,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":42500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1500,"monthly_call_quota":234000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5000,"monthly_call_quota":1360000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/angularsize-api"}