{"openapi":"3.1.0","info":{"title":"Stellar Parallax API","version":"1.0.0","description":"Stellar-parallax and astrometry maths as an API, computed locally and deterministically. The distance endpoint turns a measured trigonometric parallax angle into a distance using d(pc) = 1/p(arcsec), accepting the parallax in arcseconds or milliarcseconds and returning the distance in parsecs, light-years and astronomical units — a parallax of one arcsecond is one parsec (≈3.2616 light-years) by definition, and Proxima Centauri’s 0.7687-arcsecond parallax gives about 1.30 pc, or 4.24 light-years. The parallax endpoint inverts it, p(arcsec) = 1/d(pc), giving the tiny annual back-and-forth angle a star traces against the background as Earth orbits the Sun. The proper-motion endpoint computes a star’s tangential (transverse) velocity across the sky from its proper motion and distance, v_t = 4.74047·μ(arcsec/yr)·d(pc) km/s — Barnard’s Star, with a proper motion of about 10.39 arcsec/yr at 1.83 pc, races across the sky at roughly 90 km/s. Everything is computed locally and deterministically, so it is instant and private. Ideal for astronomy, astrophysics, planetarium, education and science-communication app developers, star-distance and stellar-kinematics tools, and Gaia-catalogue post-processing. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is geometric distance and kinematics; for a star’s apparent and absolute brightness use a star-magnitude API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/parallax-api","description":"oanor gateway"}],"tags":[{"name":"Parallax"},{"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/distance":{"get":{"operationId":"get_v1_distance","tags":["Parallax"],"summary":"Distance from parallax","description":"","parameters":[{"name":"parallax","in":"query","required":false,"description":"Parallax (arcsec)","schema":{"type":"string"},"example":"0.7687"},{"name":"parallax_mas","in":"query","required":false,"description":"Parallax (milliarcsec)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"d(pc) = 1/p(arcsec). A parallax of 1 arcsec is 1 parsec ≈ 3.2616 light-years. Proxima Centauri's 0.7687 arcsec gives ≈1.30 pc (4.24 ly).","inputs":{"parallax_arcsec":0.7687},"distance_au":268329.3951,"distance_parsec":1.30089762,"distance_light_years":4.24296055},"meta":{"timestamp":"2026-06-05T19:50:26.354Z","request_id":"3455a0aa-1050-4e49-af56-1271597308e8"},"status":"ok","message":"Distance from parallax","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/parallax":{"get":{"operationId":"get_v1_parallax","tags":["Parallax"],"summary":"Parallax from distance","description":"","parameters":[{"name":"distance_parsec","in":"query","required":false,"description":"Distance (pc)","schema":{"type":"string"},"example":"1.3"},{"name":"distance_light_years","in":"query","required":false,"description":"Distance (ly)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"p(arcsec) = 1/d(pc). Nearer stars have larger parallax; Gaia measures down to microarcseconds.","inputs":{"distance_parsec":1.3},"parallax_mas":769.230769,"parallax_arcsec":0.7692307692},"meta":{"timestamp":"2026-06-05T19:50:26.466Z","request_id":"1f449533-0162-42c2-91e3-bb550de73832"},"status":"ok","message":"Parallax from 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/proper-motion":{"get":{"operationId":"get_v1_proper_motion","tags":["Parallax"],"summary":"Tangential velocity","description":"","parameters":[{"name":"proper_motion","in":"query","required":true,"description":"Proper motion (arcsec/yr)","schema":{"type":"string"},"example":"10.39"},{"name":"distance_parsec","in":"query","required":false,"description":"Distance (pc)","schema":{"type":"string"},"example":"1.83"},{"name":"parallax","in":"query","required":false,"description":"Or parallax (arcsec)","schema":{"type":"string"}},{"name":"parallax_mas","in":"query","required":false,"description":"Or parallax (mas)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"v_t = 4.74047·μ(arcsec/yr)·d(pc) km/s. Barnard's Star (μ≈10.39 arcsec/yr, d≈1.83 pc) has v_t ≈ 90 km/s.","inputs":{"distance_parsec":1.83,"proper_motion_arcsec_yr":10.39},"tangential_velocity_kms":90.133883},"meta":{"timestamp":"2026-06-05T19:50:26.577Z","request_id":"4f2f5786-4d5f-4fcb-b5aa-d9e584ac39d4"},"status":"ok","message":"Tangential velocity","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":"Parallax in arcsec (or mas), distance in parsec/light-year/AU, proper motion in arcsec/yr. This is geometric distance; for apparent/absolute brightness use a star-magnitude API.","service":"parallax-api","constants":{"kms_constant":4.740470446,"au_per_parsec":206264.806,"light_years_per_parsec":3.2615637769},"endpoints":{"GET /v1/meta":"This document.","GET /v1/distance":"Distance (pc, ly, AU) from a parallax angle.","GET /v1/parallax":"Parallax angle from a distance.","GET /v1/proper-motion":"Tangential velocity from proper motion and distance."},"description":"Stellar parallax and astrometry: distance from parallax, parallax from distance, and tangential velocity from proper motion."},"meta":{"timestamp":"2026-06-05T19:50:26.690Z","request_id":"286b9f1f-0b29-4c0b-9659-27b4b5c745e3"},"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":4900,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":420,"monthly_call_quota":49000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1150,"monthly_call_quota":225000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3600,"monthly_call_quota":1320000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/parallax-api"}