Morphemeris DocsStars
GET /v1/stars — Look up fixed star positions from the Swiss Ephemeris catalog.
Stars
Look up ecliptic positions of fixed stars from the Swiss Ephemeris sefstars.txt catalog.
GET /v1/stars
POST /v1/starsCredit cost: 1 (single star), 5 (all stars)
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
datetime | string | One of datetime or jd | — | ISO 8601 UTC datetime |
jd | number | One of datetime or jd | — | Julian Day in UT1 |
star | string | Yes | — | Star name (e.g., "Aldebaran", "alTau") or "all" |
Response
Single star
{
"data": {
"name": "Aldebaran",
"bayer": "alTau",
"longitude": 69.9471,
"latitude": -5.4674,
"distance": 20.43,
"magnitude": 0.85,
"spectral": "K5III"
},
"meta": { "..." }
}All stars (star=all)
{
"data": [
{ "name": "Aldebaran", "bayer": "alTau", "..." },
{ "name": "Regulus", "bayer": "alLeo", "..." }
],
"meta": { "credits_used": 5, "..." }
}| Field | Type | Description |
|---|---|---|
name | string | Common name |
bayer | string | Bayer designation (e.g., "alTau") |
longitude | number | Ecliptic longitude in degrees |
latitude | number | Ecliptic latitude in degrees |
distance | number | Distance in AU (if known) |
magnitude | number | Visual magnitude |
spectral | string | Spectral classification |
Examples
curl "https://api.morphemeris.com/v1/stars?datetime=2024-03-20T12:00:00Z&star=Aldebaran" \
-H "Authorization: Bearer morphemeris_live_YOUR_KEY"const res = await fetch(
"https://api.morphemeris.com/v1/stars?datetime=2024-03-20T12:00:00Z&star=Aldebaran",
{ headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const data = await res.json();import requests
res = requests.get(
"https://api.morphemeris.com/v1/stars",
params={"datetime": "2024-03-20T12:00:00Z", "star": "Aldebaran"},
headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()Stars can be looked up by common name ("Aldebaran") or Bayer designation ("alTau"). Names are case-insensitive.