Use case
Astrology content API for publishers
Updated
How it works
- 1A news site runs a horoscope page every day.
- 2Each morning it asks the API for the day's times in its readers' city and a reading for each of the 12 Moon signs.
- 3The API gives fresh times and text for that date and city, ready to publish.
GET /v1/panchang/daily?date=2026-10-01&latitude=40.7128&longitude=-74.006&timezone=America/New_York200 OK{
"date": "2026-10-01",
"sun": {
"rise": "2026-10-01T06:52:37-04:00"
},
"tithi": {
"name": "Shashthi"
},
"nakshatra": {
"name": "Rohini"
},
"vara": {
"name": "Thursday"
},
"inauspicious": {
"rahu_kaal": {
"starts": "2026-10-01T14:13:27-04:00",
"ends": "2026-10-01T15:41:37-04:00"
}
}
}How to publish a daily panchang and horoscope
Each step is one call, linked to its page in the API reference. Where a card shows values, they are real API output. Planet positions come from NASA JPL planet data (DE440). We check them against NASA JPL Horizons. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. An arc second is 1/3,600 of a degree. See how we test accuracy. A practicing astrologer reviews the rules behind these answers. Each rule has an ID in the public rulebook.
- 01
Today's panchang
GET /v1/panchang/dailyThe day's tithi (lunar day), nakshatra (the Moon's star group), sunrise, rahu kaal (a time to avoid) and good times for your readers' city.
- tithi.name
- "Shashthi"
- nakshatra.name
- "Rohini"
- inauspicious.rahu_kaal.starts
- "2026-10-01T14:13:27-04:00"
Real output from the example in the API reference.
- 02
Moon-sign horoscopes
GET /v1/rashi/{sign}/todayA daily reading for each of the 12 Moon signs (the sign the Moon was in at birth). It is not a Sun-sign horoscope, and it says so.
- moon.sign
- "Taurus"
- moon.title
- "The Moon in the 1st from your own"
- transits.0.title
- "Sun in the 5th from your Moon"
Real output from the example in the API reference.
- 03
A festival and fasting calendar
GET /v1/panchang/monthA month page with each day's tithi, and that day's festivals and fasts.
- days.0.date
- "2026-10-01"
- days.0.tithi.name
- "Shashthi"
- days.1.tithi.name
- "Saptami"
Real output from the example in the API reference.
- 04
Sky events
GET /v1/sky/eventsSign changes, retrogrades (when a planet seems to move backward) and conjunctions (planets meeting) for a date range. No chart is needed, so they suit news-style stories.
- from
- "2026-10-01"
- to
- "2026-12-31"
- counts.ingress
- 19
- counts.retrograde
- 4
Real output from the example in the API reference.
- 05
Readings for subscribers
POST /v1/reading/dailyFor signed-in readers who share their birth details: the day read against their own chart.
- date
- "2026-10-01"
- natal_moon_sign
- "Taurus"
- moon.title
- "The Moon in the 1st from your own"
- moon.result
- "favorable"
Real output from the example in the API reference.
What you send, what you get, what it costs
| You send | A date and your readers' city: its latitude, longitude and time zone. Personal readings also need the reader's birth details. |
|---|---|
| You get | The day's panchang, a horoscope for each of the 12 Moon signs, the month's festivals and fasts, and the sky's sign changes and retrogrades. |
| It costs | Steps 1, 2, 3, 4 and 5: 1 call each. |
Costs are for a live key, and failed requests are free. The Free plan includes 2,000 calls and 150 reading credits a month.
Step 1 in code: today's panchang
Put the date and the place in the query string, and your API key in the Authorization header. The other steps work the same way, and each one links to its page in the API reference.
GET /v1/panchang/daily
# New York, Oct 1, 2026
curl "https://apiforastrology.com/api/astrology/v1/panchang/daily?date=2026-10-01&latitude=40.7128&longitude=-74.006&timezone=America/New_York" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY"{
"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"
}
},
"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…",
"readings": {
"choghadiya": {
"Shubh": {
"text": [
"Shubh, which means auspicious, is the right window for proper, formal beginnings. The day is divided into eight choghadiyas, blocks of about an hour and a half, and so is the night. Each one is ruled by a planet. Shubh belongs to Jupiter,…",
"Use it to sign contracts, go to important appointments or open a business. It also suits a ceremony connected with study or worship."
],
"language": "en",
"detail": "standard"
},
"Rog": {
"text": [
"Rog means illness or conflict. The day and the night each run through eight choghadiyas, blocks of about an hour and a half. Each block takes the character of its planet, and Rog belongs to Mars, the planet of force and conflict. Classical…",
"Keep it for hard physical work, a tough workout, a sports match, or settling a pressing dispute that needs courage."
],
"language": "en",
"detail": "standard"
},
"Udveg": {
"text": [
"Udveg means unease. The day and the night are each split into eight choghadiyas, blocks of about an hour and a half. Each one carries the nature of its planet, and Udveg belongs to the Sun. Its energy is tense and restless, so something…",
"Avoid starting a sensitive personal conversation, taking a loan, or taking a gamble in this window. Use it instead for your regular routine or for quiet reflection, and save new starts for the next good block."
],
"language": "en",
"detail": "standard"
},
"Char": {
"text": [
"Char is a neutral to mildly good window for movement and change. Each day and each night holds eight choghadiyas, blocks of roughly an hour and a half. A planet is in charge of each. Char belongs to Venus, and the word means moving. So it…",
"Char is not the best time for ceremonies meant to stay fixed for good: things begun in it keep moving. It helps most when you need to stay flexible, take a trip or make a change for the better."
],
"language": "en",
"detail": "standard"
},
"Labh": {
"text": [
"Labh means gain or profit. The day and night are cut into eight choghadiyas each, blocks of about an hour and a half. Each block takes the mood of its planet, and Labh belongs to Mercury, the planet of trade and quick thinking. So it helps…",
"Use it when you want a better return on business or need to close a deal. It also suits sending in an application. It can give you an edge in how you put your case."
],
"language": "en",
"detail": "standard"
},
"Amrit": {
"text": [
"Amrit, which means nectar, is seen as the best of all the choghadiyas. The day and the night are each divided into eight choghadiyas, blocks of roughly an hour and a half. Each block belongs to a planet, and Amrit belongs to the Moon.…",
"So Amrit is your best window for medical treatment, a religious celebration or setting out on an important trip. It also suits holding a family ceremony that matters to you. If you can move only one thing in your day, move it here."
],
"language": "en",
"detail": "standard"
},
"Kaal": {
"text": [
"The word Kaal is linked with time and loss. Every day and every night is split into eight choghadiyas, each about an hour and a half long. Each one is ruled by a planet, and Kaal belongs to Saturn, the planet of delay. Its energy is heavy…",
"Put off celebrations and good beginnings during this time. Use it instead for clearing out, routine upkeep, dealing with debts and some quiet thinking."
],
"language": "en",
"detail": "standard"
}
},
"hora": {
"Jupiter": {
"text": [
"Hora means a planetary hour: from sunrise, the seven planets take turns ruling one hour each. Jupiter is the planet of teachers, wisdom and good fortune. So its hora is the best of the seven for beginnings that need a blessing. That covers…",
"You meet a Jupiter hora three or four times a day. When it falls in a Shubh choghadiya, you have the same planet twice over. If a full muhurta (a carefully chosen time) can't be worked out, use that overlap for a formal beginning. That is…"
],
"language": "en",
"detail": "standard"
},
"Mars": {
"text": [
"Each hour from sunrise onward is a hora, a planetary hour ruled in turn by one of the seven planets. Mars is the planet of force, courage and conflict, so its hora is good for things that need force. These include surgery, physical work, a…",
"A Mars hora turns up three or four times in every 24 hours. When it falls inside a Rog choghadiya, which also belongs to Mars, the two point strongly the same way. That stretch is worth avoiding for anything likely to cause an argument.…"
],
"language": "en",
"detail": "standard"
},
"Sun": {
"text": [
"The Sun's hora is good for dealing with people above you. A hora is a planetary hour. Counting from sunrise, each hour of the day and night belongs to one of the seven planets in turn. Each hour takes on its planet's nature, and the Sun…",
"Each hora lasts about an hour. Every planet's hora comes around three or four times between one sunrise and the next. So waiting for the right one rarely costs you a whole day. Because the count runs from sunrise to sunrise, not midnight…"
],
"language": "en",
"detail": "standard"
},
"Venus": {
"text": [
"A hora is one planet's hour: counted from sunrise, the seven planets rule the hours in a repeating order. Venus is the planet of love, beauty and comfort. So its hora is good for marriage, relationships, art and buying things meant to give…",
"It comes around three or four times a day. A Char choghadiya also belongs to Venus. When the two overlap, the pair is traditionally read as good for travel. That is because in this scheme Venus rules movement. When a Venus hora falls in…"
],
"language": "en",
"detail": "standard"
},
"Mercury": {
"text": [
"From sunrise, the hours of the day and night are handed out one by one to the seven planets. Each such hour is called a hora. Mercury is the planet of speech, trade and quick thinking. So its hora is good for every kind of communication:…",
"It comes around three or four times a day, so one is nearly always within reach. When a Mercury hora falls inside a Labh choghadiya, that is the classic slot for trade. Both belong to Mercury, and the overlap happens on most days."
],
"language": "en",
"detail": "standard"
},
"Moon": {
"text": [
"The horas are planetary hours: starting at sunrise, each hour belongs to one of the seven planets in a fixed order. The Moon rules the mind, the mother and water. So its hora is good for anything to do with the home, your mother, water and…",
"A Moon hora comes around three or four times in 24 hours. So one is usually only a few hours away. Where it overlaps with an Amrit choghadiya, use them together. Both belong to the Moon, so they strengthen each other rather than just…"
],
"language": "en",
"detail": "standard"
},
"Saturn": {
"text": [
"The day is counted in horas: planetary hours that start at sunrise and pass from one of the seven planets to the next. Saturn is the planet of time, effort and delay. So its hora is good for work that is slow, solid and unglamorous. That…",
"Saturn's hora recurs three or four times between sunrises. For a beginning, it is the one hora worth actively avoiding. When it falls in a Kaal choghadiya, both belong to Saturn and the warning is doubled. For finishing something, though,…"
],
"language": "en",
"detail": "standard"
}
}
},
"gaps": [],
"language": "en",
"detail": "standard"
},
"reckoned_at": "sunrise",
"meta": {
"ayanamsa": "lahiri",
"ayanamsa_value": 24.230763,
"ephemeris": "JPL DE440s"
},
"changes": {
"tithi": [
{
"index": 21,
"name": "Shashthi",
"paksha": "krishna",
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-02T00:45:43-04:00",
"class": "nanda"
},
{
"index": 22,
"name": "Saptami",
"paksha": "krishna",
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T22:30:08-04:00",
"class": "bhadra"
}
],
"karana": [
{
"index": 41,
"name": "Gara",
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-01T13:55:24-04:00",
"class": "movable"
},
{
"index": 42,
"name": "Vanija",
"starts": "2026-10-01T13:55:24-04:00",
"ends": "2026-10-02T00:45:43-04:00",
"class": "movable"
},
{
"index": 43,
"name": "Vishti",
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T11:37:09-04:00",
"class": "vishti"
}
],
"yoga": [
{
"index": 16,
"name": "Siddhi",
"starts": "2026-09-30T14:50:35-04:00",
"ends": "2026-10-01T11:48:23-04:00",
"class": "favorable"
},
{
"index": 17,
"name": "Vyatipata",
"starts": "2026-10-01T11:48:23-04:00",
"ends": "2026-10-02T08:47:43-04:00",
"class": "unfavorable"
}
],
"nakshatra": [
{
"index": 4,
"name": "Rohini",
"lord": "Moon",
"starts": "2026-09-30T20:32:55-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"class": "dhruva"
},
{
"index": 5,
"name": "Mrigashira",
"lord": "Mars",
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T17:25:13-04:00",
"class": "mridu"
}
]
},
"bands": {
"day_parts": {
"pratah": {
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T09:13:41-04:00"
},
"sangava": {
"starts": "2026-10-01T09:13:41-04:00",
"ends": "2026-10-01T11:34:45-04:00"
},
"madhyahna": {
"starts": "2026-10-01T11:34:45-04:00",
"ends": "2026-10-01T13:55:49-04:00"
},
"aparahna": {
"starts": "2026-10-01T13:55:49-04:00",
"ends": "2026-10-01T16:16:53-04:00"
},
"sayahna": {
"starts": "2026-10-01T16:16:53-04:00",
"ends": "2026-10-01T18:37:57-04:00"
}
},
"pradosh": {
"starts": "2026-10-01T18:37:57-04:00",
"ends": "2026-10-01T21:05:05-04:00"
},
"nishita": {
"starts": "2026-10-02T00:21:16-04:00",
"ends": "2026-10-02T01:10:19-04:00"
},
"dur_muhurta": [
{
"starts": "2026-10-01T10:47:44-04:00",
"ends": "2026-10-01T11:34:45-04:00",
"muhurta": 6,
"half": "day"
},
{
"starts": "2026-10-01T15:29:51-04:00",
"ends": "2026-10-01T16:16:53-04:00",
"muhurta": 12,
"half": "day"
}
],
"brahma_muhurta": {
"starts": "2026-10-01T05:14:53-04:00",
"ends": "2026-10-01T06:03:45-04:00"
},
"bhadra": [
{
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T11:37:09-04:00"
}
],
"panchaka": [],
"rule": "daylight and night are each fifteen equal muhurtas. The day parts are groups of three; pradosh is the night's first three, nishita its eighth. Dur muhurta by weekday. Bhadra is the Vishti karana; panchaka is the Moon in Kumbha or Meena.…",
"not_computed": {
"varjyam": "read from a 27-row table of ghati offsets per nakshatra; not reproduced until the table is verified against a source",
"amrit_kaal": "same table family as varjyam; same reason",
"godhuli": "sources give different spans around sunset"
}
},
"day_yogas": {
"weekday": "Thursday",
"anandadi": [
{
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"name": "Utpata",
"number": 16,
"nature": "inauspicious",
"nakshatra": "Rohini"
},
{
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T06:53:38-04:00",
"name": "Mrityu",
"number": 17,
"nature": "inauspicious",
"nakshatra": "Mrigashira"
}
],
"special_yogas": [
{
"code": "sarvartha_siddhi",
"name": "Sarvartha Siddhi",
"nature": "auspicious",
"forms_today": false,
"spans": [],
"rule": "the weekday with one of its listed nakshatras. Tithi is not judged here"
},
{
"code": "amrit_siddhi",
"name": "Amrit Siddhi",
"nature": "auspicious",
"forms_today": false,
"spans": [],
"rule": "the weekday with its one nakshatra. While one tithi per weekday runs with it, the yoga turns into Visha yoga: those minutes are listed under `visha`, not here"
},
{
"code": "visha",
"name": "Visha",
"nature": "inauspicious",
"forms_today": false,
"spans": [],
"rule": "Amrit Siddhi running with its cancelling tithi (Muhurta Chintamani). Each span names what it replaced (`was`) and why (`cancelled_by`). The published calendar we check against does not apply the cancellation and lists these minutes as…"
}
],
"rule": "Anandadi: count the Moon's nakshatra from the weekday's starting nakshatra (Sunday Ashwini, Monday Mrigashira, Tuesday Ashlesha, Wednesday Hasta, Thursday Anuradha, Friday Uttara Ashadha, Saturday Shatabhisha) over 28 nakshatras with…",
"not_computed": {
"tithi_cancellations": "Sarvartha Siddhi tithi exceptions differ by source and are not applied"
},
"readings": {
"anandadi": {
"Utpata": {
"text": [
"Utpata is one of the 28 Anandadi yogas. Each one is a mood of the day, read from the weekday and the Moon's nakshatra (star). Utpata means upset. Plans may get stirred up. Avoid new starts and keep to what is already in hand."
],
"language": "en",
"detail": "standard"
},
"Mrityu": {
"text": [
"Mrityu is one of the 28 Anandadi yogas. Each one is a mood of the day, read from the weekday and the Moon's nakshatra (star). Mrityu has a heavy old name. Read it simply as a time to avoid new starts and travel. Routine work is fine."
],
"language": "en",
"detail": "standard"
}
},
"special_yogas": {
"ravi_yoga": {
"text": [
"Ravi Yoga is a good time that comes from the Sun's and the Moon's nakshatras (stars). It is said to clear many small faults of the day. It suits new work, travel and important tasks."
],
"language": "en",
"detail": "standard"
}
}
},
"gaps": []
},
"disha_shool": {
"weekday": "Thursday",
"direction": "south",
"rule": "the direction to avoid starting a journey toward on this weekday: east on Monday and Saturday, north on Tuesday and Wednesday, south on Thursday, west on Friday and Sunday. `tithi_shool` and `nakshatra_shool` report two more, independent…",
"tithi_shool": {
"spans": [
{
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-02T00:45:43-04:00",
"direction": "west",
"tithi": "Shashthi"
},
{
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T06:53:38-04:00",
"direction": "northwest",
"tithi": "Saptami"
}
],
"rule": "the direction forbidden by the running tithi, by its number within either paksha (so tithi 3 is Shukla and Krishna Tritiya alike), except Purnima (Shukla's 15th) and Amavasya (Krishna's 15th), which go to different directions. Every tithi…"
},
"nakshatra_shool": {
"spans": [
{
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"direction": "west",
"nakshatra": "Rohini"
}
],
"rule": "the direction forbidden while the Moon transits Jyeshtha (east), Purva Bhadrapada (south), Rohini (west) or Uttara Phalguni (north). Only these four of the 27 nakshatras forbid a direction, so most days hold no span here"
},
"reading": {
"text": [
"Disha shool is the direction in which it is better not to start a journey today. It is set by the weekday. Trips in other directions are not affected."
],
"language": "en",
"detail": "standard"
}
},
"chandrashtama": {
"by_moon_sign": [
{
"moon_sign": "Aries",
"moon_sign_no": 1,
"eighth_sign": "Scorpio",
"holds_today": false,
"spans": []
},
{
"moon_sign": "Taurus",
"moon_sign_no": 2,
"eighth_sign": "Sagittarius",
"holds_today": false,
"spans": []
},
{
"moon_sign": "Gemini",
"moon_sign_no": 3,
"eighth_sign": "Capricorn",
"holds_today": false,
"spans": []
}
],
"rule": "the transit Moon in the 8th sign from a birth Moon sign, counted in whole signs. Find your own birth Moon sign in the list",
"reading": {
"text": [
"Chandrashtama is the time when the Moon passes through the 8th sign from your birth Moon sign (rashi). It comes for about two and a half days each month. It is better for rest and routine than for new starts."
],
"language": "en",
"detail": "standard"
}
},
"good_for": {
"reckoned_at": "sunrise",
"limbs": {
"tithi": {
"name": "Shashthi",
"class": "nanda",
"text": [
"The day's tithi (lunar day) is a Nanda tithi. The 30 lunar days of a month fall into five groups, and each group gives the day its own character. Nanda means joy, so it suits things you start for fun. Think of celebrations, music and…",
"Because it is a light day, it is not one for heavy undertakings. Enjoy it for what it is good at, and keep contracts and foundations for a Bhadra or Purna tithi."
],
"language": "en",
"detail": "standard"
},
"nakshatra": {
"name": "Rohini",
"class": "dhruva",
"text": [
"The nakshatra is the star group the Moon is passing through, one of 27. Each belongs to one of seven natures. Today's is fixed (dhruva), so it suits things meant to stay. Think of laying a foundation, planting, buying land or a home, or a…",
"What starts under it tends to settle and hold. That is also why it is a bad day for travel, or for anything you expect to change soon."
],
"language": "en",
"detail": "standard"
},
"yoga": {
"name": "Siddhi",
"class": "favorable",
"text": [
"The panchang (the traditional calendar) reads each day through five limbs: the tithi, the weekday, the nakshatra, the yoga and the karana. The yoga comes from the Sun's and Moon's positions added together. Today's is one of the 18 counted…",
"Of the five limbs, the yoga carries the least weight. Take it as a confirmation, not as a reason to act."
],
"language": "en",
"detail": "standard"
},
"karana": {
"name": "Gara",
"class": "movable",
"text": [
"A karana is half of a tithi (lunar day), and the current one is a movable karana other than Vishti. The movable karanas repeat through the month. Apart from Vishti, none of them puts a limit of its own on the day.",
"So the karana neither helps nor blocks your plans today. Judge the day by its tithi and nakshatra instead, and pick your time from what they support."
],
"language": "en",
"detail": "standard"
}
},
"gaps": [],
"not_a_muhurta": "what the day is suited to, from its limbs at sunrise. Choosing a time for one activity is /v1/muhurta/{activity}, which judges the weekday, month and the moment of beginning as well."
}
}Tips for going live
- The daily panchang and Moon-sign readings depend on the city, so send the reader's city.
- Always send latitude, longitude and timezone. Without them, dates and times are for Ujjain, India.
- The first calendar call for a new year and city takes about 8 seconds, and later calls are fast.
- Traffic peaks at festivals, so watch for 429 errors and move to a larger plan if you need more calls a minute.

What it costs
A news site that publishes the 12 daily Moon-sign horoscopes and the day's panchang for one city uses 390 calls a month. Free or Starter with a link to us, or Growth without one.
Every plan can call every endpoint: calls for calculations, reading credits for written readings. Test keys are free on every plan, with 1,000 calls a month. Paid plans start at $29 a month, and failed requests are free.
See pricingTry it free
See an answer first
Today's panchang
Tithi (lunar day), nakshatra, sunrise, rahu kaal and the choghadiya (good and bad parts of the day) for your own city.
See today's panchang
Features used here
- Kundli and birth chartsPlanets, rising sign and D1 to D60 charts
- Panchang and muhuratTithi, nakshatra, rahu kaal and good times
- Hindu calendar and festivalsFestivals, vrats and a month calendar
- Transits and forecastsGochar, sign changes and retrograde dates
- Daily horoscopesMoon-sign horoscopes, daily and weekly readings
- Readings and reportsTopic readings and a printable kundli report
Read next
From the blog

· 9 min read
Hindu Calendar 2027: Festival Dates for App Builders
Hindu calendar 2027 for New York and India.
Read
· 9 min read
How to Add a Daily Horoscope to Your Website or App
Add a Vedic daily horoscope to your website or app.
Read
· 8 min read
Why Hindu Festival Dates Change by City: Karva Chauth 2026
Karva Chauth 2026 is October 28 in New York but October 29 in Delhi.
Read
Common questions
All questionsCan we publish the daily horoscopes on a public page?
Yes. GET /v1/rashi/{sign}/today gives a daily reading for each of the 12 Moon signs, and you may publish it on your site. On the Free and Starter plans, add a link to us on that page, and on the other plans no link is needed.
What you may do with API outputIs the horoscope text unique to our site?
No. The text comes from a fixed library, so the same sign and day always get the same words, for every customer. If you want pages that read differently from other sites, add your own intro or editor's note around the reading.
Can we get weekly or monthly sign horoscopes?
Not for each sign. The sign horoscopes are daily only. For one reader, POST /v1/reading/weekly gives a weekly reading: seven days from the date you send in from, with the week's best and hardest days. It needs the reader's birth details, and so do the monthly topic readings and the annual forecast. So they suit signed-in readers who share their birth details, not a public page for each sign.
Are festival dates right for readers outside India?
Yes, when you send the city. GET /v1/festivals works out each date for the latitude, longitude and timezone you send, so readers in Chicago get Chicago dates. Where traditions keep a festival on different days, as with Janmashtami, the response says so and gives the other date.
About the Hindu calendar APICan we publish horoscopes in Hindi?
Yes. The reading text and names, such as signs and tithis, can also come in Hindi. Send lang=hi for Hindi. If a passage has no version in that language yet, the English one comes back. The response marks it with fell_back_to_en, so you can catch it before you publish.
Read the conventionsAstrology API
Start with a free test key
Create an account and a test key, then try each step above. Need more than the largest plan? Write to us.
Your first answer
John Doe, New York
- RisingVirgoHast
- SunCancerAshlesha
- MoonTaurusMrigashira
- MarsAriesKrittika
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
Open rules: every rule is published, so you can check any answer