API reference · v1

Western Astrology

Tropical-zodiac Western astrology: complete natal charts with houses and aspects plus deterministic interpretations, two-chart synastry compatibility scoring, and daily horoscopes for every sign.

3 endpoints · 1 credit per call

Endpoints

Every western astrology endpoint

Parameters, copy-paste examples in three languages, and response shapes.

POST/api/v1/western/chart

Natal chart

Full Western natal chart — tropical planet positions, houses, aspects — with a deterministic written interpretation of Sun, Moon and rising.

1 credit per call

Parameters

Name	Type	In	Required	Description
date	string	body	required	Birth date, YYYY-MM-DD
time	string	body	optional	Birth time, HH:MM (24h)
time_unknown	boolean	body	optional	Set true when birth time is unknown
latitude	number	body	required	Birth latitude, −90 to 90
longitude	number	body	required	Birth longitude, −180 to 180
timezone	string	body	optional	IANA timezone (default UTC)
house_system	string	body	optional	House system (default Placidus)

Example request

cURL

curl -X POST "https://api-rho-eight-42.vercel.app/api/v1/western/chart" \
  -H "X-API-Key: kundli_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30",
  "latitude": 9.9312,
  "longitude": 76.2673,
  "timezone": "Asia/Kolkata",
  "house_system": "Placidus"
}'

Example response

JSON

{
  "chart": {
    "sun": {
      "sign": "Taurus",
      "degree": 24.5,
      "house": 2
    },
    "moon": {
      "sign": "Cancer",
      "degree": 3.1,
      "house": 4
    },
    "ascendant": {
      "sign": "Virgo",
      "degree": 17.8
    },
    "aspects": [
      {
        "planets": [
          "Sun",
          "Moon"
        ],
        "aspect": "trine",
        "orb": 2.3
      }
    ]
  },
  "interpretation": {
    "sun_line": "With the Sun in Taurus, your core identity is steady, sensual and built to last.",
    "moon_line": "A Cancer Moon gives you deep emotional tides and a fierce need for home."
  }
}

Try it — paste your own key from Developers → API Keys in place of kundli_abc123... and run the snippet against https://api-rho-eight-42.vercel.app.

POST/api/v1/western/synastry

Synastry

Compatibility analysis between two Western birth charts: composite score, inter-chart aspects, highlights and house overlays in both directions.

1 credit per call

Parameters

Name	Type	In	Required	Description
person_a	object	body	required	First person's birth details (same shape as the natal chart endpoint)
person_b	object	body	required	Second person's birth details (same shape as the natal chart endpoint)
language	string	body	optional	Two-letter language code (default en)

Example request

cURL

curl -X POST "https://api-rho-eight-42.vercel.app/api/v1/western/synastry" \
  -H "X-API-Key: kundli_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
  "person_a": {
    "date": "1990-05-15",
    "time": "14:30",
    "latitude": 9.9312,
    "longitude": 76.2673,
    "timezone": "Asia/Kolkata",
    "house_system": "Placidus"
  },
  "person_b": {
    "date": "1992-11-03",
    "time": "09:15",
    "latitude": 9.9312,
    "longitude": 76.2673,
    "timezone": "Asia/Kolkata",
    "house_system": "Placidus"
  },
  "language": "en"
}'

Example response

JSON

{
  "score": 82.5,
  "summary": "A strong, growth-oriented bond with natural emotional attunement.",
  "inter_aspects": [
    {
      "planets": [
        "Venus",
        "Mars"
      ],
      "aspect": "conjunction",
      "orb": 1.8
    }
  ],
  "highlights": [
    "Venus–Mars conjunction fuels magnetic attraction"
  ],
  "overlays_a_in_b": [
    {
      "planet": "Sun",
      "house": 7
    }
  ],
  "overlays_b_in_a": [
    {
      "planet": "Moon",
      "house": 5
    }
  ]
}

Try it — paste your own key from Developers → API Keys in place of kundli_abc123... and run the snippet against https://api-rho-eight-42.vercel.app.

GET/api/v1/western/horoscope/{sign}?date=2026-10-15

Daily horoscope

Daily horoscope for a tropical zodiac sign (case-insensitive). Defaults to today when no date is passed.

1 credit per call

Parameters

Name	Type	In	Required	Description
sign	string	path	required	Zodiac sign, e.g. taurus — aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces
date	string	query	optional	Date, YYYY-MM-DD (default today)

Example request

cURL

curl "https://api-rho-eight-42.vercel.app/api/v1/western/horoscope/{sign}?date=2026-10-15" \
  -H "X-API-Key: kundli_abc123..."

Example response

JSON

{
  "sign": "Taurus",
  "date": "2026-10-15",
  "headline": "Steady wins the day",
  "love": "An honest conversation deepens a bond.",
  "career": "Finish the detail work you've been avoiding.",
  "wellness": "Protect your sleep like a ritual.",
  "lucky_number": 6,
  "lucky_color": "emerald"
}

Try it — paste your own key from Developers → API Keys in place of kundli_abc123... and run the snippet against https://api-rho-eight-42.vercel.app.

Need a key?

Create one from your dashboard and paste it into any example above — every snippet is ready to run.

Get an API key