API reference › Transits

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_of string (date-time) required
  • active boolean required
  • wars array of object required
    • planets array of string required

      exactly 2 items

    • orb_deg number required

      ≥ 0 · ≤ 1.5

    • status string required

      one of active, forming

    • sign string required
    • winner string required
    • loser string required
    • until string (date-time) or null required

      One of:

      1. string (date-time)
      2. null
    • summary string required

      One 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

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

More in Transits

Get a free API key Transits product page