Hora Muhurat API

Hora Muhurat

The Hora Muhurat API returns the complete Hora (planetary hour) schedule for a given date and geographic location. Hora is one of the oldest and most universally applied timing systems in Vedic and Western astrology — it divides the day and night into 24 equal one-hour segments, each governed by one of the seven classical planets. The ruling planet of each Hora imparts its qualities to that hour, making this system a powerful tool for aligning activities with the most favourable planetary energy at any given time.

What This API Does

This endpoint calculates all 24 Hora segments for the specified date and location, covering both the daytime (sunrise to sunset) and nighttime (sunset to next sunrise) periods. Each Hora is assigned its ruling planet and precise start and end times derived from the actual local sunrise and sunset. The sequence of planetary rulers follows the classical Chaldean order, and the first Hora of the day is always ruled by the planet that governs the weekday. The Ayanamsha is configurable via a request header.

Data Returned

The response provides a full 24-Hora schedule for the day, typically including:

• Day Horas — Hora segments from sunrise to sunset, each with:

  • Hora number — Sequential index within the day

  • Ruling planet — The classical planet governing the Hora (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn)

  • Start and end time — Precise local times for the Hora boundaries

  • Auspiciousness / nature — The general quality of the Hora based on its ruling planet (e.g., benefic or malefic)

• Night Horas — Hora segments from sunset to the following sunrise, with the same attributes

• Sunrise and Sunset times — The anchor points used to divide the day and night into Hora intervals

• Day lord — The planet ruling the weekday, which also governs the first Hora of the day

The nature of each planetary Hora is broadly characterised as:

• Sun — Authority, government, leadership activities

• Moon — Travel, public dealings, emotional matters

• Mars — Courage, surgery, competitive activities; generally malefic

• Mercury — Communication, trade, education, writing

• Jupiter — Auspicious activities, religious work, financial matters; highly benefic

• Venus — Arts, romance, luxury, pleasure; benefic

• Saturn — Labour, agriculture, long-term planning; generally malefic

Main Use Cases

• Activity-planet alignment — Helping users choose the most favourable hour for a specific type of activity by matching the task to the ruling planet of the Hora (e.g., Mercury Hora for signing contracts, Jupiter Hora for financial decisions)

• Muhurta and electional astrology — Serving as a complementary timing layer alongside Choghadiya and Panchang data for selecting the most auspicious moment to begin important undertakings

• Daily astrology apps — Powering a live "current Hora" feature that shows users which planetary hour is active right now and what activities it favours

• Business and professional scheduling — Enabling professionals to align meetings, negotiations, launches, and communications with the most supportive planetary hour

• Spiritual and devotional practice — Identifying the Sun Hora (ideal for solar worship), Moon Hora (for lunar rituals), or Jupiter Hora (for prayers and religious activities)

• Medical and health apps — Surfacing Mars Hora for surgical procedures or Venus Hora for wellness activities, in line with traditional Vedic medical astrology

Key Functionality

• Full 24-Hora coverage — Returns all 24 planetary hours (day and night combined) in a single response, providing a complete timing map for the entire day

• Precise, location-aware time boundaries — Each Hora's start and end times are computed from the actual astronomical sunrise and sunset at the specified coordinates, ensuring accuracy for any location worldwide

• Classical Chaldean sequence — Hora rulers follow the traditional Chaldean planetary order (Saturn, Jupiter, Mars, Sun, Venus, Mercury, Moon), with the first Hora of the day determined by the weekday lord

• Planet nature classification — Each Hora is labelled with its ruling planet and general nature (benefic/malefic), making the data immediately actionable without additional astrological processing

• Location-aware — Uses latitude, longitude, and timezone offset to derive the local sunrise and sunset, from which all Hora intervals are proportionally calculated

• Configurable Ayanamsha — The X-Ayanamsha header allows selection of the sidereal correction system (e.g., Lahiri, Raman, KP), ensuring compatibility with different Vedic astrology traditions

• Multi-language support — The Accept-Language header enables planet names and Hora labels to be returned in the preferred regional or vernacular language