Graha Yuddha (Planetary War) API
Graha yuddha (planetary war) now: Mercury, Venus, Mars, Jupiter and Saturn within 1.5°
GET/v1/transits/graha-yuddha
1 credit · Secret or publishable key · getGrahaYuddha
Computed for the moment of the call (as_of). Within 1° is an active war, 1–1.5° forming; the brighter planet wins (Jupiter, Venus, Mercury, Saturn, Mars in that order). until: when the pair is next more than 1.5° apart, to the minute, searched 60 days ahead (null past that).
Response
JSON { data, meta, warnings }, where data is:
as_ofstring (date-time) requiredactiveboolean requiredwarsarray of object requiredplanetsarray of string requiredexactly 2 items
orb_degnumber required≥ 0 · ≤ 1.5
statusstring requiredone of
active,formingsignstring requiredwinnerstring requiredloserstring requireduntilstring (date-time) or null requiredOne of:
- string (date-time)
- null
summarystring requiredOne sentence from the engine: the pair, the sign, who wins and who is weakened.
Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.
Example request
curl 'https://api.astrologics.in/v1/transits/graha-yuddha' \
-H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/transits/graha-yuddha", {
headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));Python
import json
import urllib.error
import urllib.request
req = urllib.request.Request(
"https://api.astrologics.in/v1/transits/graha-yuddha",
method="GET",
headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
try:
with urllib.request.urlopen(req) as res:
print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
print(err.code, err.read().decode())PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/transits/graha-yuddha');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;Example response
200 OK · 311 characters
{
"data": {
"as_of": "2026-11-03T02:15:50.774Z",
"active": false,
"wars": []
},
"meta": {
"request_id": "req_example",
"api_version": "v1",
"engine_version": "2026.10.10",
"mode": "live",
"credits_charged": 1,
"as_of": "2026-11-03T02:15:50.774Z"
},
"warnings": []
}Try it
More in Transits
- Planetary Events API (Retrogrades, Eclipses): Planetary events: sign changes, retrograde stations and eclipses, with IST times
- Planet Ingress and Station API: Ingresses, stations and combustion between dates
- Gochar (Natal Transits) API: Transits over the natal Moon and houses
- Exact Aspect Dates API: Exact conjunctions, sextiles, squares, trines and oppositions over a range
- Declination Parallels API: Exact parallels and contra-parallels of declination over a range