Multi-Region Infrastructure

curl https://api.vedika.io/health

curl https://api.vedika.io/health

How Sandbox Works

Just like Stripe's test mode, our Sandbox lets you build and test your complete integration without spending a dime. When you're ready to launch, simply switch the base URL to production.

Quick Start Example

curl -X POST https://api.vedika.io/sandbox/kundali/birth-chart \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-05-15T10:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  }'

{
  "success": true,
  "data": {
    "birth_details": { "date": "1990-05-15", "time": "10:30:00", "latitude": 28.6139, "longitude": 77.209 },
    "ascendant": { "sign": "Cancer", "degree": 15.23, "nakshatra": "Pushya", "pada": 2 },
    "planets": [
      { "name": "Sun", "sign": "Aries", "degree": 1.23, "house": 10, "nakshatra": "Ashwini", "isRetrograde": false }
    ],
    "houses": [{ "house": 1, "sign": "Cancer", "degree": 15.23 }],
    "yogas": ["Gaja Kesari Yoga", "Budha-Aditya Yoga"]
  },
  "billing": { "charged": 0, "currency": "USD", "balanceBefore": 100, "balanceAfter": 100, "endpoint": "Full Kundli", "category": "charts" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

Welcome to Vedika API

The Vedika API provides AI-powered Vedic astrology insights powered by our proprietary Vedika Intelligence Engine. With 100% feature coverage (140+ endpoints, 300+ yoga detection, 25 dosha types, 35 numerology systems, 60 divisional charts), you can build enterprise-grade astrology applications with 82% better accuracy than general-purpose AI models.

Base URL

Quick Start

1. Sign up for an account and get your API key
2. Include the API key in your request headers
3. Make your first API call
4. Handle the response in your application

API Key Authentication

All API requests must include your API key in the request headers. You can get your API key from the dashboard.

🤖 Core AI Endpoints (Working)

🌟 Vedika Advanced Features (100+ Available)

All advanced features are accessible through the main /api/v1/astrology/query endpoint. Simply ask your question, and Vedika's AI intelligence automatically selects the relevant calculations:

CALCULATIONS Birth Chart (62 Endpoints)

ANALYSIS Dosha Detection (25 Types)

YOGAS Yoga Analysis (300+ Yogas)

🔢 Numerology Suite (35 Endpoints)

💑 Compatibility Analysis

⏰ Muhurtha & Auspicious Timing

💪 Planetary Strength Analysis

🌐 Western Astrology

Generate a complete Vedic birth chart with all planetary positions, houses, and divisional charts. All 60 divisional charts (Vargas) available - from D1 (Rashi) to D60 (Shashtiamsa).

Request Body

{
  "birthDetails": {
    "datetime": "1990-01-15T14:30:00",  // ISO datetime
    "latitude": 19.0760,                 // Decimal degrees
    "longitude": 72.8777,                // Decimal degrees
    "timezone": "+05:30"                  // UTC offset (+HH:MM)
  },
  "chartType": "D1",              // D1-D60 (all 60 vargas available)
  "ayanamsa": "Lahiri",           // Lahiri, Raman, KP
  "language": "en"                // en, hi, es, etc.
}

Response

{
  "success": true,
  "data": {
    "chart": {
      "ascendant": "Leo",
      "moon_sign": "Scorpio",
      "sun_sign": "Capricorn",
      "nakshatra": "Anuradha",
      "pada": 2,
      "planets": {
        "sun": { "sign": "Capricorn", "degree": "0°45'", "house": 6, "nakshatra": "Uttara Ashadha" },
        "moon": { "sign": "Scorpio", "degree": "15°23'", "house": 4, "nakshatra": "Anuradha" },
        "mars": { "sign": "Gemini", "degree": "22°11'", "house": 11, "nakshatra": "Punarvasu" },
        // ... other planets with nakshatra positions
      },
      "houses": {
        "1": { "sign": "Leo", "degree": "12°30'" },
        "2": { "sign": "Virgo", "degree": "11°45'" },
        // ... other houses
      },
      "aspects": [
        { "planet1": "Sun", "planet2": "Mars", "aspect": "Trine", "degree": 120 }
      ],
      "yogas_detected": [
        "Gaja Kesari Yoga - Moon & Jupiter in mutual kendras",
        "Budhaditya Yoga - Sun & Mercury conjunction"
      ]
    },
    "interpretation": {
      "personality": "Strong leadership qualities with Leo ascendant...",
      "strengths": ["Natural leader", "Creative", "Confident"],
      "challenges": ["Can be stubborn", "Need for attention"]
    },
    "credits_used": 2
  }
}

📊 Complete Response Metadata Schema

Every API response includes comprehensive metadata about processing, token usage, and billing:

{
  "success": true,
  "response": "Based on your birth chart analysis...",

  "metadata": {
    // Processing Info
    "model": "vedika-orchestrator",           // or "vedika-greeting" for simple greetings
    "processing_time_ms": 28543,               // Total processing time
    "stagesCompleted": 7,                      // Processing stages completed
    "engine": "vedika-intelligence",

    // Token Usage (detailed breakdown)
    "usage": {
      "input_tokens": 15234,                   // Tokens sent to AI models
      "output_tokens": 892,                    // Tokens generated by AI
      "cached_tokens": 12500,                  // Cached tokens (90% cheaper)
      "total_tokens": 16126                    // Total tokens used
    },

    // Cost Breakdown (transparent pricing)
    "cost": {
      "total_usd": 0.0052,                     // Total cost in USD
      "currency": "USD"                        // Always USD
    },

    // Wallet Balance (before/after transaction)
    "wallet": {
      "balance_before": 10.50,                 // Wallet balance before query
      "deducted": 0.0052,                      // Amount charged for this query
      "balance_after": 10.4948,                // Remaining balance
      "currency": "USD"
    },

    // Processing Details
    "processingStrategy": "parallel"            // Optional - "parallel" | "sequential"
  },

  "birthChart": {                              // Optional - full birth chart data
    "planets": [...],
    "houses": [...],
    "yogas": [...],
    "doshas": [...]
  }
}

🌊 Real-Time Streaming Endpoint (SSE)

Perfect for mobile apps: Show users live progress instead of a loading spinner!

Event Types:

• started - SSE connection established
• stage_started - New processing stage begun
• model_assigned - Model selected for task
• progress - Progress update with percentage
• stage_completed - Stage finished with results
• completed - Final answer ready
• billing_completed - Wallet charged, balance updated
• billing_error - Billing failed (query completed but not charged)

JavaScript Example:

const eventSource = new EventSource(
  'https://api.vedika.io/api/v1/astrology/query/stream?' +
  new URLSearchParams({
    question: "What is my lucky number?",
    birthDetails: JSON.stringify({
      datetime: "1990-06-15T14:30:00+05:30",
      latitude: 28.6139,
      longitude: 77.2090,
      timezone: "+05:30"
    }),
    language: "en"
  }),
  {
    headers: {
      'x-api-key': 'vk_live_your_key_here'
    }
  }
);

eventSource.addEventListener('progress', (e) => {
  const data = JSON.parse(e.data);
  console.log(`Stage ${data.stage}: ${data.progress}%`);
  // Update your progress UI
});

eventSource.addEventListener('completed', (e) => {
  const data = JSON.parse(e.data);
  console.log('Answer:', data.answer);
  // Display the answer
  eventSource.close();
});

eventSource.addEventListener('billing_completed', (e) => {
  const data = JSON.parse(e.data);
  console.log(`Charged: $${data.charged}, Balance: $${data.balance_after}`);
});

White-Label Parameters (Enterprise):

POST Streaming Example (fetch API):

// POST streaming for white-label apps
async function streamWithWhiteLabel() {
  const response = await fetch('https://api.vedika.io/api/v1/astrology/query/stream', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'vk_live_your_key_here'
    },
    body: JSON.stringify({
      question: "What is my lucky number?",
      birthDetails: {
        datetime: "1990-06-15T14:30:00+05:30",
        latitude: 28.6139,
        longitude: 77.2090,
        timezone: "+05:30"
      },
      language: "en",
      // White-label parameters (Enterprise)
      systemPrompt: "You are CareerCoach, a professional career astrologer.",
      assistantName: "CareerCoach",
      signOff: "Best of luck - CareerCoach"
    })
  });

  const reader = response.body.getReader();
  const decoder = new TextDecoder();
  let buffer = '';

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    buffer += decoder.decode(value, { stream: true });
    const lines = buffer.split('\n');
    buffer = lines.pop(); // Keep incomplete line

    for (const line of lines) {
      if (line.startsWith('data: ')) {
        const data = JSON.parse(line.slice(6));
        console.log('Event:', data);

        if (data.type === 'completed') {
          console.log('Answer:', data.answer);
          // Answer will use your custom signOff!
        }
      }
    }
  }
}

streamWithWhiteLabel();

📱 Mobile App Integration Best Practices

// React Native example
const response = await fetch(url, {
  timeout: 90000  // 90 second timeout
});

// On app launch or authentication
useEffect(() => {
  // Prefetch ONE query to warm up service
  const warmUp = async () => {
    await fetchVedikaQuery("What is my lucky number today?");
  };
  warmUp();
}, []);

// Use a queue for multiple questions
const questionQueue = [];
const processQueue = async () => {
  while (questionQueue.length > 0) {
    const question = questionQueue.shift();
    await fetchVedikaQuery(question);
  }
};

const fetchWithRetry = async (url, options, maxRetries = 3) => {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);

      if (response.status === 402) {
        // Payment required - direct to top-up
        navigateToWalletTopUp();
        return null;
      }

      if (response.status === 500 && i < maxRetries - 1) {
        // Server error - retry with exponential backoff
        await sleep(Math.pow(2, i) * 1000);
        continue;
      }

      return response.json();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
};

// First query — get a conversationId back
const res1 = await fetch("https://api.vedika.io/api/v1/astrology/query", {
  method: "POST",
  headers: { "Content-Type": "application/json", "x-api-key": API_KEY },
  body: JSON.stringify({ question: "Tell me about my career", birthDetails })
});
const data1 = await res1.json();
const convId = data1.conversationId;

// Follow-up — include conversationId
const res2 = await fetch("https://api.vedika.io/api/v1/astrology/query", {
  method: "POST",
  headers: { "Content-Type": "application/json", "x-api-key": API_KEY },
  body: JSON.stringify({
    question: "What about next year?",
    birthDetails,
    conversationId: convId
  })
});

API Capabilities

Match Compatibility

Request Body

{
  "person1": {
    "dateOfBirth": "1990-01-15",
    "timeOfBirth": "10:30",
    "placeOfBirth": "New York, USA"
  },
  "person2": {
    "dateOfBirth": "1992-05-20",
    "timeOfBirth": "14:45",
    "placeOfBirth": "Los Angeles, USA"
  },
  "analysisType": "comprehensive"
}

Response

{
  "success": true,
  "data": {
    "overall_score": 75,
    "ashtakoota": {
      "total_points": 24,
      "out_of": 36,
      "categories": {
        "varna": { "points": 1, "max": 1, "interpretation": "Good social compatibility" },
        "vashya": { "points": 2, "max": 2, "interpretation": "Mutual attraction present" },
        "tara": { "points": 3, "max": 3, "interpretation": "Health compatibility excellent" },
        "yoni": { "points": 3, "max": 4, "interpretation": "Physical compatibility good" },
        "graha_maitri": { "points": 4, "max": 5, "interpretation": "Mental compatibility strong" },
        "gana": { "points": 4, "max": 6, "interpretation": "Temperament mostly compatible" },
        "bhakoot": { "points": 5, "max": 7, "interpretation": "Family welfare favorable" },
        "nadi": { "points": 2, "max": 8, "interpretation": "Health of progeny - needs attention" }
      }
    },
    "kerala_system": {
      "total_points": 7.5,
      "out_of": 10,
      "compatibility": "Good match"
    },
    "tamil_system": {
      "porutham_count": 8,
      "out_of": 10,
      "compatibility": "Very Good"
    },
    "papasamyam": {
      "person1_papa": 4,
      "person2_papa": 3,
      "balance": "Acceptable - slight imbalance",
      "remedies_needed": false
    },
    "doshas": {
      "manglik_dosha": {
        "person1": false,
        "person2": true,
        "compatibility_impact": "Minor - remedies recommended"
      },
      "kaal_sarp_dosha": {
        "person1": false,
        "person2": false
      }
    },
    "recommendations": [
      "Strong mental compatibility - excellent foundation",
      "Good financial prosperity together",
      "Minor manglik dosha can be resolved with simple remedies",
      "Nadi dosha present - perform Nadi Nivarana puja before marriage"
    ]
  }
}

Daily Predictions with Yoga & Dosha Analysis

Request Body

{
  "birthDetails": {
    "datetime": "1990-01-15T10:30:00",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "timezone": "-05:00"
  },
  "prediction_date": "2026-01-20", // Optional, defaults to today
  "categories": ["career", "love", "health", "finance"], // Optional
  "include_yogas": true,  // Detect 300+ yogas
  "include_doshas": true  // Check 25 dosha types
}

Response

{
  "success": true,
  "data": {
    "date": "2025-01-20",
    "moon_sign": "Scorpio",
    "nakshatra": "Anuradha",
    "tithi": "Saptami (7th lunar day)",

    "yogas_active": [
      {
        "name": "Gaja Kesari Yoga",
        "strength": "Strong",
        "description": "Moon & Jupiter in mutual kendras - brings wisdom, prosperity, fame",
        "impact": "Highly beneficial for career advancement and learning"
      },
      {
        "name": "Budhaditya Yoga",
        "strength": "Medium",
        "description": "Sun & Mercury conjunction - sharp intellect and communication skills",
        "impact": "Excellent for negotiations, contracts, and business deals"
      },
      {
        "name": "Chandra Mangala Yoga",
        "strength": "Weak",
        "description": "Moon & Mars conjunction - entrepreneurial drive",
        "impact": "Good for taking calculated business risks"
      }
    ],

    "doshas_detected": [
      {
        "name": "Sade Sati",
        "phase": "Peak Phase (2nd cycle)",
        "severity": "Medium",
        "description": "Saturn transiting over Moon sign",
        "impact": "Challenges in personal life, requires patience and discipline",
        "remedies": [
          "Chant Hanuman Chalisa on Saturdays",
          "Donate black sesame seeds on Saturdays",
          "Wear blue sapphire (after astrological consultation)"
        ]
      }
    ],

    "predictions": {
      "overall": "A productive day with positive energy. Gaja Kesari Yoga active - excellent for new beginnings.",
      "career": {
        "summary": "Excellent day for professional advancement - Budhaditya Yoga supports negotiations",
        "advice": "Present your ideas confidently in meetings, sign important contracts",
        "lucky_time": "10:00 AM - 12:00 PM (Hora of Mercury)"
      },
      "love": {
        "summary": "Harmonious relationships despite Sade Sati influence",
        "advice": "Express your feelings openly, avoid heated arguments",
        "compatibility": "High with water signs"
      },
      "health": {
        "summary": "Good vitality and energy, watch Saturn's influence on joints",
        "advice": "Focus on cardiovascular exercises, practice yoga for stress relief",
        "caution": "Avoid spicy food after sunset, take care of knees/joints"
      },
      "finance": {
        "summary": "Favorable for investments - Gaja Kesari Yoga brings prosperity",
        "advice": "Consider long-term financial planning, avoid impulsive decisions",
        "lucky_number": 8
      }
    },

    "current_dashas": {
      "mahadasha": "Venus (until 2027)",
      "antardasha": "Moon (until March 2025)",
      "pratyantardasha": "Jupiter (until Feb 15)"
    },

    "current_transits": {
      "jupiter": { "sign": "Taurus", "house": 10, "impact": "Career expansion, authority gains" },
      "saturn": { "sign": "Pisces", "house": 8, "impact": "Transformation, spiritual growth" },
      "rahu": { "sign": "Pisces", "house": 8, "impact": "Sudden changes, hidden opportunities" }
    },

    "auspicious_timings": {
      "choghadiya_best": ["10:00-11:30 AM (Labh)", "14:00-15:30 PM (Amrit)"],
      "hora_favorable": ["10:00-11:00 (Mercury)", "17:00-18:00 (Venus)"],
      "avoid_timings": ["12:00-13:30 (Kal)", "16:00-17:30 (Udveg)"]
    },

    "planetary_influences": {
      "beneficial": ["Jupiter (Gaja Kesari Yoga)", "Venus", "Mercury (Budhaditya Yoga)"],
      "challenging": ["Saturn (Sade Sati)"],
      "neutral": ["Mars", "Rahu"]
    }
  }
}

300+ Yoga Detection

Response Example

{
  "success": true,
  "data": {
    "total_yogas_found": 12,
    "yogas": [
      {
        "name": "Gaja Kesari Yoga",
        "category": "Fame & Prosperity",
        "strength": "Strong",
        "planets_involved": ["Moon", "Jupiter"],
        "condition": "Moon and Jupiter in mutual kendras",
        "effects": [
          "Brings wisdom, prosperity, and fame",
          "Leadership qualities and good judgment",
          "Respected in society, gains through government"
        ],
        "activation_period": "Jupiter Mahadasha (2024-2040)"
      },
      {
        "name": "Neecha Bhanga Raja Yoga",
        "category": "Power (Special)",
        "strength": "Medium",
        "planets_involved": ["Saturn", "Venus"],
        "condition": "Debilitated Saturn aspected by exalted Venus",
        "effects": [
          "Cancellation of debilitation - rise from humble origins",
          "Success through persistent effort",
          "Recognition after initial struggles"
        ],
        "activation_period": "Saturn Antardasha in Venus Mahadasha"
      }
    ],
    "summary": {
      "highly_beneficial": 5,
      "beneficial": 4,
      "neutral": 2,
      "challenging": 1
    }
  }
}

25 Dosha Types with Remedies

Response Example

{
  "success": true,
  "data": {
    "total_doshas_found": 3,
    "severity": "Medium",
    "doshas": [
      {
        "name": "Kaal Sarp Dosha",
        "type": "Anant Kaal Sarp (Type 1)",
        "severity": "High",
        "planets_affected": "All planets between Rahu (1st house) and Ketu (7th house)",
        "effects": [
          "Obstacles in personal growth and relationships",
          "Sudden unexpected challenges",
          "Health issues related to nervous system"
        ],
        "active_periods": ["Rahu Mahadasha", "Ketu Antardasha"],
        "remedies": [
          {
            "type": "Mantra",
            "description": "Chant Rahu mantra 108 times daily: Om Bhram Bhreem Bhroum Sah Rahave Namah"
          },
          {
            "type": "Puja",
            "description": "Perform Kaal Sarp Dosha Nivaran Puja at Trimbakeshwar temple"
          },
          {
            "type": "Donation",
            "description": "Donate black sesame seeds and black cloth on Saturdays"
          },
          {
            "type": "Gemstone",
            "description": "Wear Hessonite (Gomed) in silver ring on middle finger (after consultation)"
          }
        ]
      },
      {
        "name": "Sade Sati",
        "phase": "Peak Phase (2nd cycle)",
        "severity": "Medium",
        "period": "2024-01-17 to 2025-03-29",
        "effects": [
          "Professional challenges and delays",
          "Health issues (joints, bones)",
          "Mental stress and anxiety"
        ],
        "remedies": [
          {
            "type": "Mantra",
            "description": "Chant Hanuman Chalisa daily, especially on Saturdays"
          },
          {
            "type": "Fast",
            "description": "Fast on Saturdays, eat only one meal without salt"
          }
        ]
      }
    ]
  }
}

Complete Numerology Features

Example Request

{
  "question": "Calculate my life path number, destiny number, and soul urge number",
  "birthDetails": {
    "datetime": "1990-01-15T10:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30",
    "name": "John Michael Smith"
  }
}

Example Response

{
  "response": "Based on your birth date January 15, 1990:\n\n🔢 Life Path Number: 8\nThe Powerhouse - Natural leader with strong business acumen...\n\n🔢 Destiny Number: 5\nThe Freedom Seeker - Adaptable, versatile, loves change...\n\n🔢 Soul Urge Number: 7\nThe Seeker - Deep thinker, spiritual, analytical...",
  "metadata": {
    "creditsUsed": 2,
    "model": "vedika-orchestrator",
    "engine": "ai-numerology"
  }
}

Electional Astrology & Timing

Example Request

{
  "question": "What are the best auspicious times for a wedding on December 25, 2025 in New Delhi?",
  "birthDetails": {
    "date": "2025-12-25",
    "time": "00:00",
    "lat": 28.6139,
    "lng": 77.2090
  }
}

Example Response

{
  "response": "Auspicious times for wedding on December 25, 2025 in New Delhi:\n\n⏰ Morning Muhurtha: 6:45 AM - 8:30 AM\n✅ Highly favorable for marriage ceremonies\n\n⏰ Afternoon Muhurtha: 1:15 PM - 3:00 PM  \n✅ Good for wedding rituals\n\n🚫 Avoid: 11:30 AM - 12:45 PM (Rahu Kaal)\n\nPanchang Details:\nTithi: Shukla Paksha Saptami\nNakshatra: Rohini (Very auspicious)\nYoga: Siddha Yoga",
  "metadata": {
    "creditsUsed": 2,
    "model": "vedika-orchestrator",
    "engine": "ai-muhurtha"
  }
}

Standard Request Format

All V2 Vedic endpoints accept the same birth data format:

{
  "datetime": "1990-06-15T14:30:00",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezone": "+05:30"
}

Standard Response Format

Every V2 endpoint returns billing info alongside the data:

{
  "success": true,
  "data": { "..." },
  "billing": {
    "charged": 0.005,
    "currency": "USD",
    "balanceBefore": 99.50,
    "balanceAfter": 99.495,
    "endpoint": "Kundli",
    "category": "chart"
  },
  "meta": {
    "engine": "vedika-intelligence",
    "version": "2.1.0"
  }
}

Performance

Kundli / Birth Chart

Complete birth chart with planetary positions, houses, aspects, and dignities.

curl -X POST "https://api.vedika.io/v2/astrology/kundli" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  }'

{
  "success": true,
  "data": {
    "ascendant": { "sign": "Libra", "degree": 15.42, "nakshatra": "Swati", "pada": 2 },
    "planets": [
      { "name": "Sun", "sign": "Taurus", "house": 8, "degree": 0.87, "nakshatra": "Krittika", "pada": 4, "dignity": "Neutral", "retrograde": false },
      { "name": "Moon", "sign": "Capricorn", "house": 4, "degree": 18.53, "nakshatra": "Shravana", "pada": 3, "dignity": "Neutral", "retrograde": false },
      { "name": "Mars", "sign": "Pisces", "house": 6, "degree": 22.14, "nakshatra": "Revati", "pada": 3, "dignity": "Neutral", "retrograde": false }
    ],
    "houses": [
      { "house": 1, "sign": "Libra", "lord": "Venus", "lordPlacement": 8 },
      { "house": 2, "sign": "Scorpio", "lord": "Mars", "lordPlacement": 6 }
    ]
  },
  "billing": { "charged": 0.005, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.495, "endpoint": "Kundli", "category": "chart" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

Predictions

AI-generated daily, weekly, and monthly predictions based on transit positions and dasha periods.

curl -X POST "https://api.vedika.io/v2/astrology/prediction/daily" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  }'

{
  "success": true,
  "data": {
    "date": "2026-03-02",
    "rashi": "Capricorn",
    "prediction": "Today brings focus to professional matters. The Moon transiting your 10th house...",
    "scores": { "career": 8, "love": 6, "health": 7, "finance": 7 },
    "luckyNumber": 4,
    "luckyColor": "Blue"
  },
  "billing": { "charged": 0.005, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.495, "endpoint": "DailyPrediction", "category": "prediction" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

Panchang

Complete Vedic calendar data: tithi, nakshatra, yoga, karana, and sunrise/sunset times.

curl "https://api.vedika.io/v2/astrology/panchang/today?latitude=28.6139&longitude=77.2090&timezone=%2B05:30" \
  -H "x-api-key: YOUR_API_KEY"

# Specific date
curl "https://api.vedika.io/v2/astrology/panchang/2026-03-15?latitude=28.6139&longitude=77.2090&timezone=%2B05:30" \
  -H "x-api-key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "date": "2026-03-02",
    "tithi": { "name": "Shukla Trayodashi", "number": 13, "endTime": "18:42" },
    "nakshatra": { "name": "Purva Phalguni", "lord": "Venus", "endTime": "21:15" },
    "yoga": { "name": "Shubha", "endTime": "16:30" },
    "karana": { "name": "Garija", "endTime": "18:42" },
    "sunrise": "06:32",
    "sunset": "18:15",
    "moonrise": "16:08"
  },
  "billing": { "charged": 0.003, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.497, "endpoint": "Panchang", "category": "panchang" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

Doshas

Detect Mangal Dosha, Kaal Sarp Dosha, and Sade Sati with severity levels and remedies.

curl -X POST "https://api.vedika.io/v2/astrology/mangal-dosha" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  }'

{
  "success": true,
  "data": {
    "mangalDosha": {
      "present": false,
      "marsHouse": 6,
      "marsSign": "Pisces",
      "severity": "none",
      "cancellationFactors": ["Mars in Pisces (benefic sign)", "Jupiter aspects Mars"]
    }
  },
  "billing": { "charged": 0.005, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.495, "endpoint": "MangalDosha", "category": "dosha" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

Vimshottari Dasha

Complete Vimshottari dasha periods: mahadasha, antardasha, and pratyantardasha with exact dates.

curl -X POST "https://api.vedika.io/v2/astrology/vimshottari-dasha" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  }'

{
  "success": true,
  "data": {
    "currentDasha": {
      "mahadasha": { "planet": "Jupiter", "start": "2022-08-15", "end": "2038-08-15" },
      "antardasha": { "planet": "Saturn", "start": "2025-02-20", "end": "2027-09-02" },
      "pratyantardasha": { "planet": "Mercury", "start": "2026-01-10", "end": "2026-06-18" }
    },
    "allMahadashas": [
      { "planet": "Moon", "start": "1990-06-15", "end": "2000-06-15", "years": 10 },
      { "planet": "Mars", "start": "2000-06-15", "end": "2007-06-15", "years": 7 },
      { "planet": "Rahu", "start": "2007-06-15", "end": "2025-06-15", "years": 18 }
    ]
  },
  "billing": { "charged": 0.005, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.495, "endpoint": "VimshottariDasha", "category": "dasha" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

Guna Milan (Kundli Matching)

Ashtakoota matching between two birth charts. 36-point system for marriage compatibility.

curl -X POST "https://api.vedika.io/v2/astrology/guna-milan" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "male": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 28.6139,
      "longitude": 77.2090,
      "timezone": "+05:30"
    },
    "female": {
      "datetime": "1992-08-20T10:00:00",
      "latitude": 19.0760,
      "longitude": 72.8777,
      "timezone": "+05:30"
    }
  }'

{
  "success": true,
  "data": {
    "totalScore": 28,
    "maxScore": 36,
    "categories": [
      { "name": "Varna", "score": 1, "max": 1, "description": "Spiritual compatibility" },
      { "name": "Vashya", "score": 2, "max": 2, "description": "Mutual attraction" },
      { "name": "Tara", "score": 3, "max": 3, "description": "Birth star compatibility" },
      { "name": "Yoni", "score": 3, "max": 4, "description": "Physical compatibility" },
      { "name": "Graha Maitri", "score": 5, "max": 5, "description": "Mental compatibility" },
      { "name": "Gana", "score": 5, "max": 6, "description": "Temperament match" },
      { "name": "Bhakoot", "score": 7, "max": 7, "description": "Love and family" },
      { "name": "Nadi", "score": 2, "max": 8, "description": "Health and genes" }
    ],
    "recommendation": "Good match (28/36). Proceed with further analysis."
  },
  "billing": { "charged": 0.025, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.475, "endpoint": "GunaMilan", "category": "matching" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

Divisional Charts

16 divisional charts (D1 through D60) for specialized life-area analysis.

Available charts: D1 (Rasi), D2 (Hora), D3 (Drekkana), D4 (Chaturthamsa), D7 (Saptamsa), D9 (Navamsa), D10 (Dasamsa), D12 (Dwadasamsa), D16 (Shodasamsa), D20 (Vimsamsa), D24 (Chaturvimsamsa), D27 (Bhamsa), D30 (Trimsamsa), D40 (Khavedamsa), D45 (Akshavedamsa), D60 (Shashtiamsa)

curl -X POST "https://api.vedika.io/v2/astrology/navamsa" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  }'

Numerology

7 numerology endpoints covering Pythagorean and Chaldean systems.

curl -X POST "https://api.vedika.io/v2/astrology/numerology/life-path" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Rahul Sharma",
    "birthDate": "1990-06-15"
  }'

{
  "success": true,
  "data": {
    "lifePathNumber": 4,
    "meaning": "Builder and organizer. You bring structure and discipline to everything you do.",
    "strengths": ["Practical", "Disciplined", "Reliable"],
    "challenges": ["Rigidity", "Stubbornness"]
  },
  "billing": { "charged": 0.003, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.497, "endpoint": "NumerologyLifePath", "category": "numerology" },
  "meta": { "engine": "vedika-intelligence", "version": "2.1.0" }
}

More V2 Vedic Endpoints

Conversation API

Multi-turn conversations with context persistence. The AI remembers previous questions in the same conversation.

Multi-turn example:

# 1. First question
curl -X POST "https://api.vedika.io/api/v1/astrology/query" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "question": "Tell me about my career prospects",
    "birthDetails": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 28.6139,
      "longitude": 77.2090,
      "timezone": "+05:30"
    }
  }'
# Response includes: "conversationId": "conv_abc123..."

# 2. Follow-up (include conversationId)
curl -X POST "https://api.vedika.io/api/v1/astrology/query" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "question": "What about next year specifically?",
    "birthDetails": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 28.6139,
      "longitude": 77.2090,
      "timezone": "+05:30"
    },
    "conversationId": "conv_abc123..."
  }'

Usage & Wallet

Check your wallet balance, usage history, and billing summary.

curl "https://api.vedika.io/api/v1/usage/wallet" \
  -H "x-api-key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "walletBalance": 45.50,
    "currency": "USD",
    "plan": "professional",
    "totalCalls": 1247,
    "subscriptionEndDate": "2026-04-01T00:00:00Z"
  }
}

📊 Pricing

🌟 Available Endpoints

Transit Chart Example

curl -X POST "https://api.vedika.io/v2/western/transit-chart" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  }'

{
  "success": true,
  "data": {
    "natalPlanets": [
      { "name": "Sun", "sign": "Gemini", "house": 9, "degree": 24.12, "retrograde": false },
      { "name": "Moon", "sign": "Aquarius", "house": 5, "degree": 12.53, "retrograde": false }
    ],
    "transitPlanets": [
      { "name": "Saturn", "sign": "Pisces", "degree": 28.45, "retrograde": false },
      { "name": "Jupiter", "sign": "Cancer", "degree": 5.12, "retrograde": false }
    ],
    "transitAspects": [
      { "transitPlanet": "Saturn", "natalPlanet": "Sun", "aspect": "Square", "orb": 4.33, "applying": true }
    ]
  },
  "billing": { "charged": 0.064, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.436, "endpoint": "TransitChart", "category": "western-transit" },
  "meta": { "system": "western", "zodiac": "tropical", "engine": "vedika-intelligence", "version": "2.1.0" }
}

Horoscope Example (GET)

# Basic daily horoscope
curl "https://api.vedika.io/v2/western/horoscope/aries" \
  -H "x-api-key: YOUR_API_KEY"

# Advanced with transit context
curl "https://api.vedika.io/v2/western/horoscope/aries/advanced" \
  -H "x-api-key: YOUR_API_KEY"

Synastry Example (Two-Person)

curl -X POST "https://api.vedika.io/v2/western/synastry" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "person1": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 28.6139,
      "longitude": 77.2090,
      "timezone": "+05:30"
    },
    "person2": {
      "datetime": "1992-08-20T14:15:00",
      "latitude": 19.0760,
      "longitude": 72.8777,
      "timezone": "+05:30"
    }
  }'

{
  "success": true,
  "data": {
    "person1": { "sun": "Gemini", "moon": "Aquarius", "ascendant": "Libra" },
    "person2": { "sun": "Leo", "moon": "Taurus", "ascendant": "Scorpio" },
    "aspects": [
      { "planet1": "Sun", "planet2": "Moon", "aspect": "Trine", "orb": 2.41, "harmony": "positive" },
      { "planet1": "Venus", "planet2": "Mars", "aspect": "Conjunction", "orb": 1.15, "harmony": "positive" }
    ],
    "overallScore": 78,
    "strengths": ["Strong emotional bond (Moon aspects)", "Physical chemistry (Venus-Mars)"],
    "challenges": ["Communication style differences (Mercury square)"]
  },
  "billing": { "charged": 0.148, "currency": "USD", "balanceBefore": 99.50, "balanceAfter": 99.352, "endpoint": "Synastry", "category": "western-relationship" },
  "meta": { "system": "western", "zodiac": "tropical", "engine": "vedika-intelligence", "version": "2.1.0" }
}

🎨 Customization Parameters

Pass these optional parameters to /api/v1/astrology/query to customize AI responses:

💻 White-Label Example

const response = await fetch('https://api.vedika.io/api/v1/astrology/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    question: "What is my moon sign?",
    birthDetails: {
      datetime: "1990-05-15T10:30:00+05:30",
      latitude: 28.6139,
      longitude: 77.209
    },
    // White-label customization
    systemPrompt: "You are {{assistantName}}, a friendly astrology guide. Keep responses concise and warm.",
    assistantName: "StarGuide AI",
    signOff: "✨ With cosmic wisdom - StarGuide Team"
  })
});

📝 Example Response (White-Labeled)

{
  "response": "Hello! Your Moon Sign is Scorpio (Vrishchika Rashi). This gives you an intense emotional nature, deep intuition, and remarkable resilience. You feel things deeply and have a natural ability to understand hidden truths.\n\n✨ With cosmic wisdom - StarGuide Team",
  "metadata": {
    "model": "Vedika AI",
    "processing_time_ms": 847,
    "creditsUsed": 0.35
  }
}

API Rate Limits by Plan

Rate Limit Headers

Every API response includes these headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1642680000
X-Credits-Remaining: 9850
X-Credits-Reset: 2025-02-01T00:00:00Z

Credit Usage by Endpoint

Official SDKs

npm install @vedika-io/sdk

import { VedikaClient } from '@vedika-io/sdk';

const client = new VedikaClient({
  apiKey: 'vk_live_your_api_key'
});

// Get astrology query
const response = await client.astrology.query({
  question: "What does Mars in 10th house mean?",
  birthDetails: {
    date: "1990-01-15",
    time: "10:30",
    location: "New York"
  }
});

console.log(response.data);

pip install vedika-api

from vedika import VedikaClient

client = VedikaClient(api_key='vk_live_your_api_key')

# Generate birth chart
chart = client.charts.birth(
    birth_details={
        'date': '1990-01-15',
        'time': '10:30',
        'location': 'New York'
    },
    chart_type='D1'
)

print(chart.data)

# For Indian/Asian users (better performance):
curl -X POST https://api.vedika.io/api/v1/astrology/query \
  -H "Content-Type: application/json" \
  -H "x-api-key: vk_live_your_api_key" \
  -d '{
    "question": "What is my career outlook?",
    "birthDetails": {
      "datetime": "1990-01-15T10:30:00",
      "latitude": 40.7128,
      "longitude": -74.0060,
      "timezone": "-05:00"
    }
  }'

Automatic Content Protection

Every query is automatically filtered before processing to ensure quality and safety. Our AI-powered content filter blocks spam, harmful content, and off-topic queries with 98% accuracy.

Filter Response Format

When a query is blocked, you'll receive:

{
  "error": {
    "code": "CONTENT_FILTERED",
    "message": "Query blocked by content filter",
    "category": "spam",
    "confidence": 0.98,
    "reason": "Commercial promotional content detected",
    "suggestions": [
      "Ask a genuine astrology question",
      "Remove promotional URLs and content",
      "Focus on birth chart or prediction topics"
    ]
  }
}

Filter Categories

Automatic Response Evaluation

Every response is automatically scored across 6 quality dimensions. Responses scoring below 6/10 are automatically enhanced with Vedika Pro Ultra and re-scored to ensure excellence.

Quality Score Dimensions

Enhanced Response Schema

All responses now include comprehensive quality metadata:

{
  "answer": "Your personalized astrology response...",
  "confidence": 0.85,
  "followUpSuggestions": [...],
  "qualityScores": {
    "overall_score": 8.5,
    "accuracy_score": 9,
    "relevance_score": 9,
    "completeness_score": 8,
    "clarity_score": 9,
    "depth_score": 8,
    "spiritual_guidance_score": 9,
    "confidence": 0.92,
    "strengths": [
      "Accurate planetary details",
      "Clear explanations",
      "Practical guidance"
    ],
    "weaknesses": [
      "Could include more transit timing"
    ],
    "missing_elements": [],
    "enhancement_suggestions": [],
    "requires_revision": false,
    "revision_priority": "low"
  },
  "metadata": {
    "processingTime": 52000,
    "enhanced": false
  }
}

Auto-Enhancement Process

Supported Languages

Usage Examples

Simply add the language parameter to any API request. The response will be translated to your chosen language.

const response = await fetch('https://api.vedika.io/api/v1/astrology/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'vk_live_your_key_here'
  },
  body: JSON.stringify({
    question: "मेरी कुंडली में कौन से योग हैं?",
    language: "hi",  // Hindi
    birthDetails: {
      date: "1990-01-15",
      time: "14:30",
      location: "Mumbai, India"
    }
  })
});

const response = await fetch('https://api.vedika.io/api/v1/astrology/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'vk_live_your_key_here'
  },
  body: JSON.stringify({
    question: "என் ஜாதகத்தில் என்ன யோகங்கள் உள்ளன?",
    language: "ta",  // Tamil
    birthDetails: {
      date: "1990-01-15",
      time: "14:30",
      location: "Chennai, India"
    }
  })
});

const response = await fetch('https://api.vedika.io/api/v1/astrology/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'vk_live_your_key_here'
  },
  body: JSON.stringify({
    question: "আমার জন্ম তালিকায় কি যোগ আছে?",
    language: "bn",  // Bengali
    birthDetails: {
      date: "1990-01-15",
      time: "14:30",
      location: "Kolkata, India"
    }
  })
});

const response = await fetch('https://api.vedika.io/api/v1/astrology/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'vk_live_your_key_here'
  },
  body: JSON.stringify({
    question: "నా జాతకంలో ఏ యోగాలు ఉన్నాయి?",
    language: "te",  // Telugu
    birthDetails: {
      date: "1990-01-15",
      time: "14:30",
      location: "Hyderabad, India"
    }
  })
});

How It Works

What is Western Astrology?

Western astrology uses the Tropical zodiac, which is season-based and aligns with the Earth's relationship to the Sun. This differs from Vedic astrology's Sidereal zodiac, which is star-based.

7 Western Astrology Endpoints

{
  "birthDetails": {
    "datetime": "1990-01-15T14:30:00+05:30",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  },
  "houseSystem": "P"  // P=Placidus, K=Koch, E=Equal, W=Whole Sign
}

{
  "datetime": "2025-10-10T12:00:00Z"
}

{
  "birthDetails": { /* natal data */ },
  "progressionDate": "2025-10-10"  // Date to progress to
}

{
  "birthDetails": { /* natal data */ },
  "returnYear": 2025
}

{
  "person1": { "datetime": "...", "latitude": ..., "longitude": ... },
  "person2": { "datetime": "...", "latitude": ..., "longitude": ... }
}

{
  "birthDetails": { /* natal data */ },
  "transitDate": "2025-10-10"  // Optional, defaults to now
}

🌐 Transit Analysis (4 endpoints)

⏩ Progressions & Solar Return (6 endpoints)

💕 Relationship Analysis (5 endpoints)

13 House Systems Supported

Vedic vs Western: Quick Reference

LLM Response Caching

Intelligent caching system reduces costs by 40-60% while maintaining response quality. Responses are cached for 30 minutes with SHA-256 key generation.

How Caching Works

Performance Benefits

Vedika Intelligence Models

Vedika automatically selects the optimal AI model based on your query complexity and analysis requirements. Our multi-model architecture provides 82% higher accuracy than generic AI.

💰 Token-Based Pricing

Vedika uses transparent token-based billing. You only pay for what you use, with detailed breakdowns of every query showing exact token usage and costs.

{
  "usage": {
    "input_tokens": 425,
    "output_tokens": 1100,
    "cached_tokens": 1575,
    "total_tokens": 3110
  },
  "cost_breakdown": {
    "astronomical": {
      "calculations_performed": 6,
      "cost_usd": 0.17
    },
    "ai_processing": {
      "lead_model": {
        "model": "vedika-pro-ultra",
        "role": "lead",
        "cost_usd": 0.009
      },
      "specialist_models": [
        {
          "model": "vedika-swift",
          "role": "specialist",
          "cost_usd": 0.003
        }
      ],
      "total_cost_usd": 0.02
    },
    "total_cost_usd": 0.19,
    "total_price_usd": 0.52
  },
  "wallet": {
    "balance_before": 20.00,
    "deducted": 0.52,
    "balance_after": 19.48,
    "currency": "USD"
  }
}

Vedika Astrology Engine

Complete Vedic coverage - Our proprietary astrology engine provides access to 100+ authentic Vedic astrology features powered by Swiss Ephemeris calculations.

Available Calculations

Frequently Asked Questions