Personal Horoscope API (Moon Sign)

A horoscope from the person's own Moon sign

POST/v1/horoscope/personal

2 credits · Secret key (test or live) · getPersonalHoroscope

Request body

birth Birth required
- date string (date) required
  e.g. "1990-08-13"
- time string
  pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"
- time_accuracy string
  With "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
  one of exact, approximate, unknown · default "exact"
- place Coordinates or object or object required
  Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
  
  One of:
  1. Coordinates
    Fields
    - latitude number required
      ≥ -90 · ≤ 90
    - longitude number required
      ≥ -180 · ≤ 180
    No other fields are accepted.
  2. object
    Fields
    - place_id string required
    No other fields are accepted.
  3. object
    Fields
    - query string required
      at least 2 characters · at most 120 characters
    No other fields are accepted.
- timezone string
  "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
  default "auto"
No other fields are accepted.
period string required
one of daily, weekly, monthly, yearly
date string (date)
e.g. "1990-08-13"
lang string
one of en, hi · default "en"
options Options
- ayanamsa string
  Each system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
  one of lahiri, raman, krishnamurti, yukteshwar, fagan_bradley · default "lahiri"
- house_system string
  one of whole_sign · default "whole_sign"
- node string
  The Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.
  one of true, mean · default "true"
- lang string
  one of en, hi · default "en"
- view string
  compact drops labels and prose — for LLM callers.
  one of full, compact · default "full"
- tone string
  descriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.
  one of default, descriptive · default "default"
- dasha_year number
  Days in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.
  one of 365.25, 365.2422, 360 · default 365.25
No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

moon_sign string required
sign string required
sign_label string required
period string required
one of daily, weekly, monthly, yearly
date string (date) required
e.g. "1990-08-13"
reading string required
scores object required
- love integer required
  ≥ 0 · ≤ 100
- career integer required
  ≥ 0 · ≤ 100
- health integer required
  ≥ 0 · ≤ 100
- money integer required
  ≥ 0 · ≤ 100
score_notes object required
- love string required
- career string required
- health string required
- money string required
ruler string required
element string required
lucky object required
- color string required
- number string required
- day string required
- gem string required
- time string required
- mood string required
transits array of object required
- planet string required
- sign string required
- house integer required
  ≥ 1 · ≤ 12
- tone string required
- retrograde boolean required
hindi object
With lang=hi only: the engine's whole Hindi reading (name, reading, the four areas, the lucky colour, number and day).
- name string required
- reading string required
- areas object required
  Fields
  - career string required
  - love string required
  - health string required
  - money string required
- lucky object required
  Fields
  - color string required
  - number string required
  - day string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/horoscope/personal' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"period":"weekly","date":"2026-10-02"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/horoscope/personal", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "period": "weekly",
    "date": "2026-10-02"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "birth": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
    "period": "weekly",
    "date": "2026-10-02",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/horoscope/personal",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/horoscope/personal');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"period":"weekly","date":"2026-10-02"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 2,031 characters

{
  "data": {
    "moon_sign": "aries",
    "sign": "aries",
    "sign_label": "Aries",
    "period": "weekly",
    "date": "2026-10-02",
    "reading": "This week, the Sun lights up your 6th house, drawing your focus to health, daily routine and rivals. Rahu's transit through your 11th house favours income, gains and friendships, and it is strongly placed - a good window to push ahead there. Venus in your 7th house asks for patience around partnerships and close relationships; avoid rushing decisions there. Ruled by Mars, your energetic nature serves you well this week - steady effort beats haste.",
    "scores": {
      "love": 34,
      "career": 47,
      "health": 50,
      "money": 40
    },
    "score_notes": {
      "love": "Take care",
      "career": "Steady",
      "health": "Steady",
      "money": "Mixed"
    },
    "ruler": "mars",
    "element": "fire",
    "lucky": {
      "color": "Red",
      "number": "9",
      "day": "Tuesday",
      "gem": "Red Coral",
      "time": "6-8 AM",
      "mood": "Cautious"
    },
    "transits": [
      {
        "planet": "venus",
        "sign": "libra",
        "house": 7,
        "tone": "challenging",
        "retrograde": false
      },
      {
        "planet": "sun",
        "sign": "virgo",
        "house": 6,
        "tone": "benefic",
        "retrograde": false
      },
      {
        "planet": "mercury",
        "sign": "libra",
        "house": 7,
        "tone": "challenging",
        "retrograde": false
      },
      {
        "planet": "jupiter",
        "sign": "cancer",
        "house": 4,
        "tone": "challenging",
        "retrograde": false
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2,
    "ayanamsa": "lahiri",
    "house_system": "whole_sign",
    "node": "true",
    "timezone_used": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30",
      "source": "auto"
    }
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "birth": {
    "date": "1990-08-13",
    "time": "06:30",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    }
  },
  "period": "weekly",
  "date": "2026-10-02"
}

Personal Horoscope API (Moon Sign)

Request body

Response

Example request

Example response

More in Horoscopes