Fixed Stars API
Beyond the moving planets, the older layer of astrology reads the fixed stars — Regulus, Spica, Algol, Aldebaran and their peers. This endpoint scans a natal chart for tight conjunctions to those major stars and returns each contact with its orb, so you can fold a star's reputed character into a reading.
Fixed Stars API
From the supplied birth date, time, UTC offset, and coordinates, the endpoint computes the natal points and then walks the catalogue of major fixed stars drawn from the Vivian Robson and Ptolemy tradition — the bright, astrologically weighted stars rather than the whole sky. For every star it tests the natal points for a conjunction, and where one falls inside orb it records the contact along with the exact orb of separation. The output under data.stars is a list of star-to-point hits: which star, which natal point it touches, and how close the alignment is, so a half-degree conjunction reads as more potent than one at the edge of orb. Only conjunctions are considered — the technique treats a star as significant when a chart point sits on it, not when it forms the longitudinal angles planets make with each other. This surfaces the named stars that classical sources singled out as fortunate or dangerous, ready to be matched to your own star-meaning copy.
POST/v1/fixed-stars
curl -X POST https://api.astroway.info/v1/fixed-stars \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}'{
"ok": true,
"data": {
"stars": [
{
"star": "Regulus",
"point": "Mercury",
"orb": 0.4
},
{
"star": "Algol",
"point": "Mars",
"orb": 1.1
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Use this endpoint when a chart reading wants the extra texture of named stars — a traditional or fixed-star-aware interpreter, a report generator that flags a striking Algol or royal-star Regulus contact, or an educational tool that teaches the lore behind the brightest stars. The tight-orb, conjunction-only design keeps the output focused: you get the handful of contacts worth mentioning rather than noise, which makes it easy to render as a short highlighted list. Feed it the same birth data you sent to the natal-chart endpoint and the star hits will line up with the planetary and angle positions already in your chart, letting you annotate a planet or angle with its co-located star. Because the catalogue is curated to the traditionally significant stars, you can attach prepared interpretive text to each one without curating the list yourself.
Notes
The star catalogue follows the selection handed down through Vivian Robson and Ptolemy — the major astrologically significant fixed stars, not an exhaustive sky survey. Natal positions and star longitudes are computed by the Swiss Ephemeris (Astrodienst) WASM engine in the tropical zodiac, and only conjunctions within orb are returned.
Try the Fixed Stars API
Grab a key and make your first call in under a minute.