New Numerology API

Readings

Horoscope API for daily Vedic horoscopes and weekly readings

The horoscope API from API for Astrology (apiforastrology.com) gives a daily Vedic horoscope for each of the 12 Moon signs, the sign the Moon was in at birth.

Updated

© API for Astrology (apiforastrology.com). "Horoscope explained". All rights reserved. Not to be copied or reused.12 Moon signs, one reading eachAriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPiscesTaurusYoursignTaurusToday, Oct 1, 2026The Moon returns toyour own sign today.Moon strength: strong4 planets help4 planets hold backSame for every Taurus

How the horoscope API works

  1. 1In Vedic astrology, a daily horoscope is read from the Moon sign, the sign the Moon was in at birth.
  2. 2There are 12 Moon signs, and each one gets its own reading for the day.
  3. 3The API returns today's reading for any Moon sign: where the Moon is, how strong it is, and which planets help or hold back.
GET /v1/rashi/aries/today?date=2026-10-01&latitude=40.7128&longitude=-74.006&timezone=America/New_York200 OK
{
  "natal_moon_sign": "Aries",
  "date": "2026-10-01",
  "moon": {
    "title": "The Moon in the 2nd from your own",
    "text": [
      "The second house from your Moon sign covers family, food, speech and the money you have on hand. The Moon, which colors your mood, spends about two and a quarter days here. **Tradition counts it as a…"
    ]
  },
  "summary": {
    "favorable": 2,
    "unfavorable": 7,
    "obstructed": 0
  },
  "chandra_bala": {
    "house_from_natal_moon": 2,
    "strong": false
  },
  "applies_to": "everyone whose natal Moon is in Aries"
}
The daily horoscope for everyone whose Moon sign is Aries: the reading for the Moon's position that day, how many transits help or hinder, chandra bala, and who the horoscope applies to. Real output for Moon sign Aries, New York, Oct 1, 2026.

Call the horoscope API from your code

Send the details as JSON with your API key in the Authorization header. Copy the code, set ASTROLOGY_API_KEY to your key, and run it.

GET /v1/rashi/Taurus/today

# New York, Oct 1, 2026
curl "https://apiforastrology.com/api/astrology/v1/rashi/Taurus/today?date=2026-10-01&latitude=40.7128&longitude=-74.006&timezone=America/New_York" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY"
Response (lists shortened)200 OK
{
  "reckoned_at": "sunrise",
  "panchang": {
    "date": "2026-10-01",
    "place": {
      "latitude": 40.7128,
      "longitude": -74.006,
      "timezone": -4
    },
    "sun": {
      "rise": "2026-10-01T06:52:37-04:00",
      "set": "2026-10-01T18:37:57-04:00"
    },
    "moon": {
      "rise": "2026-10-01T21:38:37-04:00",
      "set": "2026-10-01T12:44:56-04:00"
    },
    "tithi": {
      "index": 21,
      "name": "Shashthi",
      "paksha": "krishna",
      "completion_percent": 17.4653,
      "starts": "2026-10-01T03:05:43-04:00",
      "ends": "2026-10-02T00:45:43-04:00"
    },
    "nakshatra": {
      "name": "Rohini",
      "lord": "Moon",
      "pada": 2,
      "starts": "2026-09-30T20:32:55-04:00",
      "ends": "2026-10-01T18:57:24-04:00"
    },
    "yoga": {
      "index": 16,
      "name": "Siddhi",
      "completion_percent": 76.4854,
      "starts": "2026-09-30T14:50:35-04:00",
      "ends": "2026-10-01T11:48:23-04:00"
    },
    "karana": {
      "index": 41,
      "name": "Gara",
      "completion_percent": 34.9307,
      "starts": "2026-10-01T03:05:43-04:00",
      "ends": "2026-10-01T13:55:24-04:00"
    },
    "vara": {
      "index": 5,
      "name": "Thursday",
      "lord": "Jupiter"
    },
    "masa": {
      "name": "Bhadrapada",
      "paksha": "krishna",
      "adhika": false,
      "kshaya": false,
      "convention": "amanta",
      "starts": "2026-09-10T23:27:00-04:00",
      "ends": "2026-10-10T11:50:05-04:00",
      "amanta": {
        "name": "Bhadrapada",
        "adhika": false
      },
      "purnimanta": {
        "name": "Asvina",
        "adhika": false
      },
      "rule": "a lunar month runs new moon to new moon and is named after the sankranti it contains; none makes it adhika, two make it kshaya. Purnimanta names the dark half after the following month; a leap month keeps its bounds in both"
    },
    "ritu": {
      "name": "Sharad",
      "season": "autumn"
    },
    "ritu_lunar": {
      "name": "Varsha",
      "season": "monsoon"
    },
    "samvat": {
      "shaka": 1948,
      "vikram": 2083,
      "vikram_kartikadi": 2082,
      "note": "shaka and vikram turn at Chaitra, not at the Gregorian new year; vikram_kartikadi is the Vikram year as Gujarat counts it, turning at Kartika (the day after Diwali)"
    },
    "ayana": "Dakshinayana",
    "ayana_sidereal": "Dakshinayana",
    "reckoning": {
      "ritu": "tropical Sun",
      "ayana": "tropical Sun",
      "ritu_lunar": "lunar month",
      "ayana_sidereal": "sidereal Sun",
      "note": "ritu and ayana follow the solstices and equinoxes (the tropical Sun). Festivals, vrats and the lunar month keep the lunar reckoning; their dates are unchanged."
    },
    "inauspicious": {
      "rahu_kaal": {
        "starts": "2026-10-01T14:13:27-04:00",
        "ends": "2026-10-01T15:41:37-04:00"
      },
      "yamaganda": {
        "starts": "2026-10-01T06:52:37-04:00",
        "ends": "2026-10-01T08:20:47-04:00"
      },
      "gulika_kaal": {
        "starts": "2026-10-01T09:48:57-04:00",
        "ends": "2026-10-01T11:17:07-04:00"
      }
    },
    "auspicious": {
      "abhijit_muhurta": {
        "starts": "2026-10-01T12:21:46-04:00",
        "ends": "2026-10-01T13:08:47-04:00",
        "overlaps": [],
        "clear": [
          {
            "starts": "2026-10-01T12:21:46-04:00",
            "ends": "2026-10-01T13:08:47-04:00"
          }
        ]
      }
    },
    "muhurta": {
      "weekday_lord": "Jupiter",
      "conflicts": [
        {
          "band": "yamaganda",
          "choghadiya": "Shubh",
          "eighth": 1,
          "note": "Shubh is reckoned benefit and auspicious beginnings, and yamaganda covers the same eighth of the day. The two tables disagree here; neither is applied over the other."
        },
        {
          "band": "rahu_kaal",
          "choghadiya": "Amrit",
          "eighth": 6,
          "note": "Amrit is reckoned the best of the eight, and rahu kaal covers the same eighth of the day. The two tables disagree here; neither is applied over the other."
        }
      ],
      "choghadiya": {
        "day": [
          {
            "graha": "Jupiter",
            "name": "Shubh",
            "quality": "auspicious",
            "signifies": "benefit and auspicious beginnings",
            "starts": "2026-10-01T06:52:37-04:00",
            "ends": "2026-10-01T08:20:47-04:00",
            "index": 1
          },
          {
            "graha": "Mars",
            "name": "Rog",
            "quality": "inauspicious",
            "signifies": "illness and conflict",
            "starts": "2026-10-01T08:20:47-04:00",
            "ends": "2026-10-01T09:48:57-04:00",
            "index": 2
          },
          {
            "graha": "Sun",
            "name": "Udveg",
            "quality": "inauspicious",
            "signifies": "anxiety and unrest",
            "starts": "2026-10-01T09:48:57-04:00",
            "ends": "2026-10-01T11:17:07-04:00",
            "index": 3
          }
        ],
        "night": [
          {
            "graha": "Moon",
            "name": "Amrit",
            "quality": "auspicious",
            "signifies": "the best of the eight",
            "starts": "2026-10-01T18:37:57-04:00",
            "ends": "2026-10-01T20:09:54-04:00",
            "index": 1
          },
          {
            "graha": "Venus",
            "name": "Char",
            "quality": "neutral",
            "signifies": "movement; good for travel",
            "starts": "2026-10-01T20:09:54-04:00",
            "ends": "2026-10-01T21:41:52-04:00",
            "index": 2
          },
          {
            "graha": "Mars",
            "name": "Rog",
            "quality": "inauspicious",
            "signifies": "illness and conflict",
            "starts": "2026-10-01T21:41:52-04:00",
            "ends": "2026-10-01T23:13:50-04:00",
            "index": 3
          }
        ]
      },
      "hora": [
        {
          "index": 1,
          "lord": "Jupiter",
          "starts": "2026-10-01T06:57:02-04:00",
          "ends": "2026-10-01T07:57:04-04:00"
        },
        {
          "index": 2,
          "lord": "Mars",
          "starts": "2026-10-01T07:57:04-04:00",
          "ends": "2026-10-01T08:57:07-04:00"
        },
        {
          "index": 3,
          "lord": "Sun",
          "starts": "2026-10-01T08:57:07-04:00",
          "ends": "2026-10-01T09:57:09-04:00"
        }
      ],
      "rule": "all three walk the descending Chaldean order -- Saturn, Jupiter, Mars, Sun, Venus, Mercury, Moon. Horas and day choghadiya start at the weekday lord and move one place at a time; night choghadiya start at the lord of the fifth weekday from…",
      "note": "day choghadiya divide daylight, night choghadiya divide the night, and horas divide sunrise to sunrise. The three do not share boundaries and are not meant to. Choghadiya and the bands run on the visible sunrise the calendars print; the…"
    },
    "reckoned_at": "sunrise",
    "meta": {
      "ayanamsa": "lahiri",
      "ayanamsa_value": 24.230763,
      "ephemeris": "JPL DE440s"
    }
  },
  "moon": {
    "id": "daily:moon",
    "title": "The Moon in the 1st from your own",
    "family": "transits",
    "text": [
      "About every 27 days, the Moon returns to your own Moon sign, your first house. It stays about two and a quarter days. The Moon rules your mood and feelings, and here it is back where it was when you were born. **So tradition counts this as…",
      "What you can do: use these two days for anything where your own read of things matters most. Right now you usually aren't detached, even if you don't notice. So these two days suit work that needs you to stay detached less well. A good…"
    ],
    "language": "en",
    "detail": "standard",
    "sign": "Taurus",
    "house_from_moon": 1,
    "result": "favorable",
    "net": "obstructed",
    "obstructed": true,
    "obstructed_by": [
      "Sun"
    ],
    "vedha_house": 5
  },
  "transits": [
    {
      "id": "daily:transit:Sun",
      "title": "Sun in the 5th from your Moon",
      "family": "transits",
      "text": [
        "Counted from your Moon sign, the fifth house covers children, learning, judgment and the things you create. The Sun brings confidence, and during its month here that is exactly the risk. **From the inside, confidence and good judgment feel…",
        "What you can do: keep your money out of speculation this month, because your confidence makes a risk look smaller than it is. If someone criticizes your idea, listen before you defend it. Creative work and teaching can still go well when…"
      ],
      "language": "en",
      "detail": "standard",
      "graha": "Sun",
      "sign": "Virgo",
      "house_from_moon": 5,
      "result": "unfavorable",
      "net": "unfavorable",
      "obstructed": false,
      "obstructed_by": []
    },
    {
      "id": "daily:transit:Mars",
      "title": "Mars in the 3rd from your Moon",
      "family": "transits",
      "text": [
        "Transits are counted from your Moon sign. The third house from it covers effort, courage, short trips and your brothers and sisters. Mars is the planet of drive and nerve, exactly what this house needs. **Its stay of about six weeks here…",
        "What you can do: this is your window for the hard push. That could be the confrontation, the deadline or the job that needs force more than skill. What you get done now often lasts after the transit ends. Leave delicate work for another…"
      ],
      "language": "en",
      "detail": "standard",
      "graha": "Mars",
      "sign": "Cancer",
      "house_from_moon": 3,
      "result": "favorable",
      "net": "favorable",
      "obstructed": false,
      "obstructed_by": []
    },
    {
      "id": "daily:transit:Mercury",
      "title": "Mercury in the 6th from your Moon",
      "family": "transits",
      "text": [
        "The sixth house, counted from your Moon sign, covers disputes, debts, daily work and health. Mercury handles all of these through detail, and right now you have the detail. **So its three to four weeks here are one of its strong transits…",
        "What you can do: bring the dispute, the debt and the health question to these weeks. Watch your tone, though, because being precise can sound like criticism. A colleague you correct now, even rightly, may remember it later."
      ],
      "language": "en",
      "detail": "standard",
      "graha": "Mercury",
      "sign": "Libra",
      "house_from_moon": 6,
      "result": "favorable",
      "net": "favorable",
      "obstructed": false,
      "obstructed_by": []
    }
  ],
  "summary": {
    "favorable": 4,
    "unfavorable": 4,
    "obstructed": 1
  },
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "note": "the Moon leads because it is the only part of the chart that moves fast enough to make one day differ from the next. The slower grahas set the season the day sits in.",
  "sadesati": {
    "present": false,
    "phase": null,
    "in_break": false,
    "current": null,
    "next": {
      "starts": "2027-06-02T19:58:14",
      "ends": "2034-07-12T18:52:56",
      "complete": true,
      "phases": [
        {
          "phase": "rising",
          "sanskrit": "arohini",
          "house_from_moon": 12,
          "starts": "2027-06-02T19:58:14",
          "ends": "2027-10-19T21:42:18"
        },
        {
          "phase": "rising",
          "sanskrit": "arohini",
          "house_from_moon": 12,
          "starts": "2028-02-23T09:54:05",
          "ends": "2029-08-08T03:02:03"
        },
        {
          "phase": "peak",
          "sanskrit": "madhya",
          "house_from_moon": 1,
          "starts": "2029-08-08T03:02:03",
          "ends": "2029-10-05T07:22:54"
        }
      ],
      "breaks": [
        {
          "starts": "2027-10-19T21:42:18",
          "ends": "2028-02-23T09:54:05",
          "reason": "Saturn retrograde back out of the band"
        }
      ]
    },
    "dhaiya_present": false,
    "kantaka_present": false,
    "dhaiya_kantaka": null
  },
  "natal_moon_sign": "Taurus",
  "chandra_bala": {
    "house_from_natal_moon": 1,
    "strong": true,
    "decided_by": "house",
    "paksha": null,
    "sources_agree": true,
    "rule": "the transit Moon in the 1st, 3rd, 6th, 7th, 10th or 11th from the natal Moon is strong; in the 4th, 8th or 12th weak. In the 2nd, 5th or 9th it is strong in the bright half (shukla paksha) and weak in the dark half (krishna paksha)"
  },
  "date": "2026-10-01",
  "place": {
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -4,
    "timezone_info": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  },
  "applies_to": "everyone whose natal Moon is in Taurus",
  "not_claimed": "a reading of one person. No ascendant, house, running dasha or ashtakavarga enters it; supply a birth chart to /v1/reading/daily for those."
}

What the horoscope API returns

  • A daily horoscope for each Moon sign (rashi) from GET /v1/rashi/{sign}/today. It reads the Moon's position for the day, counted from that sign, and gives a reading for each slower planet.
  • A count of the day's helpful and difficult transits (the planets' current positions), with vedha (one planet blocking another) already applied.
  • Chandra bala, a daily rating from the Moon's position. Also whether sade sati, Saturn's seven-and-a-half-year pass over the Moon sign, is running for that sign, with its dates.
  • The day's panchang (Hindu calendar) for the place you send: sunrise, tithi (lunar day), nakshatra (the Moon's star group) and more. So one call fills a horoscope page.
  • A personal daily reading from POST /v1/reading/daily: the same transits read from the person's own Moon. It adds their running dashas (planetary periods) and tara bala (a daily rating from their birth star).
  • A personal weekly reading from POST /v1/reading/weekly: seven days from the date you send. Each day has the Moon's house, tara bala and chandra bala. The week's better and harder days follow a stated rule, and planets that change house or direction get their own text.
  • The dated items in that week: the birth star day, festivals, fasts, eclipses and birthdays.
  • applies_to and not_claimed, which say who a sign horoscope is for and what it cannot say, so your page can say it too.
  • A Moon sign from a first name, for a reader with no birth details: GET /v1/name/rashi reads the first sound of the name. A spelling that can mean two signs returns both, and every answer says a name is not a birth chart.
  • Text in another language with lang=hi for Hindi, and longer text with detail=expanded.

Sign horoscopes are for the Moon sign, the Vedic way, not the Sun sign most Western horoscopes use. A reader who knows only a Sun sign needs their Moon sign first, which POST /v1/planets gives from their birth details. Sign horoscopes are daily. For one person, the weekly reading covers seven days at a time. For a month or a year, the monthly topic readings and the annual forecast work from a full birth chart.

Horoscope API endpoints

What it uses from your plan

Calculations use 1 call each. Written readings use reading credits instead:

  • Weekly reading3 credits
What reading credits buy

The rules behind the horoscope API

Transits are counted from the birth Moon, not from the rising sign (TR-01). Each planet helps from some houses and hinders from others (TR-02). A helpful transit can be blocked by another planet, which is called vedha (TR-03). The Moon leads a daily reading because it is the only planet that changes house every two or three days. Chandra bala rates the day by the Moon's house from the birth Moon. In the 2nd, 5th and 9th houses, the Moon counts as strong only in the bright half of the lunar month. A week's better days pass both tara bala and chandra bala, and its harder days fail both (TR-09). Sade sati comes back in dated phases (SS-01), and monthly readings follow the same transits (MF-01).

How we check the numbers

Every answer here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004. An arc second is 1/3,600 of a degree. Our tests fail if a result drifts past these figures.

A practicing astrologer reviews the rules behind these answers. Each rule has an ID you can look up in the public rulebook.

See how we test accuracy

From the blog

Horoscope API questions

All questions
Is the daily horoscope API based on the Sun sign?

No. It is written for the Moon sign (rashi), the Vedic way. So a reader who knows only their Western Sun sign may belong to a different sign here. Our free nakshatra finder shows the Moon sign from birth details, and POST /v1/planets returns it in your app.

Try the nakshatra finder
What if a reader does not know their birth details?

Use GET /v1/name/rashi with their first name. It reads the first sound of the name as a birth-star quarter, from the traditional naming syllables, and returns that Moon sign. Then fetch the horoscope for that sign. The answer always says a name is not a birth chart. It is right only when the name was chosen from the birth star.

Baby names by birth syllable
How do I ask for a sign?

Put the sign in the path as its English name, its Sanskrit name or its number, so Taurus, Vrishabha and 2 all work. Add date for any day, including tomorrow, and send latitude, longitude and timezone so the day's panchang is for your readers' city.

See the reading endpoints
Is the sign horoscope the same for every reader of that sign?

Yes. Nothing personal goes into it, so every reader with that Moon sign gets the same reading for a given date and city. The applies_to and not_claimed fields say so. For one person's day, use POST /v1/reading/daily.

What is different in the personal daily reading?

It reads the day's transits from the person's own birth Moon. It adds their running dasha periods, sade sati if it is running, and tara bala. Send latitude and longitude for where the person is today, since sunrise and the panchang change with the place.

Are weekly or monthly horoscopes available?

For one person, yes. POST /v1/reading/weekly reads seven days from the date you send in from. Sign horoscopes, with no birth details, are daily only. For longer spans, the monthly topic readings cover career, love, wealth and good and bad days for one chart. The annual forecast covers a full year. All of them need the person's birth details.

About the readings
What does the weekly reading add to the daily one?

A view of the whole week. Each of the seven days has the daily reading's Moon, tara bala and chandra bala. The week's better days pass both checks and its harder days fail both, by a stated rule with no score. Planets that change house or turn direction get their own text. Festivals, fasts, eclipses and the birth star day are dated too.

Where the festival dates come from

Astrology API

Call it with a free test key

Create an account and a test key, then call any endpoint on this page. Or try a request in the API reference first.

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer