SEARCH ASTRO INSIGHT API DOCS
The Hora Muhurat API provides Panchang related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/panchang/hora-muhurta
en
hi
ma
Methodology and astrological context for 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.
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.
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
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
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
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
|
hour
Required
|
integer |
Hour of birth in 24-hour format (0–23).
Example:
12
|
|
min
Required
|
integer |
Minute of birth (0–59).
Example:
30
|
|
sec
Optional
|
integer |
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example:
30
|
|
lat
Required
|
float |
Latitude of the birth location.
Example:
28.6139
|
|
lon
Required
|
float |
Longitude of the birth location.
Example:
77.1025
|
|
tzone
Optional
|
float |
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Hora Muhurat.
The Hora Muhurat API provides authentic Panchang calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Hora Muhurat API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Hora Muhurat consumes 1 API credit. The endpoint delivers high performance with an average response time of ~38ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.