/v1/chart/graha-yuddha

Planetary war detection.

What this tells you

Graha Yuddha ("planetary war") occurs when two non-luminary planets (not Sun/Moon) are within 1° of each other. The brighter planet "wins" and retains full strength; the loser is severely weakened. This is a rare but significant weakening factor.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/chart/graha-yuddha?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "wars": [
    {
      "planets": ["Mars", "Saturn"],
      "separation_deg": 0.89,
      "winner": "Saturn",
      "loser":  "Mars",
      "criteria": "brighter"
    }
  ]
}

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
wars[]	array	List of active planetary wars (any two non-luminary planets within 1° of each other). example: `[…]`
wars[].planets	string[2]	The two planets involved. example: `["Mars", "Saturn"]`
wars[].separation_deg	number	Angular separation. <1° = war. example: `0.89`
wars[].winner	string	Winning planet — retains full power. example: `"Saturn"`
wars[].loser	string	Losing planet — significantly weakened for the duration of the war. example: `"Mars"`
wars[].criteria	string	Classical rule used: brighter magnitude wins; ties broken by northern latitude. example: `"brighter"`

Usage tips

How to use it

Rare event
Most charts have zero active wars. If `wars` is empty, just skip rendering.
Show as a strong warning
When a war exists, the loser's significations are unreliable. Highlight in the chart with a clear badge.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.