Panchang (almanach védique)

Le Panchang (पञ्चाङ्ग, “cinq membres”) est un almanach védique pour une journée et une géographie spécifiques. Les cinq composants principaux (tithi, vara, nakshatra, yoga, karana) déterminent la favorableité du temps pour les actions - du mariage au lancement d’un produit. AstroWay couvre tous les cinq plus des créneaux horaires supplémentaires (choghadia, hora, rahu-kaal) via une seule API.

Ce que nous calculons

Tithi (jour lunaire) : 30 tithi dans le cycle synodique, chacun avec 12° de différence Lune-Soleil. Indicateur clé pour la plupart des muhurta.
Karana (demi-tithi) : 11 karana, chacun de 6° de longitude. Classifie l’activité de la journée.
Yoga (connexion) : 27 yoga, somme des longitudes du Soleil et de la Lune, divisée par 13°20’. Caractéristique énergétique de la journée.
Nakshatra-of-day : nakshatra principal pour la date (avec une marque de transition s’il y en a plusieurs dans la journée).
Choghadia : 8 créneaux diurnes + 8 créneaux nocturnes de 1.5 heure chacun, avec les étiquettes “Amrit / Shubh / Labh / Char” (favorables) et “Kaal / Rog / Udveg” (défavorables).
Hora : heures planétaires (version védique, à partir du lever du Soleil, 24 hora d’environ 1 heure chacune).
Rahu Kaal : intervalle défavorable (1/8 de la journée lumineuse, dépend du jour de la semaine).
Full panchang : tout ce qui précède dans une seule requête (pratique pour un widget quotidien).

Endpoints

Endpoint	Crédits	Renvoie
`/v1/vedic/panchang/tithi`	20	Tithi actuel + moment de transition vers le suivant
`/v1/vedic/panchang/karana`	20	Karana actuelle + transition
`/v1/vedic/panchang/yoga`	20	Yoga actuelle + transition
`/v1/vedic/panchang/nakshatra-of-day`	20	Nakshatra du jour + pada + transition
`/v1/vedic/panchang/choghadia`	20	16 créneaux (8 jour + 8 nuit) avec étiquettes
`/v1/vedic/panchang/hora`	20	24 heures planétaires
`/v1/vedic/panchang/rahu-kaal`	20	Intervalles Rahu/Yama/Gulika Kaal
`/v1/vedic/panchang/full`	20	Tout ce qui précède dans une seule réponse

Exemple

curl -X POST https://api.astroway.info/v1/vedic/panchang/full \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-05-11",
    "time": "06:00:00",
    "timezoneOffset": 5.5,
    "latitude": 28.6139,
    "longitude": 77.2090,
    "ayanamsa": "lahiri"
  }'

const r = await fetch('https://api.astroway.info/v1/vedic/panchang/full', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '2026-05-11',
    time: '06:00:00',
    timezoneOffset: 5.5,
    latitude: 28.6139,
    longitude: 77.2090,
    ayanamsa: 'lahiri',
  }),
});
const { data } = await r.json();
console.log(`Tithi: ${data.tithi.name}, Nakshatra: ${data.nakshatra.name}`);
console.log(`Rahu Kaal: ${data.rahuKaal.startTime} - ${data.rahuKaal.endTime}`);

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/panchang/full',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '2026-05-11', 'time': '06:00:00', 'timezoneOffset': 5.5,
        'latitude': 28.6139, 'longitude': 77.2090,
        'ayanamsa': 'lahiri',
    },
)
data = r.json()['data']
print(f"Tithi: {data['tithi']['name']}, Nakshatra: {data['nakshatra']['name']}")

Exemple de réponse

{
  "jd": 2461171.520833,
  "ayanamsa": 24.225277,
  "sunrise": "05:33:04",
  "sunset": "19:02:21",
  "tithi": {
    "number": 24,
    "name": "Navami",
    "paksha": "krishna",
    "indexInPaksha": 9,
    "elongation": 283.301369,
    "percentComplete": 0.608447
  },
  "vara": { "number": 1, "name": "Somavara", "ruler": "Moon" },
  "karana": { "index": 48, "name": "Garaja", "isFixed": false },
  "yoga": { "number": 2, "name": "Priti", "sumLongitude": 23.999794 },
  "nakshatra": {
    "number": 24,
    "name": "Shatabhisha",
    "ruler": "Rahu",
    "startDeg": 306.6667,
    "endDeg": 320,
    "pada": 1,
    "longitude": 309.423644
  },
  "rahuKaal": { "name": "Rahu Kaal", "weekdaySlot": 2, "startHour": 7.237123, "endHour": 8.923138, "startTime": "07:14:14", "endTime": "08:55:23" },
  "yamaganda": { "name": "Yamaganda", "weekdaySlot": 4, "startHour": 10.609153, "endHour": 12.295168, "startTime": "10:36:33", "endTime": "12:17:43" },
  "gulika": { "name": "Gulika", "weekdaySlot": 6, "startHour": 13.981183, "endHour": 15.667198, "startTime": "13:58:52", "endTime": "15:40:02" },
  "abhijitMuhurat": { "startHour": 11.845564, "endHour": 12.744772, "midHour": 12.295168, "muhurtaMinutes": 53.952481, "startTime": "11:50:44", "endTime": "12:44:41" }
}

Précision et sources

Texte canonique : Surya Siddhanta (pour tithi/karana/yoga), Brihat Samhita (pour choghadia/muhurta), Phaladipika (pour hora). Calculs de la Lune vraie via Swiss Ephemeris (DE441/440), pas de la Lune moyenne - c’est crucial pour les transitions tithi (la différence peut atteindre 3 heures).
Vérification de référence : drikpanchang.com - la plus grande source publique de panchang. Nos transitions tithi/nakshatra correspondent à drikpanchang dans une marge de ±30 secondes pour l’ayanamsa de Lahiri.
Choghadia : nous utilisons l’ordre classique des 7 régents planétaires. Le premier créneau de la journée = le régent du jour de la semaine (dimanche = Soleil, etc.).
Rahu Kaal : intervalles fixes de 1/8 du lever au coucher du Soleil, avec une correspondance jour de la semaine → numéro de créneau selon la tradition (lundi = 2ème, mardi = 7ème, etc.).
Le point d’observation est important. Les nakshatra et tithi changent au même moment UTC partout - mais les dates visibles dépendent du fuseau horaire. Transmettez le timezoneOffset de l’endroit où l’utilisateur souhaite lire le panchang.

Lié

Dasha : périodes à long terme (années/décennies), le panchang concerne le court terme (jour par jour)
Shadbala : force des planètes au moment du panchang
Vargas : graphes divisionnels pour une analyse approfondie du muhurta
Précision : tests snapshot du panchang contre drikpanchang
Crédits : tableau complet des tarifs
Authentification : comment obtenir une clé aw_live_*

Utile?

Proposer une modification

Dernière mise à jour : 28 sept. 2026