The Upstellar Celestial Engine provides programmatic access to all of our astrology calculators. You can access the exact same data used to render our interactive charts, returned as clean JSON.

The API is currently public and requires no API key. However, strict rate limits apply:

20 requests per minute per IP address.

If you exceed this limit, the API will return a 429 Too Many Requests HTTP status.

Every response wraps the data with a status, the original query, and a meta block containing the execution time.

{
  "status": "success",
  "query": { "lat": "51.5", "lon": "-0.1", ... },
  "data": { ... endpoint specific payload ... },
  "meta": {
    "execution_ms": 12.45
  }
}

Below is the complete list of available API endpoints, their base URLs, and the parameters they accept. Click on any endpoint to expand its documentation.

City Search (Utility)

GET https://upstellar.net/api/cities

Returns a list of matching cities with their coordinates and timezone.

Parameter	Type	Description
`q`	string	The city name to search for (e.g. "london").

Example Request:

curl -s "https://upstellar.net/api/cities?q=london"

Birth Natal Chart

GET https://upstellar.net/api/birth-chart

Full natal wheel, planet positions, houses & aspects.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/birth-chart?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Ascendant / Rising Sign

GET https://upstellar.net/api/ascendant

Rising sign, Midheaven and house angles.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/ascendant?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Astro Portrait

GET https://upstellar.net/api/astro-portrait

Sun, Moon & Ascendant snapshot with meaning.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/astro-portrait?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Personal Daily Horoscope

GET https://upstellar.net/api/daily-horoscope

Today's transits to your natal chart.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).
`*date`	string	Target date for transits/progressions/returns (YYYY-MM-DD). The exact parameter name depends on the tool (e.g. `tdate`, `ddate`, `pdate`).

Example Request:

curl -s "https://upstellar.net/api/daily-horoscope?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Transit Chart

GET https://upstellar.net/api/transit-chart

Current planets over your natal chart.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).
`*date`	string	Target date for transits/progressions/returns (YYYY-MM-DD). The exact parameter name depends on the tool (e.g. `tdate`, `ddate`, `pdate`).

Example Request:

curl -s "https://upstellar.net/api/transit-chart?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Transit Forecast

GET https://upstellar.net/api/transit-forecast

Dated timeline of upcoming transits to your chart.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/transit-forecast?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Annual Profections

GET https://upstellar.net/api/annual-profections

Your time-lord year, activated house & Lord of the Year.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/annual-profections?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Saturn Return

GET https://upstellar.net/api/saturn-return

Exact dates of your Saturn returns and what each asks.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/saturn-return?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Synastry

GET https://upstellar.net/api/synastry

Two charts overlaid with inter-aspects.

Parameter	Type	Description
`a_` / `b_`	-	Prefix standard birth parameters with `a_` and `b_` for both people (e.g., `a_date`, `a_lat`, `b_tz`).

Example Request:

curl -s "https://upstellar.net/api/synastry?a_date=2000-01-01&a_time=12:00&a_lat=51.5&a_lon=-0.1&a_tz=Europe/London&b_date=2001-02-02&b_time=14:00&b_lat=40.7&b_lon=-74.0&b_tz=America/New_York"

Secondary Progressions

GET https://upstellar.net/api/progressions

Day-for-a-year progressed chart.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).
`*date`	string	Target date for transits/progressions/returns (YYYY-MM-DD). The exact parameter name depends on the tool (e.g. `tdate`, `ddate`, `pdate`).

Example Request:

curl -s "https://upstellar.net/api/progressions?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Solar Arc & Returns

GET https://upstellar.net/api/solar-return

Solar arc directions, solar & lunar returns.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).
`*date`	string	Target date for transits/progressions/returns (YYYY-MM-DD). The exact parameter name depends on the tool (e.g. `tdate`, `ddate`, `pdate`).

Example Request:

curl -s "https://upstellar.net/api/solar-return?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Composite & Davison

GET https://upstellar.net/api/composite

Relationship midpoint & time/space charts.

Parameter	Type	Description
`a_` / `b_`	-	Prefix standard birth parameters with `a_` and `b_` for both people (e.g., `a_date`, `a_lat`, `b_tz`).

Example Request:

curl -s "https://upstellar.net/api/composite?a_date=2000-01-01&a_time=12:00&a_lat=51.5&a_lon=-0.1&a_tz=Europe/London&b_date=2001-02-02&b_time=14:00&b_lat=40.7&b_lon=-74.0&b_tz=America/New_York"

Traditional Astrology

GET https://upstellar.net/api/traditional

Hellenistic / classical techniques.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/traditional?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Sidereal / Vedic

GET https://upstellar.net/api/sidereal

Sidereal zodiac & Janam Kundali.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/sidereal?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Nakshatra Birth Star

GET https://upstellar.net/api/nakshatra

Your Moon's lunar mansion, pada, ruler & deity.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/nakshatra?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Vimshottari Dasha

GET https://upstellar.net/api/dasha

Your Vedic planetary-period life timeline.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/dasha?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Dominant Planet

GET https://upstellar.net/api/dominant-planet

The planet, element & modality that rule your chart.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/dominant-planet?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Natal Moon Phase

GET https://upstellar.net/api/moon-phase-birth

Your lunation type & soul pattern (8 phases).

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/moon-phase-birth?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Decans

GET https://upstellar.net/api/decan

Your Sun, Moon & Rising decans and sub-rulers.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/decan?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Asteroids

GET https://upstellar.net/api/asteroids

Ceres, Pallas, Juno, Vesta, Chiron & more.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/asteroids?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Draconic Chart

GET https://upstellar.net/api/draconic

Chart relative to the lunar nodes.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/draconic?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Astro Calendar

GET https://upstellar.net/api/astro-calendar

Monthly & annual aspect calendar.

Parameter	Type	Description
`year`	int	Target year (1800-2100).
`month`	int	Target month (1-12) (optional for eclipses/retrograde).
`mode`	string	`month` (default) or `year` — controls output density.

Example Request:

curl -s "https://upstellar.net/api/astro-calendar?year=2026&month=6"

Ephemeris Tables

GET https://upstellar.net/api/ephemeris

Planetary positions 1800-2100.

Parameter	Type	Description
`year`	int	Target year (1800-2100).
`month`	int	Target month (1-12) (optional for eclipses/retrograde).

Example Request:

curl -s "https://upstellar.net/api/ephemeris?year=2026&month=6"

Retrograde Planets

GET https://upstellar.net/api/retrograde

Retrograde periods & shadow zones.

Parameter	Type	Description
`year`	int	Target year (1800-2100).
`month`	int	Target month (1-12) (optional for eclipses/retrograde).

Example Request:

curl -s "https://upstellar.net/api/retrograde?year=2026&month=6"

Aspect Search Engine

GET https://upstellar.net/api/aspects-search

Find dates matching aspect criteria.

Parameter	Type	Description
`a`, `b`	string	Planets to find aspects between (e.g. sun, jupiter).
`asp`	int/string	Aspect angle (0, 60, 90, 120, 180) or 'all'.
`from`, `to`	string	Date range (YYYY-MM-DD).

Example Request:

curl -s "https://upstellar.net/api/aspects-search?a=mars&b=saturn&asp=90&from=2026-01-01&to=2026-12-31"

Multi-Aspect Finder

GET https://upstellar.net/api/aspect-finder

Stack several aspects, find every date they line up.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/aspect-finder?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

AstroCartography

GET https://upstellar.net/api/astrocartography

Relocation lines on a world map.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/astrocartography?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Electional Astrology

GET https://upstellar.net/api/electional

Find favorable chart timing.

Parameter	Type	Description
`from`	string	Start of search window (YYYY-MM-DD). Default: today.
`to`	string	End of search window (YYYY-MM-DD). Default: +30 days.

Example Request:

curl -s "https://upstellar.net/api/electional?from=2026-07-01&to=2026-07-31"

Planetary Hours

GET https://upstellar.net/api/planetary-hours

Chaldean day & night hour rulers for any place.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/planetary-hours?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Moon Calendar

GET https://upstellar.net/api/moon-calendar

Daily Moon sign & phase.

Parameter	Type	Description
`year`	int	Target year (1800-2100).
`month`	int	Target month (1-12) (optional for eclipses/retrograde).

Example Request:

curl -s "https://upstellar.net/api/moon-calendar?year=2026&month=6"

Full Moons & New Moons

GET https://upstellar.net/api/full-moon

Lunation dates & next full Moon.

Parameter	Type	Description
`year`	int	Target year (1800-2100).
`month`	int	Target month (1-12) (optional for eclipses/retrograde).

Example Request:

curl -s "https://upstellar.net/api/full-moon?year=2026&month=6"

Eclipses

GET https://upstellar.net/api/eclipses

Solar & lunar eclipse calendar.

Parameter	Type	Description
`year`	int	Target year (1800-2100).
`month`	int	Target month (1-12) (optional for eclipses/retrograde).

Example Request:

curl -s "https://upstellar.net/api/eclipses?year=2026&month=6"

Void of Course Moon

GET https://upstellar.net/api/void-of-course

VoC Moon periods.

Parameter	Type	Description
`year`	int	Target year (1800-2100).
`month`	int	Target month (1-12) (optional for eclipses/retrograde).

Example Request:

curl -s "https://upstellar.net/api/void-of-course?year=2026&month=6"

Arabic Parts & Lots

GET https://upstellar.net/api/arabic-parts

Hermetic Lots: Fortune, Spirit, Love, Marriage & more.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/arabic-parts?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Fixed Stars

GET https://upstellar.net/api/fixed-stars

Conjunctions to Algol, Spica, Regulus, Antares & more.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/fixed-stars?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Sabian Symbols

GET https://upstellar.net/api/sabian

360 symbolic degree images for your natal planets.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/sabian?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Numerology

GET https://upstellar.net/api/numerology

Life Path, Expression, Soul Urge & Personality number.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/numerology?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Chinese Zodiac

GET https://upstellar.net/api/chinese-zodiac

Your lunar animal, element & yin/yang with compatibility.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/chinese-zodiac?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Mayan Tzolkin Sign

GET https://upstellar.net/api/mayan-tzolkin

Your sacred Maya day-sign & galactic tone.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/mayan-tzolkin?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Celtic Tree Astrology

GET https://upstellar.net/api/celtic-tree

Your Druid birth tree and its meaning.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/celtic-tree?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Native American Totem

GET https://upstellar.net/api/native-american-zodiac

Your Medicine Wheel birth totem & clan.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/native-american-zodiac?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Birthstone & Crystals

GET https://upstellar.net/api/birthstone

Your zodiac gemstone, crystals & lucky metal.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/birthstone?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Angel Numbers

GET https://upstellar.net/api/angel-numbers

Decode the repeating numbers you keep seeing.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/angel-numbers?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Biorhythm

GET https://upstellar.net/api/biorhythm

Physical, emotional & intellectual cycles for any day.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/biorhythm?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Love Compatibility

GET https://upstellar.net/api/love-match

Horoscope matching score.

Parameter	Type	Description
`a_` / `b_`	-	Prefix standard birth parameters with `a_` and `b_` for both people (e.g., `a_date`, `a_lat`, `b_tz`).

Example Request:

curl -s "https://upstellar.net/api/love-match?a_date=2000-01-01&a_time=12:00&a_lat=51.5&a_lon=-0.1&a_tz=Europe/London&b_date=2001-02-02&b_time=14:00&b_lat=40.7&b_lon=-74.0&b_tz=America/New_York"

Sun Sign Compatibility

GET https://upstellar.net/api/sun-sign-compatibility

Quick two-sign love match — no birth time needed.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/sun-sign-compatibility?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

Reverse Synastry

GET https://upstellar.net/api/reverse-synastry

Find the birth dates of people who fit your chart.

Parameter	Type	Description
`date`	string	Birth date (YYYY-MM-DD).
`time`	string	Birth time (HH:MM). Default: 12:00
`lat`	float	Latitude (-90 to 90).
`lon`	float	Longitude (-180 to 180).
`tz`	string	Timezone (e.g. Europe/London).
`house`	string	House system (default: placidus).

Example Request:

curl -s "https://upstellar.net/api/reverse-synastry?date=2000-01-01&time=12:00&lat=51.5&lon=-0.1&tz=Europe/London"

How to use the API Documentation

Documentation for using Upstellar's astrology calculations in your own apps, returning clean JSON for charts, transits, synastry and more.

Getting started

Browse the endpoints and parameters.
Call an endpoint with birth data and read the JSON response, including interpretation text.

Reading your result

Every calculator has a matching API endpoint. Responses include both raw positions and human-readable interpretation where available.

Astrologer's tip The hidden /all aggregator returns every personal calculation in one request.

API Documentation

Authentication & Limits

Example Response Format

Available Endpoints

How to use the API Documentation

Getting started

Reading your result