API reference › Horoscopes

Weekly Rashi Tone API

The week's tone for each rashi: a 0–100 score per day, the band, the best and worst days and the planet behind it

GET/v1/horoscope/weekly/rashi-tones

1 credit · Secret or publishable key · getRashiTones

Each rashi read as a Moon sign at 12:00 IST on each day Monday to Sunday: every graha scores by its house from the rashi (good +1, bad −1; 70%) and its dignity in its sign (30%), less 0.1 when retrograde (not the nodes), weighted Jupiter 1.4, Mercury 1.3, Venus 1.2, Saturn 1.1, Sun, Moon, Mars 0.9, Rahu 0.7, Ketu 0.6, scaled to 0–100. band from the week's average (62, 54, 46, 38). driver: the graha (not the Moon) that most pushes the week in the band's direction, its house on Thursday, polarity calm when it is within ±0.15. Structure only, no sentences.

Parameters

NameInTypeNotes
week_startquerystring (date)A Monday. Default: the current week in IST (from Saturday, the coming week). e.g. "1990-08-13"

Response

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

  • week_start string (date) required

    e.g. "1990-08-13"

  • week_end string (date) required

    e.g. "1990-08-13"

  • signs array of object required
    • sign string required
    • scores array of integer required
    • avg integer required

      ≥ 0 · ≤ 100

    • band string required

      one of strongly_favourable, favourable, neutral, caution, strong_caution

    • tone string required

      one of favourable, neutral, caution

    • best_day string required
    • worst_day string required
    • flat boolean required

      The best and worst days are less than 4 apart.

    • driver object required
      Fields
      • planet string required
      • house integer required

        ≥ 1 · ≤ 12

      • polarity string required

        one of favourable, challenging, calm

      • retrograde boolean required
      • sum number required

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

Example request

curl 'https://api.astrologics.in/v1/horoscope/weekly/rashi-tones?week_start=2026-11-02' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/horoscope/weekly/rashi-tones?week_start=2026-11-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/weekly/rashi-tones?week_start=2026-11-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/weekly/rashi-tones?week_start=2026-11-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 · 6,339 characters
{
  "data": {
    "week_start": "2026-11-02",
    "week_end": "2026-11-08",
    "signs": [
      {
        "sign": "aries",
        "scores": [
          33,
          36,
          36,
          38,
          34,
          34,
          34
        ],
        "avg": 35,
        "band": "strong_caution",
        "tone": "caution",
        "best_day": "thursday",
        "worst_day": "monday",
        "flat": false,
        "driver": {
          "planet": "venus",
          "house": 7,
          "polarity": "challenging",
          "retrograde": true,
          "sum": -6.36
        }
      },
      {
        "sign": "taurus",
        "scores": [
          62,
          54,
          54,
          56,
          62,
          62,
          65
        ],
        "avg": 59,
        "band": "favourable",
        "tone": "favourable",
        "best_day": "sunday",
        "worst_day": "tuesday",
        "flat": false,
        "driver": {
          "planet": "mercury",
          "house": 6,
          "polarity": "favourable",
          "retrograde": true,
          "sum": 6.825
        }
      },
      {
        "sign": "gemini",
        "scores": [
          41,
          44,
          44,
          36,
          32,
          32,
          35
        ],
        "avg": 38,
        "band": "caution",
        "tone": "caution",
        "best_day": "tuesday",
        "worst_day": "friday",
        "flat": false,
        "driver": {
          "planet": "saturn",
          "house": 10,
          "polarity": "challenging",
          "retrograde": true,
          "sum": -6.16
        }
      },
      {
        "sign": "cancer",
        "scores": [
          57,
          52,
          52,
          54,
          41,
          41,
          34
        ],
        "avg": 47,
        "band": "neutral",
        "tone": "neutral",
        "best_day": "monday",
        "worst_day": "sunday",
        "flat": false,
        "driver": {
          "planet": "jupiter",
          "house": 2,
          "polarity": "favourable",
          "retrograde": false,
          "sum": 8.33
        }
      },
      {
        "sign": "leo",
        "scores": [
          40,
          46,
          46,
          41,
          46,
          46,
          50
        ],
        "avg": 45,
        "band": "caution",
        "tone": "caution",
        "best_day": "sunday",
        "worst_day": "monday",
        "flat": false,
        "driver": {
          "planet": "mars",
          "house": 12,
          "polarity": "challenging",
          "retrograde": false,
          "sum": -6.3
        }
      },
      {
        "sign": "virgo",
        "scores": [
          64,
          56,
          56,
          62,
          58,
          58,
          54
        ],
        "avg": 58,
        "band": "favourable",
        "tone": "favourable",
        "best_day": "monday",
        "worst_day": "sunday",
        "flat": false,
        "driver": {
          "planet": "mercury",
          "house": 2,
          "polarity": "favourable",
          "retrograde": true,
          "sum": 6.825
        }
      },
      {
        "sign": "libra",
        "scores": [
          73,
          73,
          73,
          64,
          60,
          60,
          67
        ],
        "avg": 67,
        "band": "strongly_favourable",
        "tone": "favourable",
        "best_day": "monday",
        "worst_day": "friday",
        "flat": false,
        "driver": {
          "planet": "jupiter",
          "house": 11,
          "polarity": "favourable",
          "retrograde": false,
          "sum": 8.33
        }
      },
      {
        "sign": "scorpio",
        "scores": [
          33,
          36,
          36,
          35,
          21,
          21,
          14
        ],
        "avg": 28,
        "band": "strong_caution",
        "tone": "caution",
        "best_day": "tuesday",
        "worst_day": "sunday",
        "flat": false,
        "driver": {
          "planet": "sun",
          "house": 12,
          "polarity": "challenging",
          "retrograde": false,
          "sum": -6.3
        }
      },
      {
        "sign": "sagittarius",
        "scores": [
          53,
          55,
          55,
          57,
          53,
          53,
          53
        ],
        "avg": 54,
        "band": "favourable",
        "tone": "favourable",
        "best_day": "thursday",
        "worst_day": "monday",
        "flat": false,
        "driver": {
          "planet": "jupiter",
          "house": 9,
          "polarity": "favourable",
          "retrograde": false,
          "sum": 8.33
        }
      },
      {
        "sign": "capricorn",
        "scores": [
          52,
          45,
          45,
          47,
          52,
          52,
          55
        ],
        "avg": 50,
        "band": "neutral",
        "tone": "neutral",
        "best_day": "sunday",
        "worst_day": "tuesday",
        "flat": false,
        "driver": {
          "planet": "mercury",
          "house": 10,
          "polarity": "favourable",
          "retrograde": true,
          "sum": 6.825
        }
      },
      {
        "sign": "aquarius",
        "scores": [
          59,
          58,
          58,
          50,
          46,
          46,
          49
        ],
        "avg": 52,
        "band": "neutral",
        "tone": "neutral",
        "best_day": "monday",
        "worst_day": "friday",
        "flat": false,
        "driver": {
          "planet": "jupiter",
          "house": 7,
          "polarity": "favourable",
          "retrograde": false,
          "sum": 8.33
        }
      },
      {
        "sign": "pisces",
        "scores": [
          34,
          37,
          37,
          36,
          22,
          22,
          15
        ],
        "avg": 29,
        "band": "strong_caution",
        "tone": "caution",
        "best_day": "tuesday",
        "worst_day": "sunday",
        "flat": false,
        "driver": {
          "planet": "sun",
          "house": 8,
          "polarity": "challenging",
          "retrograde": false,
          "sum": -6.3
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}
Try it

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

More in Horoscopes

Get a free API key Horoscopes product page