# Vedic Astrology API

> Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers. Hosted MCP server, no local setup, connect Claude Code, Cursor, VS Code, Windsurf in seconds. Calculations verified against NASA JPL Horizons with sub-arcminute accuracy. Birth charts with 15 divisional charts (D1-D60), Ashtakoot Gun Milan compatibility, Vimshottari Dasha predictions, dosha detection with remedies, 300+ planetary yogas, complete Panchang, and KP horary with 249-level sub-lord analysis. 40+ endpoints optimized for matrimonial apps, horoscope platforms, spiritual wellness services, and AI-powered astrology chatbots.

Launch your Jyotish or KP astrology product in days. Not months.

- Product page: https://roxyapi.com/products/vedic-astrology-api
- OpenAPI spec: https://roxyapi.com/api/v2/vedic-astrology/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/vedic-astrology
- Authentication: `X-API-Key` header on every request
- Pricing: https://roxyapi.com/pricing (all domains included in every plan)

## Stats

- latency: <50ms
- uptime: 99.9%
- endpoints: 40+

## Features

- Traditional Vedic birth charts with 15 divisional charts (D1 Rashi through D60 Shashtiamsa) covering all 9 grahas, 12 houses, Lagna, and Nakshatra pada - perfect for kundli generation and horoscope apps
- Ashtakoot Gun Milan 36-point compatibility system with 8-category breakdown (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi) and classical dosha cancellation analysis (Muhurta Martanda for Nadi, BPHS for Bhakoot) - essential for matrimonial matchmaking platforms
- Vimshottari Dasha system with 120-year Mahadasha timeline, Antardasha sub-periods, and Pratyantardasha precision - enables lifetime event prediction and timing analysis
- KP (Krishnamurti Paddhati) astrology with dynamic KP-Newcomb ayanamsa, 249-level star-lord and sub-lord system, Placidus house cusps - unique for horary predictions and event timing
- Dosha detection (Manglik, Kalsarpa, Sadhesati) with severity analysis, formation conditions, traditional remedies (mantras, donations, rituals), and life impact assessment
- Complete Panchang data (Tithi, Nakshatra, Yoga, Karana) for Hindu calendar integration, festival dates, muhurat selection, and auspicious timing in spiritual apps
- 300+ planetary yogas database (Raja, Dhana, Gaja Kesari combinations) with formation conditions, life results, and quality ratings - detect wealth and success patterns
- Detect 12 classical Vedic yogas including Gajakesari (parashara three-rule definition), Budha-Aditya, Chandra Mangala, and the five Pancha Mahapurusha yogas (Ruchaka, Bhadra, Hamsa, Malavya, Sasa) with present/absent verdicts and classical-text evidence sourced from BPHS, Phaladeepika, and B.V. Raman
- Detailed planetary positions with sidereal longitude, Rashi sign, Nakshatra (1-27) and its Vimshottari lord, Pada (1-4), whole-sign Bhava (house) placement, Baladi avastha (planetary age-state), and retrograde status - foundation for all calculations
- All 15 BPHS divisional charts (D2 Hora, D3 Drekkana, D10 Dasamsa, D60 Shashtiamsa, etc.) for career, children, wealth, spirituality, and past-life karma analysis
- KP horary astrology endpoints with significator analysis, cusp sub-lords, and ruling planet calculations - answer yes/no questions with precision timing
- Sub-arcminute astronomical accuracy verified against NASA JPL Horizons for professional-grade Vedic calculations trusted by serious astrologers and kundli platforms
- AI-optimized JSON responses with structured data, keywords, and interpretations - perfect for chatbot integration, LLM consumption, and automated report generation
- Multi-language responses in 8 languages (EN, TR, DE, ES, HI, PT, FR, RU) via ?lang= query parameter

## Use Cases

- Matrimonial matchmaking platforms - automate Gun Milan compatibility scoring, Manglik dosha checks, Navamsa spouse analysis, and generate match reports with remedies for Shaadi.com-style features
- Daily horoscope and prediction apps - fetch planetary transits, current Dasha periods, Panchang data, and birth star forecasts to power AstroSage/Astrotalk-style daily readings
- Kundli generation and PDF report services - combine D1/D9 charts, planetary positions, Dasha timelines, yoga detection, and dosha analysis into automated birth chart reports
- KP horary and event prediction apps - build stellar astrology software with significator analysis, cusp sub-lords, and 249-level precision for answering when/yes-no questions
- Spiritual wellness and calendar apps - integrate Panchang for Hindu festival dates, fasting calendars, temple muhurat selection, and Nakshatra-based meditation schedules
- AI astrology chatbots and virtual consultants - power conversational AI with structured Vedic calculations, compatibility queries, Dasha predictions, and remedy suggestions via ChatGPT plugins or MCP integration

## Endpoints

- `POST /api/v2/vedic-astrology/birth-chart` Get birth chart (D1 Rashi chart) - Kundli Calculator API
- `POST /api/v2/vedic-astrology/navamsa` Get Navamsa chart (D9) - Marriage Compatibility Calculator
- `POST /api/v2/vedic-astrology/divisional-chart` Get divisional chart (Varga) - D2 to D60 Calculator
- `POST /api/v2/vedic-astrology/compatibility` Calculate compatibility score - Gun Milan API (Ashtakoot Matching)
- `POST /api/v2/vedic-astrology/planetary-positions` Get planetary positions - Graha Positions API
- `POST /api/v2/vedic-astrology/planetary-positions/monthly` Monthly Ephemeris - Daily sidereal planetary positions for a month
- `POST /api/v2/vedic-astrology/dasha/current` Get current Mahadasha, Antardasha, Pratyantardasha - Dasha Calculator API
- `POST /api/v2/vedic-astrology/dasha/major` Get all 9 Mahadasha periods (120-year cycle)
- `POST /api/v2/vedic-astrology/dasha/sub/{mahadasha}` Get all Antardashas (sub-periods) for a specific Mahadasha
- `POST /api/v2/vedic-astrology/panchang/basic` Get basic Panchang - Tithi Nakshatra Yoga Karana Calculator
- `POST /api/v2/vedic-astrology/panchang/detailed` Get detailed Panchang with Rahu Kaal, Yamaganda, Gulika
- `POST /api/v2/vedic-astrology/panchang/choghadiya` Get Choghadiya - 8 Muhurta divisions of day and night
- `POST /api/v2/vedic-astrology/panchang/hora` Get Hora - 24 Planetary Hours (12 day + 12 night)
- `POST /api/v2/vedic-astrology/dosha/manglik` Check Manglik Dosha - Mangal Dosha Calculator API
- `POST /api/v2/vedic-astrology/dosha/kalsarpa` Check Kalsarpa Dosha - Kalsarpa Yoga Calculator API
- `POST /api/v2/vedic-astrology/dosha/sadhesati` Check Sadhesati - Sade Sati Calculator API (Saturn Transit)
- `GET /api/v2/vedic-astrology/yoga` List all planetary yogas - 300+ Vedic Yoga Glossary
- `GET /api/v2/vedic-astrology/yoga/{id}` Get yoga details by ID - Vedic Yoga Glossary Entry
- `POST /api/v2/vedic-astrology/yoga/detect` Detect classical Vedic yogas in a birth chart
- `GET /api/v2/vedic-astrology/kp/ayanamsa` Get KP-Newcomb ayanamsa - Dynamic daily calculation
- `POST /api/v2/vedic-astrology/kp/planets` Get KP planetary positions with sub-lords
- `POST /api/v2/vedic-astrology/kp/cusps` Get KP Placidus house cusps with sub-lords
- `POST /api/v2/vedic-astrology/kp/chart` Generate complete KP birth chart
- `POST /api/v2/vedic-astrology/kp/ruling-planets` Get KP ruling planets with optional significators
- `POST /api/v2/vedic-astrology/kp/ruling-planets-interval` Get KP ruling planets with significators at intervals
- `POST /api/v2/vedic-astrology/kp/sublord-changes` Find KP sublord changes
- `POST /api/v2/vedic-astrology/kp/rasi-changes` Find KP rasi ingress times
- `POST /api/v2/vedic-astrology/kp/planets-interval` Get KP planets at time intervals
- `POST /api/v2/vedic-astrology/aspects` Get planetary aspects (Drishti) - Mutual aspects between all planets
- `POST /api/v2/vedic-astrology/aspects/monthly` Monthly Planetary Aspects - Major and minor aspect events for a month
- `POST /api/v2/vedic-astrology/aspects/lunar` Monthly Lunar Aspects - Moon aspect events with all planets for a month
- `POST /api/v2/vedic-astrology/transit` Transit Analysis - Compare current planets to natal chart (Gochar)
- `POST /api/v2/vedic-astrology/transit/monthly` Monthly Transit - Planetary sign changes for an entire month
- `POST /api/v2/vedic-astrology/parallels` Declination Parallels - Planets at same or opposite declination
- `POST /api/v2/vedic-astrology/parallels/monthly` Monthly Declination Parallels - Parallel and contraparallel events for a month
- `POST /api/v2/vedic-astrology/ecliptic-crossings` Ecliptic Crossings - When planets cross the ecliptic plane
- `GET /api/v2/vedic-astrology/rashis` List all 12 Rashis - Vedic Zodiac Signs Reference
- `GET /api/v2/vedic-astrology/rashis/{id}` Get Rashi by ID - Vedic Zodiac Sign Detail
- `GET /api/v2/vedic-astrology/nakshatras` List all 27 Nakshatras - Lunar Mansions Reference
- `GET /api/v2/vedic-astrology/nakshatras/{id}` Get Nakshatra by ID - Lunar Mansion Detail
- `POST /api/v2/vedic-astrology/upagraha` Get upagraha (sub-planet) positions - Upagraha Calculator API
- `POST /api/v2/vedic-astrology/ashtakavarga` Get Ashtakavarga (planetary strength) analysis - Ashtakavarga Calculator API
- `POST /api/v2/vedic-astrology/shadbala` Get Shadbala (six-fold planetary strength) analysis - Shadbala Calculator API

### Vedic Astrology (`/vedic-astrology/`)
- `POST /vedic-astrology/birth-chart` — Kundli with twelve rashi houses, planet placements, interpretations.
- `POST /vedic-astrology/panchang/detailed` — Daily panchang with rahu kaal, muhurtas, gulika, chandrabalam, tarabalam.
- `POST /vedic-astrology/panchang/basic` — Tithi, nakshatra, yoga, karana.
- `POST /vedic-astrology/panchang/choghadiya` — Eight day and eight night electional periods.
- `POST /vedic-astrology/dasha/current` — Current Mahadasha, Antardasha, Pratyantardasha.
- `POST /vedic-astrology/dasha/major` — Full 120-year Vimshottari timeline.
- `POST /vedic-astrology/dosha/manglik` — Mangal Dosha check.
- `POST /vedic-astrology/dosha/kalsarpa` — Kaal Sarp Dosha check.
- `POST /vedic-astrology/dosha/sadhesati` — Sade Sati (Saturn transit) check.
- `POST /vedic-astrology/compatibility` — Guna Milan (36-point Ashtakoota matching).
- `POST /vedic-astrology/navamsa` — D9 chart.
- `POST /vedic-astrology/kp/chart` — KP chart with cusps, planets, sub-lords.
- `POST /vedic-astrology/kp/planets` — KP planets with sub-lord and sub-sub-lord.
- `POST /vedic-astrology/kp/ruling-planets` — KP ruling planets for horary.
- `GET /vedic-astrology/nakshatras/{id}` — Single nakshatra detail (e.g. `ashwini`, `pushya`).

## Example Response

```
POST /api/v2/vedic-astrology/birth-chart
```

```json
{
  "aries": {
    "rashi": "aries",
    "signs": [
      {
        "graha": "Mars",
        "nakshatra": {
          "anga": "nakshatra",
          "key": 0,
          "ratio": 0.6084462817181034,
          "abhijit": false,
          "left": 5.220716243758622,
          "name": "Ashwini",
          "pada": 3,
          "lord": "Ketu"
        },
        "longitude": 8.112617089574712,
        "isRetrograde": false,
        "house": 7,
        "awastha": "Kumara"
      }
    ]
  },
  "taurus": {
    "rashi": "taurus",
    "signs": []
  },
  "gemini": {
    "rashi": "gemini",
    "signs": [
      {
        "graha": "Sun",
        "nakshatra": {
          "anga": "nakshatra",
          "key": 6,
          "ratio": 0.6653308645648619,
          "abhijit": false,
          "left": 4.462255139135175,
          "name": "Punarvasu",
          "pada": 3,
          "lord": "Jupiter"
        },
        "longitude": 88.87107819419816,
        "isRetrograde": false,
        "house": 9,
        "awastha": "Mrita"
      },
      {
        "graha": "Jupiter",
        "nakshatra": {
          "anga": "nakshatra",
          "key": 6,
          "ratio": 0.659873958900732,
          "abhijit": false,
          "left": 4.535013881323573,
          "name": "Punarvasu",
          "pada": 3,
          "lord": "Jupiter"
        },
        "longitude": 88.79831945200976,
        "isRetrograde": false,
        "house": 9,
        "awastha": "Mrita"
      },
      {
        "graha": "Venus",
        "nakshatra": {
          "anga": "nakshatra",
          "key": 4,
          "ratio": 0.5374660882820433,
          "abhijit": false,
          "left": 6.1671188229060885,
          "name": "Mrigashira",
          "pada": 3,
          "lord": "Mars"
        },
        "longitude": 60.49954784376058,
        "isRetrograde": false,
        "house": 9,
        "awastha": "Bala"
      }
    ]
  },
  "cancer": {
    "rashi": "cancer",
    "signs": [
      {
        "graha": "Mercury",
        "nakshatra": {
          "anga": "nakshatra",
          "key": 7,
          "ratio": 0.7064297901973472,
          "abhijit": false,
          "left": 3.914269464035371,
          "name": "Pushya",
          "pada": 3,
          "lord": "Saturn"
        },
        "longitude": 102.7523972026313,
        "isRetrograde": false,
        "house": 10,
        "awastha": "Yuva"
      },
      {
        "graha": "Ketu",
        "nakshatra": {
          "anga": "nakshatra",
          "key": 7,
          "ratio": 0.8294607482465945,
          "abhijit": false,
          "left": 2.273856690045406,
          "name": "Pushya",
          "pada": 4,
          "lord": "Saturn"
        },
        "longitude": 104.39280997662127,
        "isRetrograde": true,
        "house": 10,
        "awastha": "Yuva"
      }
    ]
  },
  "meta": {
    "Sun": {
      "graha": "Sun",
      "rashi": "Gemini",
      "longitude": 88.87107819419816,
      "latitude": -0.00002368790368325322,
      "nakshatra": {
        "anga": "nakshatra",
        "key": 6,
        "ratio": 0.6653308645648619,
        "abhijit": false,
        "left": 4.462255139135175,
        "name": "Punarvasu",
        "pada": 3,
        "lord": "Jupiter"
      },
      "isRetrograde": false,
      "house": 9,
      "awastha": "Mrita"
    },
    "Moon": {
      "graha": "Moon",
      "rashi": "Pisces",
      "longitude": 357.1990842245454,
      "latitude": 5.051966130644166,
      "nakshatra": {
        "anga": "nakshatra",
        "key": 26,
        "ratio": 0.7899313168409082,
        "abhijit": false,
        "left": 2.8009157754545573,
        "name": "Revati",
        "pada": 4,
        "lord": "Mercury"
      },
      "isRetrograde": false,
      "house": 6,
      "awastha": "Bala"
    },
    "Lagna": {
      "graha": "Lagna",
      "rashi": "Libra",
      "longitude": 189.83918984533227,
      "nakshatra": {
        "anga": "nakshatra",
        "key": 14,
        "ratio": 0.2379392383999197,
        "abhijit": false,
        "left": 10.160810154667738,
        "name": "Swati",
        "pada": 1,
        "lord": "Rahu"
      },
      "isRetrograde": false,
      "house": 1,
      "awastha": "Kumara"
    }
  },
  "houses": [
    {
      "number": 1,
      "name": "Lagna",
      "description": "The lagna, or ascendant, is the single most important indicator in Vedic astrology of the charts potential. The Lagna, which is the first house, represents the self, body and personality. We find important clues about a person by examining both the sign that the first house is placed in and the planet that rules the sign. The planet that rules the first house, often referred to as the Lagna Lord, is of paramount importance. A strong Lagna Lord is essential in fulfilling the potential in a chart. A strong Lagna and Lagna Lord can also help us deal with potential difficulties existing in a chart."
    },
    {
      "number": 2,
      "name": "Dhana Bhava",
      "description": "Dhana means wealth and the second house represents acquisition and finances. This house can reveal inheritance and acquisition of metals, and gems. The second house also indicates our values; both material and spiritual. Dhana Bhava also shows family relationships and our extended family. The second house reveals past life connections, particularly within the family. The second house also rules the face, including the chin, mouth, teeth and tongue. It governs what goes into the mouth which means it rules over the quality of the food we eat. The second house also rules what comes out of the mouth, which means it governs our speech and can indicate whether or not we are truthful. Eyesight and vision also belongs to Dhana Bhava."
    },
    {
      "number": 3,
      "name": "Bhatru Bhava",
      "description": "The third house shows individual self expression and the effort we put out to accomplish things. This house can reveal talents in writing, music, acting and painting - any form of creative expression. The third house also reveals our courage, hobbies and passions. This is a house of communication and also governs short journeys. Research, lecturing and sales fall under the third house's domain. The third house also represents our brothers and sisters and our relationship with them. It governs our immediate environment as well as our friends, colleagues and neighbors."
    }
  ],
  "combustion": [
    {
      "planet": "Mercury",
      "distanceFromSun": 13.88,
      "orb": 14
    },
    {
      "planet": "Jupiter",
      "distanceFromSun": 0.07,
      "orb": 11
    }
  ],
  "planetaryWar": [],
  "interpretations": {
    "Sun": {
      "rashi": "Sun in Gemini (Mithun) expresses through the energy of the Twins. Compassionate, value friendship and agreements, inclined towards working in groups, liberal, possess an inclusive view of world, intelligent",
      "nakshatra": "Sun in Punarvasu nakshatra combines planetary energy with Aditi (mother of gods) deity influence. These individuals are adaptive, hopeful, and known for their ability to renew themselves after setbacks. They bring optimism and resilience to challenging situations."
    },
    "Moon": {
      "rashi": "Moon in Pisces (Meen) expresses through the energy of the Fish. Calm, intelligent, creative, dreamer, risk taker, deceptive",
      "nakshatra": "Moon in Revati nakshatra combines planetary energy with Pushan deity influence. Revati individuals are nurturing, spiritual, and generous. They often guide others and protect those around them."
    }
  },
  "yogas": [
    {
      "id": "gajakesari",
      "name": "Gajakesari Yoga",
      "description": "Jupiter in kendra from Moon",
      "result": "Gajakesari Yoga hints that you may have a number of relatives in your life span. In terms of personality, you would be someone who is generous and cares about people in his/her vicinity. You are destined to accomplish development work as a higher authority like a magistrate. This Yoga ensures you a lasting reputation even long after death.",
      "quality": "Positive",
      "present": false,
      "evidence": "Jupiter in kendra from Moon, but aspected/joined by malefic: Saturn."
    },
    {
      "id": "sunapha",
      "name": "Sunapha Yoga",
      "description": "Any planets, except Sun, in the second house from the Moon.",
      "result": "Sunapha Yoga indicates that you will be the proud owner of several properties which will be earned by you through your perseverance and good decisions. You will be extremely rich and have the luxury of living the life of a king. When it comes to your personality, you are intelligent and rarely make bad decisions. Your reputation will be on par with that of a reputed ruler.",
      "quality": "Positive",
      "present": true,
      "evidence": "Non-luminary, non-node planet placed in the 2nd house from Moon."
    }
  ]
}
```

## SDK Quick Start

```typescript
// npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk';
const roxy = createRoxy(process.env.ROXY_API_KEY!);
const { data, error } = await roxy.vedicAstrology.generateBirthChart({ body: { date: '1990-06-15', time: '14:30:00', latitude: 28.6139, longitude: 77.2090, timezone: 'Asia/Kolkata' } });
```

```python
# pip install roxy-sdk
import os
from roxy_sdk import create_roxy
roxy = create_roxy(api_key=os.environ["ROXY_API_KEY"])
result = roxy.vedic_astrology.generate_birth_chart(date="1990-06-15", time="14:30:00", latitude=28.6139, longitude=77.209, timezone="Asia/Kolkata")
```

```php
// composer require roxyapi/sdk (PHP 8.2+, built on Saloon)
use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->vedicAstrology->generateBirthChart(date: '1990-06-15', time: '14:30:00', latitude: 28.6139, longitude: 77.2090, timezone: 'Asia/Kolkata');
```

Method names come from OpenAPI `operationId` (camelCase in TS and PHP, snake_case in Python). TS returns `{ data, error, response }` — check `error` first. Python raises `RoxyAPIError`; PHP throws `RoxyApiException` (catch and switch on `$e->errorCode`).

## MCP Tool Naming

Each REST endpoint has a matching MCP tool on `https://roxyapi.com/mcp/vedic-astrology`. Tool name convention is `{http_method_lowercase}_{path_with_slashes_as_underscores_kebab_replaced_with_underscores_braces_stripped}`:

```
POST /vedic-astrology/birth-chart             -> post_vedic_astrology_birth_chart
POST /vedic-astrology/navamsa                 -> post_vedic_astrology_navamsa
POST /vedic-astrology/divisional-chart        -> post_vedic_astrology_divisional_chart
```

`tools/list` is free and public (no auth). `tools/call` requires `X-API-Key` (same billing as REST — 1 request per call).

## Common Mistakes (verified from production)

LLMs frequently produce broken Vedic code. These are the correct patterns.

- Body is `{ date, time, latitude, longitude, timezone }` — NOT `{ year, month, day, hour }`.
- Manglik dosha response uses `present` (boolean). Not `isManglik`. Fields: `{ present, severity, description, exceptions, remedies, effects }`.
- Kalsarpa: `present` not `hasKalsarpaDosha`. Severity is `"Mild"` / `"Moderate"` / `"Severe"` — not `"None"` / `"Partial"` / `"Full"`.
- Guna Milan compatibility: field is `total` (not `total_score`), `maxScore` is always 36, breakdown items use `category` (not `name`).
- Dasha endpoints: `POST /dasha/major` (not `/dasha/complete`), `POST /dasha/sub/{mahadasha}` (not `/dasha/antardashas`).
- KP chart is `POST /kp/chart` (not `/kp/birth-chart`). KP ruling planets do NOT need `date` / `time` — they use `datetime` or default to now.
- Panchang detailed takes NO `time` field — only `date`, `latitude`, `longitude`, optional `timezone`.

## Domain Gotchas

LLMs hallucinate confidently in this category. These are the specific traps.

- **Ayanamsa is server-side in Vedic.** LLMs default to tropical / Western math. Vedic endpoints apply sidereal Lahiri ayanamsa server-side. KP endpoints accept `kp-newcomb` (default), `kp-old`, `lahiri`, or `custom`. Do not try to "correct" server output by subtracting ayanamsa in client code.
- **Tithi count is 30 (15 Shukla + 15 Krishna), not 2.** Older LLM training data conflates Purnima and Amavasya as single tithis. Our split is authoritative — there are 30 distinct tithis in a lunar month.
- **Rahu and Ketu are shadow points, not planets.** They do not appear in a real ephemeris. Endpoints accept `nodeType` of `mean` (default — smooth mean node, traditional Vedic) or `true` (osculating node with perturbation corrections) to select which calculation to use.
- **Nakshatra count is 27.** Abhijit is sometimes treated as a 28th in some schools, but this API uses the standard 27.
- **KP planet lists use `retrograde`, not `isRetrograde`.** Stay consistent with the field on the chart endpoint you actually called.

## Multi-language Support

Append `?lang=` to translated endpoints. Supported on this domain: `en, de, es, fr, hi, pt, ru, tr`. English is the default. The `lang` param is ignored on endpoints that have no translatable text.

## Error Contract

Success returns clean JSON, no wrapper. Errors return `{ "error": string, "code": string }`. Switch on `code` (stable):

- `validation_error` (400, returns `issues[]` with all field errors at once)
- `api_key_required` (401), `invalid_api_key` (401)
- `subscription_inactive` (403), `subscription_not_found` (404)
- `not_found` (404; PATH-routing 404s carry a fuzzy `suggestion` field)
- `rate_limit_exceeded` (429)
- `internal_error` (500)

Do not retry on 4xx. Do retry on 429 and 5xx with exponential backoff.

## Related Surfaces

- **Guide:** [Vedic integration guide](https://roxyapi.com/docs/guides/vedic-astrology.md)
- **Starter app:** [Vedic Astrology Kundli App](https://github.com/RoxyAPI/jyotish-vedic-astrology-app) — clone, add an API key, deploy.
- [Best Astrology APIs in 2026: Pricing, Features, and AI Integration Compared](https://roxyapi.com/blogs/best-astrology-apis-2026-developer-comparison.md)
- [Best Astrology APIs for Developers in 2026: Complete Comparison Guide](https://roxyapi.com/blogs/best-astrology-apis-developers-2026.md)
- [RoxyAPI for Advanced Use Cases: Simple Surface, Deep Control](https://roxyapi.com/blogs/roxyapi-advanced-use-cases.md)
- [Is It Hard to Build Your Own Astrology API?](https://roxyapi.com/blogs/is-it-hard-to-build-your-own-astrology-api.md)

## Full Reference

For complete request and response schemas, fetch the OpenAPI spec at https://roxyapi.com/api/v2/vedic-astrology/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt. Execution playbook at https://roxyapi.com/AGENTS.md.