Endpoint

Fixed stars

43 precession-corrected catalog stars. Conjunctions need planet longitudes, not a natal chart.

POST /api/v1/fixed-stars

POST /api/v1/fixed-stars/conjunctions

POST /api/v1/fixed-stars/:name

Parameters

Field	Required	Notes
year, month, day	yes	All three routes
planets[].name, planets[].longitude	conjunctions	Missing planets is 400
orb	no	Conjunction orb in degrees

Index ignores magnitude_limit. It always returns the full catalog as fixed_stars plus total_count.
Named show requires year/month/day and returns {date, star} where star is position merged with info.
Conjunction items are {star, planet, star_longitude, planet_longitude, orb} plus orb_used and total_count.
Register /conjunctions before /:name so the path is not treated as a star named conjunctions.

{
  "day": 15,
  "month": 5,
  "orb": 1.0,
  "planets": [
    {
      "longitude": 54.32,
      "name": "sun"
    }
  ],
  "year": 1990
}