Horoscopes

Transit-based horoscopes per sign and period, in English and Hindi.

Horoscope for one sign

GET/v1/horoscope/{sign}

1 credit · Secret or publishable key · getHoroscope

Parameters

Name	In	Type	Notes
`sign` required	path	string	one of `aries`, `taurus`, `gemini`, `cancer`, `leo`, `virgo`, `libra`, `scorpio`, `sagittarius`, `capricorn`, `aquarius`, `pisces`
`period`	query	string	one of `daily`, `weekly`, `monthly`, `yearly` · default `"daily"`
`lang`	query	string	one of `en`, `hi` · default `"en"`
`date`	query	string (date)

Response

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

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

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

Example request

curl 'https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'

Node.js

const res = await fetch("https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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/leo?period=weekly&date=2026-10-02&lang=hi');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 1,535 characters

{
  "data": {
    "sign": "leo",
    "sign_label": "सिंह",
    "period": "weekly",
    "date": "2026-10-02",
    "reading": "कार्यक्षेत्र में मिश्रित स्थिति - सोच-समझकर निर्णय लें। प्रेम जीवन अनुकूल रहेगा, साथी से तालमेल अच्छा रहेगा। स्वास्थ्य में उतार-चढ़ाव - खानपान का ध्यान रखें। आर्थिक स्थिति स्थिर रहेगी।",
    "scores": {
      "love": 58,
      "career": 39,
      "health": 43,
      "money": 47
    },
    "score_notes": {
      "love": "Favourable",
      "career": "Mixed",
      "health": "Mixed",
      "money": "Steady"
    },
    "ruler": "sun",
    "element": "fire",
    "lucky": {
      "color": "Gold",
      "number": "1",
      "day": "Sunday",
      "gem": "Ruby",
      "time": "3-5 PM",
      "mood": "Patient"
    },
    "transits": [
      {
        "planet": "venus",
        "sign": "libra",
        "house": 3,
        "tone": "benefic",
        "retrograde": false
      },
      {
        "planet": "sun",
        "sign": "virgo",
        "house": 2,
        "tone": "challenging",
        "retrograde": false
      },
      {
        "planet": "mercury",
        "sign": "libra",
        "house": 3,
        "tone": "challenging",
        "retrograde": false
      },
      {
        "planet": "jupiter",
        "sign": "cancer",
        "house": 12,
        "tone": "challenging",
        "retrograde": false
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 1
  },
  "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

sign (path)

period (query)

lang (query)

date (query)

All 12 signs (publisher feed)

GET/v1/horoscope

5 credits · Secret or publishable key · getHoroscopeFeed

Parameters

Name	In	Type	Notes
`period`	query	string	one of `daily`, `weekly`, `monthly`, `yearly` · default `"daily"`
`lang`	query	string	one of `en`, `hi` · default `"en"`
`date`	query	string (date)

Response

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

period string required
date string (date) required
e.g. "1990-08-13"
signs array of Horoscope 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
  Fields
  - love integer required
    ≥ 0 · ≤ 100
  - career integer required
    ≥ 0 · ≤ 100
  - health integer required
    ≥ 0 · ≤ 100
  - money integer required
    ≥ 0 · ≤ 100
- score_notes object required
  Fields
  - love string required
  - career string required
  - health string required
  - money string required
- ruler string required
- element string required
- lucky object required
  Fields
  - color string required
  - number string required
  - day string required
  - gem string required
  - time string required
  - mood string required
- transits array of object required
  Fields
  - planet string required
  - sign string required
  - house integer required
    ≥ 1 · ≤ 12
  - tone string required
  - retrograde boolean required

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

Example request

curl 'https://api.astrologics.in/v1/horoscope?period=daily&date=2026-10-02' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'

Node.js

const res = await fetch("https://api.astrologics.in/v1/horoscope?period=daily&date=2026-10-02", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/horoscope?period=daily&date=2026-10-02",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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?period=daily&date=2026-10-02');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 23,035 characters

{
  "data": {
    "period": "daily",
    "date": "2026-10-02",
    "signs": [
      {
        "sign": "aries",
        "sign_label": "Aries",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 2nd house in Mrigashira, setting an emotional, sensitive tone for finances, family and what you value. Sun's transit through your 6th house favours health, daily routine and rivals - 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 today - steady effort beats haste.",
        "scores": {
          "love": 35,
          "career": 46,
          "health": 43,
          "money": 39
        },
        "score_notes": {
          "love": "Take care",
          "career": "Steady",
          "health": "Mixed",
          "money": "Mixed"
        },
        "ruler": "mars",
        "element": "fire",
        "lucky": {
          "color": "Red",
          "number": "9",
          "day": "Tuesday",
          "gem": "Red Coral",
          "time": "5-7 PM",
          "mood": "Cautious"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 2,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "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
          }
        ]
      },
      {
        "sign": "taurus",
        "sign_label": "Taurus",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 1st house in Mrigashira, setting an emotional, supportive tone for your energy, confidence and sense of self. Mercury's transit through your 6th house favours health, daily routine and rivals - a good window to push ahead there. Venus in your 6th house asks for patience around health, daily routine and rivals; avoid rushing decisions there. Ruled by Venus, your devoted nature serves you well today - lean into the momentum.",
        "scores": {
          "love": 58,
          "career": 53,
          "health": 61,
          "money": 54
        },
        "score_notes": {
          "love": "Favourable",
          "career": "Steady",
          "health": "Favourable",
          "money": "Steady"
        },
        "ruler": "venus",
        "element": "earth",
        "lucky": {
          "color": "Green",
          "number": "6",
          "day": "Friday",
          "gem": "Diamond",
          "time": "12-2 PM",
          "mood": "Determined"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 1,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 6,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 5,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 6,
            "tone": "benefic",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "gemini",
        "sign_label": "Gemini",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 12th house in Mrigashira, setting an emotional, sensitive tone for rest, expenses and inner life. Venus's transit through your 5th house favours romance, creativity and children, and it is strongly placed - a good window to push ahead there. Sun in your 4th house asks for patience around home, property and peace of mind; avoid rushing decisions there. Ruled by Mercury, your articulate nature serves you well today - steady effort beats haste.",
        "scores": {
          "love": 48,
          "career": 43,
          "health": 34,
          "money": 49
        },
        "score_notes": {
          "love": "Steady",
          "career": "Mixed",
          "health": "Take care",
          "money": "Steady"
        },
        "ruler": "mercury",
        "element": "air",
        "lucky": {
          "color": "Yellow",
          "number": "5",
          "day": "Wednesday",
          "gem": "Emerald",
          "time": "4-6 PM",
          "mood": "Cautious"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 12,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 5,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 4,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 5,
            "tone": "challenging",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "cancer",
        "sign_label": "Cancer",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 11th house in Mrigashira, setting an emotional, supportive tone for income, gains and friendships. Venus's transit through your 4th house favours home, property and peace of mind, and it is strongly placed - a good window to push ahead there. Jupiter in your 1st house asks for patience around your energy, confidence and sense of self; avoid rushing decisions there. Ruled by Moon, your intuitive nature serves you well today - lean into the momentum.",
        "scores": {
          "love": 67,
          "career": 54,
          "health": 61,
          "money": 61
        },
        "score_notes": {
          "love": "Strong",
          "career": "Steady",
          "health": "Favourable",
          "money": "Favourable"
        },
        "ruler": "moon",
        "element": "water",
        "lucky": {
          "color": "White",
          "number": "2",
          "day": "Monday",
          "gem": "Pearl",
          "time": "9-11 AM",
          "mood": "Motivated"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 11,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 4,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 3,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 4,
            "tone": "benefic",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "leo",
        "sign_label": "Leo",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 10th house in Mrigashira, setting an emotional, supportive tone for career, status and public standing. Venus's transit through your 3rd house favours courage, communication and your own efforts, and it is strongly placed - a good window to push ahead there. Sun in your 2nd house asks for patience around finances, family and what you value; avoid rushing decisions there. Ruled by Sun, your charismatic nature serves you well today - steady effort beats haste.",
        "scores": {
          "love": 66,
          "career": 36,
          "health": 54,
          "money": 51
        },
        "score_notes": {
          "love": "Strong",
          "career": "Take care",
          "health": "Steady",
          "money": "Steady"
        },
        "ruler": "sun",
        "element": "fire",
        "lucky": {
          "color": "Gold",
          "number": "1",
          "day": "Sunday",
          "gem": "Ruby",
          "time": "9-11 AM",
          "mood": "Calm"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 10,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 3,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 2,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 3,
            "tone": "challenging",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "virgo",
        "sign_label": "Virgo",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 9th house in Mrigashira, setting an emotional, sensitive tone for luck, travel, learning and higher purpose. Venus's transit through your 2nd house favours finances, family and what you value, and it is strongly placed - a good window to push ahead there. Sun in your 1st house asks for patience around your energy, confidence and sense of self; avoid rushing decisions there. Ruled by Mercury, your practical nature serves you well today - steady effort beats haste.",
        "scores": {
          "love": 53,
          "career": 51,
          "health": 39,
          "money": 58
        },
        "score_notes": {
          "love": "Steady",
          "career": "Steady",
          "health": "Mixed",
          "money": "Favourable"
        },
        "ruler": "mercury",
        "element": "earth",
        "lucky": {
          "color": "Green",
          "number": "5",
          "day": "Wednesday",
          "gem": "Emerald",
          "time": "6-8 PM",
          "mood": "Reflective"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 9,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 2,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 1,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 2,
            "tone": "benefic",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "libra",
        "sign_label": "Libra",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 8th house in Mrigashira, setting an emotional, sensitive tone for change, shared resources and deeper matters. Venus's transit through your 1st house favours your energy, confidence and sense of self, and it is strongly placed - a good window to push ahead there. Sun in your 12th house asks for patience around rest, expenses and inner life; avoid rushing decisions there. Ruled by Venus, your fair-minded nature serves you well today - steady effort beats haste.",
        "scores": {
          "love": 44,
          "career": 46,
          "health": 42,
          "money": 43
        },
        "score_notes": {
          "love": "Mixed",
          "career": "Steady",
          "health": "Mixed",
          "money": "Mixed"
        },
        "ruler": "venus",
        "element": "air",
        "lucky": {
          "color": "Blue",
          "number": "6",
          "day": "Friday",
          "gem": "Diamond",
          "time": "9-11 AM",
          "mood": "Reserved"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 8,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 1,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 12,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 1,
            "tone": "challenging",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "scorpio",
        "sign_label": "Scorpio",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 7th house in Mrigashira, setting an emotional, supportive tone for partnerships and close relationships. Venus's transit through your 12th house favours rest, expenses and inner life, and it is strongly placed - a good window to push ahead there. Mercury in your 12th house asks for patience around rest, expenses and inner life; avoid rushing decisions there. Ruled by Mars, your loyal nature serves you well today - lean into the momentum.",
        "scores": {
          "love": 65,
          "career": 49,
          "health": 63,
          "money": 65
        },
        "score_notes": {
          "love": "Strong",
          "career": "Steady",
          "health": "Favourable",
          "money": "Strong"
        },
        "ruler": "mars",
        "element": "water",
        "lucky": {
          "color": "Maroon",
          "number": "9",
          "day": "Tuesday",
          "gem": "Red Coral",
          "time": "4-6 PM",
          "mood": "Bright"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 7,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 12,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 11,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 12,
            "tone": "challenging",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "sagittarius",
        "sign_label": "Sagittarius",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 6th house in Mrigashira, setting an emotional, supportive tone for health, daily routine and rivals. Venus's transit through your 11th house favours income, gains and friendships, and it is strongly placed - a good window to push ahead there. Jupiter in your 8th house asks for patience around change, shared resources and deeper matters; avoid rushing decisions there. Ruled by Jupiter, your adventurous nature serves you well today - lean into the momentum.",
        "scores": {
          "love": 64,
          "career": 54,
          "health": 63,
          "money": 65
        },
        "score_notes": {
          "love": "Favourable",
          "career": "Steady",
          "health": "Favourable",
          "money": "Strong"
        },
        "ruler": "jupiter",
        "element": "fire",
        "lucky": {
          "color": "Yellow",
          "number": "3",
          "day": "Thursday",
          "gem": "Yellow Sapphire",
          "time": "5-7 PM",
          "mood": "Energised"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 6,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 11,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 10,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 11,
            "tone": "benefic",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "capricorn",
        "sign_label": "Capricorn",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 5th house in Mrigashira, setting an emotional, sensitive tone for romance, creativity and children. Mercury's transit through your 10th house favours career, status and public standing - a good window to push ahead there. Venus in your 10th house asks for patience around career, status and public standing; avoid rushing decisions there. Ruled by Saturn, your ambitious nature serves you well today - steady effort beats haste.",
        "scores": {
          "love": 38,
          "career": 54,
          "health": 43,
          "money": 53
        },
        "score_notes": {
          "love": "Mixed",
          "career": "Steady",
          "health": "Mixed",
          "money": "Steady"
        },
        "ruler": "saturn",
        "element": "earth",
        "lucky": {
          "color": "Blue",
          "number": "8",
          "day": "Saturday",
          "gem": "Blue Sapphire",
          "time": "6-8 PM",
          "mood": "Reflective"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 5,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 10,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 9,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 10,
            "tone": "benefic",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "aquarius",
        "sign_label": "Aquarius",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 4th house in Mrigashira, setting an emotional, sensitive tone for home, property and peace of mind. Venus's transit through your 9th house favours luck, travel, learning and higher purpose, and it is strongly placed - a good window to push ahead there. Sun in your 8th house asks for patience around change, shared resources and deeper matters; avoid rushing decisions there. Ruled by Saturn, your independent nature serves you well today - steady effort beats haste.",
        "scores": {
          "love": 47,
          "career": 42,
          "health": 38,
          "money": 42
        },
        "score_notes": {
          "love": "Steady",
          "career": "Mixed",
          "health": "Mixed",
          "money": "Mixed"
        },
        "ruler": "saturn",
        "element": "air",
        "lucky": {
          "color": "Blue",
          "number": "8",
          "day": "Saturday",
          "gem": "Blue Sapphire",
          "time": "7-9 AM",
          "mood": "Grounded"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 4,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 9,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 8,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 9,
            "tone": "challenging",
            "retrograde": false
          }
        ]
      },
      {
        "sign": "pisces",
        "sign_label": "Pisces",
        "period": "daily",
        "date": "2026-10-02",
        "reading": "Today the Moon moves through your 3rd house in Mrigashira, setting an emotional, supportive tone for courage, communication and your own efforts. Venus's transit through your 8th house favours change, shared resources and deeper matters, and it is strongly placed - a good window to push ahead there. Sun in your 7th house asks for patience around partnerships and close relationships; avoid rushing decisions there. Ruled by Jupiter, your creative nature serves you well today - lean into the momentum.",
        "scores": {
          "love": 70,
          "career": 46,
          "health": 54,
          "money": 69
        },
        "score_notes": {
          "love": "Strong",
          "career": "Steady",
          "health": "Steady",
          "money": "Strong"
        },
        "ruler": "jupiter",
        "element": "water",
        "lucky": {
          "color": "Sea Green",
          "number": "3",
          "day": "Thursday",
          "gem": "Yellow Sapphire",
          "time": "7-9 AM",
          "mood": "Steady"
        },
        "transits": [
          {
            "planet": "moon",
            "sign": "taurus",
            "house": 3,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "venus",
            "sign": "libra",
            "house": 8,
            "tone": "benefic",
            "retrograde": false
          },
          {
            "planet": "sun",
            "sign": "virgo",
            "house": 7,
            "tone": "challenging",
            "retrograde": false
          },
          {
            "planet": "mercury",
            "sign": "libra",
            "house": 8,
            "tone": "benefic",
            "retrograde": false
          }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 5
  },
  "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

period (query)

lang (query)

date (query)

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
  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"
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

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,030 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.9.28",
    "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"
}