नैटल चार्ट

एंडपॉइंट POST /v1/chart - अधिकांश अनुरोधों की बुनियाद है। यह पूरी नेटल चार्ट लौटाता है: ग्रहों की स्थितियाँ, घरों के कुस्पिड, ग्रहों के बीच के पहलू, चार्ट का सेक्टर। कीमत: 20 क्रेडिट (Tier 2).

अनुरोध पैरामीटर

पैरामीटर	टाइप	अनिवार्य	विवरण
date	string	हाँ	जन्म तिथि YYYY-MM-DD
time	string	हाँ	जन्म समय HH:mm:ss या HH:mm (जैसे HH:mm:00 पढ़ा जाता है)
timezoneOffset	number	हाँ	UTC से घंटे में ऑफ़सेट (उदाहरण 2 किव के ग्रीष्मकाल में)
latitude	number	नहीं (0)	दशमलव डिग्री में अक्षांश
longitude	number	नहीं (0)	दशमलव डिग्री में देशांतर
houseSystem	string	नहीं (P)	घर प्रणाली: P Placidus, K Koch, W Whole Sign, E Equal और अन्य
name	string	नहीं	नाम (प्रतिक्रिया में लौटाया जाता है)
city	string	नहीं	शहर (प्रतिक्रिया में लौटाया जाता है)
zodiacType	string	नहीं	tropical (डिफ़ॉल्ट) या sidereal
cosmogram	boolean	नहीं	true - बिना घरों के (जब स्थान अज्ञात हो)

उदाहरण अनुरोध

किव के लिए नेटल चार्ट, 14 जुलाई 1990, 14:30:

cURL

curl -X POST https://api.astroway.info/v1/chart \
  -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,
    "houseSystem": "P"
  }'

Node.js

const res = await fetch('https://api.astroway.info/v1/chart', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  }),
});
const { data: chart } = await res.json();
console.log(chart.planets[0]); // Sun position

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/chart',
    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,
        'houseSystem': 'P',
    },
)
chart = r.json()['data']
print(chart['planets'][0])  # Sun position

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('chart', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
        'houseSystem' => 'P',
    ],
]);

$chart = json_decode($r->getBody(), true)['data'];
print_r($chart['planets'][0]); // Sun position

उदाहरण प्रतिक्रिया

{
  "input": {
    "name": "",
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P",
    "city": "",
    "cosmogram": false
  },
  "julianDay": 2448086.979167,
  "siderealTime": 6.971672,
  "planets": [
    {
      "id": 0,
      "name": "Sun",
      "longitude": 111.77244,
      "latitude": 0.000162,
      "distance": 1.016462,
      "speedLong": 0.953753,
      "isRetrograde": false,
      "declination": 21.681363
    },
    {
      "id": 1,
      "name": "Moon",
      "longitude": 9.061363,
      "latitude": 4.639701,
      "distance": 0.002511,
      "speedLong": 13.770219,
      "isRetrograde": false,
      "declination": 7.854711
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [
      212.0953,
      239.7536,
      274.2018,
      312.6334,
      346.2069,
      12.1755,
      32.0953,
      59.7536,
      94.2018,
      132.6334,
      166.2069,
      192.1755
    ],
    "ascendant": 212.0953,
    "mc": 132.6334
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Jupiter",
      "type": {
        "name": "Conjunction",
        "angle": 0,
        "isMajor": true
      },
      "orb": 0.548,
      "isApplying": true
    }
  ],
  "chartSect": "diurnal"
}

टिप्पणी

प्रतिक्रिया दृश्यता के लिए संक्षिप्त की गई है। पूरी प्रतिक्रिया में 13 पिंड, 12 घर कुस्पिड और उनके बीच सभी पहलू शामिल हैं। प्रत्येक पिंड के name फ़ील्ड में Swiss Ephemeris का नाम होता है, न कि ज्योतिषीय: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (उत्तरी नोड, सच्चा), mean Apogee (लीलिथ, औसत), Chiron। दक्षिणी नोड अलग पिंड के रूप में नहीं लौटाया जाता: यह true Node प्लस 180° है।

अपने भाषा में नाम

?lang= जोड़ो, ताकि ग्रहों, राशियों और पहलुओं के नाम इस भाषा में अंग्रेज़ी पहचानकर्ताओं के साथ मिलकर मिलें, जो नहीं बदलते। 21 में से कोई भी भाषा काम करेगी, जैसे जर्मन:

curl -X POST "https://api.astroway.info/v1/chart?lang=de" \
  -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, "houseSystem": "P" }'

{
  "localized": {
    "planets": { "Sun": "Sonne", "Moon": "Mond", "Mercury": "Merkur" },
    "signs": { "cancer": "Krebs", "leo": "Löwe", "aries": "Widder" },
    "aspects": { "Conjunction": "Konjunktion", "Opposition": "Opposition" }
  }
}

बिना ?lang= के प्रतिक्रिया में localized ब्लॉक नहीं होगा।

हाउस सिस्टम

कोड	सिस्टम	टिप्पणी
P	Placidus	डिफ़ॉल्ट, सबसे लोकप्रिय
K	Koch	जर्मनी में लोकप्रिय
W	Whole Sign	क्लासिक एलिनिस्टिक
E	Equal	ASC से समान
R	Regiomontanus	होरर एस्ट्रोलॉजी
C	Campanus	स्पेशियल सिस्टम
T	Topocentric	पोलिच-पीज
B	Alcabitius	मध्ययुगीन परम्परा

15 सिस्टम की पूरी सूची API reference में है।

कॉसमोग्राम (जन्म स्थान नहीं)

अगर जन्म समय ज्ञात है, पर स्थान नहीं, तो "cosmogram": true भेजो। घर और ASC/MC नहीं गणना किए जाते, क्रेडिट वही (20) रहता है।

प्रतिक्रिया हेडर

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z
X-Request-Id: 8aec43e9bc749b37e998a489bbad1757

आगे

• सिनैस्ट्री: दो चार्ट की संगतता
• ट्रांज़िट्स: ट्रांज़िट ओवरले और इवेंट कैलेंडर
• Human Design: पूरी HD-चार्ट
• पूरा API reference: सभी 771 एंडपॉइंट्स