SEARCH ASTRO INSIGHT API DOCS
The Planetary Positions Sunrise 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/planets/sunrise
en
hi
ma
Methodology and astrological context for Planetary Positions Sunrise.
This endpoint calculates and returns the precise astronomical positions of all major Vedic planets at the moment of sunrise for a given date and geographic location. Unlike standard planetary position endpoints, the positions here are computed specifically for the sunrise moment of the specified day, making them directly relevant to Vedic Panchang and daily astrological calculations.
For each planet — Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu, and the Ascendant (Lagna) — the response provides:
Degree positions — both the absolute ecliptic degree (full_degree) and the degree within the current zodiac sign (norm_degree), in both decimal and formatted (degrees:minutes:seconds) notation.
Zodiac sign placement — the sign the planet occupies, including its Western and Hindu/Vedic names, ruling lord, and associated element (Fire, Earth, Air, Water).
House placement — the astrological house (1–12) the planet occupies at the time of sunrise, calculated relative to the Ascendant.
Nakshatra (lunar mansion) — the nakshatra the planet is placed in, along with its presiding deity, ruling planet (lord), and pada (quarter, 1–4).
Planetary motion — the planet's current speed and whether it is in retrograde motion.
Avastha (planetary state) — two classical Vedic dignity indicators:
Bal Avastha (age-based state): Bala (infant), Kumar (child), Yuva (youth), Vridha (old), Mrit (dead).
Jagrat Avastha (consciousness state): Jagrat (awake), Swapan (dreaming), Supust (deep sleep).
Daily Panchang generation — computing the planetary snapshot at sunrise is a foundational step in producing a traditional Hindu Panchang (almanac) for any given day and location.
Vedic birth chart and transit analysis — determining where planets stand at the sunrise of a birth date or a significant date, used in Jyotish (Vedic astrology) chart casting.
Muhurta (auspicious timing) — evaluating planetary strengths and states at sunrise to identify favorable windows for important activities throughout the day.
Astrological software and apps — powering the planetary data layer in Jyotish applications, horoscope engines, and astrology dashboards.
Research and education — providing structured, machine-readable Vedic astronomical data for academic study or algorithmic astrology research.
Sunrise-anchored calculation — positions are computed for the exact sunrise moment derived from the supplied date, time, and coordinates, not for an arbitrary time of day.
Ayanamsha support — the coordinate system used for sidereal (Vedic) calculations is controlled via the X-Ayanamsha header, allowing selection of different ayanamsha systems (e.g., Lahiri, Raman, KP).
Full Vedic metadata — every planet and sign is returned with both Western and Sanskrit/Hindu naming conventions, symbols, and classical attributes, making the response suitable for direct display in multilingual Vedic astrology interfaces.
Ascendant (Lagna) included — the rising sign at sunrise is included as a planet entry, enabling immediate house-system construction without a separate API call.
Retrograde detection — each planet entry explicitly flags retrograde status, which is a critical factor in Vedic interpretation.
Localization-ready — the Accept-Language header allows the API to return names and labels in the requested 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 Planetary Positions Sunrise.
The Planetary Positions Sunrise 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 Planetary Positions Sunrise 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 Planetary Positions Sunrise consumes 1 API credit. The endpoint delivers high performance with an average response time of ~32ms.
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.