Swiss Ephemeris API

Swiss Ephemeris - ज्योतिष में खगोलीय गणनाओं का डि‑फ़ैक्टो मानक है: यह Astrodienst (astro.com), Solar Fire, Kerykeion और अधिकांश गंभीर सॉफ़्टवेयर द्वारा उपयोग किया जाता है। यह NASA JPL के DE431 इफ़ेमेरिड पढ़ता है और सब‑सेकंड सटीकता देता है। AstroWay API इसे सीधे HTTP के माध्यम से उपलब्ध कराता है - बिना C‑लाइब्रेरी को कंपाइल किए, बिना .se1 फ़ाइलें डाउनलोड किए, बिना मेमोरी प्रबंधन के। एक POST‑रिक्वेस्ट, JSON उत्तर।

Swiss Ephemeris को API के माध्यम से क्यों उपयोग करें

Self‑host Swiss Ephemeris का मतलब है: C‑लाइब्रेरी (या WASM‑बिल्ड) इकट्ठा करना, सैकड़ों मेगाबाइट .se1 फ़ाइलें रख‑रखाव करना, उन्हें अपडेट रखना और खुद घर के कुस्पिड, पहलू, चरणों को लागू करना। API के ज़रिए यह सब – दूसरों का झंझट:

• शून्य इन्फ्रास्ट्रक्चर: कोई बाइनरी, इफ़ेमेरिड फ़ाइलें या कोल्ड‑स्टार्ट देरी नहीं। गणना सर्वर‑साइड उसी इंजन पर चलती है जो Astrodienst उपयोग करता है।
• सब‑सेकंड सटीकता: < 0.1″ बनाम मानक swetest CGI Astrodienst से, 873 फ्रीज़्ड स्नैपशॉट‑टेस्ट पर हर डिप्लॉय पर सत्यापित।
• पूरा डेट रेंज: DE431 13201 BCE – 17191 CE को कवर करता है, इसलिए ऐतिहासिक और दूर भविष्य के चार्ट बिना सटीकता खोए गणना किए जा सकते हैं।
• केवल पोजिशन नहीं: इफ़ेमेरिड के साथ ही घर के कुस्पिड (15 सिस्टम), पहलू, ग्रहण, ट्रांज़िट, प्रोग्रेशन – वह सब जो self‑host पर तुझे खुद लिखना पड़ता।

संकेत

इंजन की सटीकता को तीन स्वतंत्र स्रोतों (swetest CGI, Kerykeion, Prokerala) और NASA 5‑Millennium Eclipse Catalog के खिलाफ त्रिकोणीय किया गया है। विवरण और आँकड़े पृष्ठ पर देखें गणनाओं की सटीकता।

Swiss Ephemeris पर क्या गणना होती है

एंडपॉइंट	क्रेडिट	क्या लौटाता है
/v1/chart	20	पूरा चार्ट: ग्रह + घर + पहलू
/v1/planets	10	जियोसेंटरिक ग्रह स्थितियाँ (देशांतर, अक्षांश, वेग, रेट्रोग्रेड)
/v1/houses	10	घर के कुस्पिड - 15 सिस्टम (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	निर्दिष्ट तिथि पर नैटल चार्ट के लिए ट्रांज़िट्स
/v1/progressions	50	सेकेंडरी प्रोग्रेशन (एक दिन = एक साल)
/v1/eclipses	100	सौर और चंद्र ग्रहण (NASA कैटलॉग के विरुद्ध सत्यापित)
/v1/moon-phase	10	चंद्र चरण, प्रकाशमानता, अगले क्वार्टर
/v1/fixed-stars	20	स्थिर सितारों के साथ ग्रहों के संयोजन

यह 760 प्लेटफ़ॉर्म के एंडपॉइंट्स का हिस्सा है - पूरी सूची API दस्तावेज़ में देखें।

उदाहरण

cURL

curl -X POST https://api.astroway.info/v1/planets \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/planets', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});
const { data } = await r.json();
const sun = data.planets.find((p) => p.name === 'Sun');
console.log(`Sun: ${sun.longitude.toFixed(4)}° retrograde: ${sun.isRetrograde}`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/planets',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
data = r.json()['data']
sun = next(p for p in data['planets'] if p['name'] == 'Sun')
print(f"Sun: {sun['longitude']:.4f}° retrograde: {sun['isRetrograde']}")

कौन उपयोग करता है

• ज्योतिष एप्लिकेशन डेवलपर्स: बिना self‑host C‑लाइब्रेरी के सब‑सेकंड पोजिशन
• AI एजेंट: सटीक इफ़ेमेरिड LLM के लिए ग्राउंडिंग (MCP‑सर्वर के ज़रिए)
• शोधकर्ता: DE431 के ऐतिहासिक रेंज में बड़े पैमाने पर गणनाएँ
• self‑host से माइग्रेशन: लोकल swisseph को HTTP पर बदलना बिना सटीकता खोए

कीमत

ग्रह स्थितियाँ (/v1/planets) - 10 क्रेडिट, पूरा चार्ट (/v1/chart) - 20। फ्री टैरिफ पर (760+ एंडपॉइंट्स, 10 000 क्रेडिट/माह) - लगभग 1000 ग्रह क्वेरीज़ प्रति माह मुफ्त, बिना कार्ड के।

गणनाओं की सटीकता → त्रिकोणीय, NASA‑वैलिडेशन, स्नैपशॉट‑टेस्ट

तेज़ शुरुआत 5 मिनट में पहला अनुरोध

टैरिफ फ्री से एंटरप्राइज़ तक