Quickstart Guide

Prerequisites

npm install @vedika/sdk

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

const vedika = new VedikaClient({
  apiKey: 'vk_live_your_api_key_here'
});

// Or use environment variable (recommended)
// Set VEDIKA_API_KEY in your .env file
const vedika = new VedikaClient();

Let's get a birth chart for someone born on May 15, 1990 in New Delhi:

// Get birth chart
const chart = await vedika.birthChart({
  datetime: '1990-05-15T10:30:00+05:30',
  latitude: 28.6139,
  longitude: 77.2090,
  timezone: 'Asia/Kolkata'
});

console.log('Sun Sign:', chart.sunSign);      // 'Taurus'
console.log('Moon Sign:', chart.moonSign);    // 'Aries'
console.log('Ascendant:', chart.ascendant);   // 'Cancer'
console.log('Nakshatra:', chart.nakshatra);   // 'Ashwini'

// Access all planetary positions
chart.planets.forEach(planet => {
  console.log(`${planet.name}: ${planet.sign} at ${planet.degree}`);
});

Complete Working Example

// quickstart.js
import { VedikaClient } from '@vedika/sdk';

async function main() {
  // Initialize client
  const vedika = new VedikaClient({
    apiKey: process.env.VEDIKA_API_KEY
  });

  // Birth details
  const birthDetails = {
    datetime: '1990-05-15T10:30:00+05:30',
    latitude: 28.6139,
    longitude: 77.2090,
    timezone: 'Asia/Kolkata'
  };

  try {
    // 1. Get Birth Chart
    console.log('Fetching birth chart...');
    const chart = await vedika.birthChart(birthDetails);
    console.log('Birth Chart:', {
      sunSign: chart.sunSign,
      moonSign: chart.moonSign,
      ascendant: chart.ascendant
    });

    // 2. Get Today's Panchang
    console.log('\nFetching today\'s panchang...');
    const panchang = await vedika.panchang({
      date: new Date().toISOString().split('T')[0],
      latitude: 28.6139,
      longitude: 77.2090
    });
    console.log('Panchang:', {
      tithi: panchang.tithi.name,
      nakshatra: panchang.nakshatra.name,
      yoga: panchang.yoga.name
    });

    // 3. Get Dasha Periods
    console.log('\nFetching dasha periods...');
    const dasha = await vedika.vimshottariDasha(birthDetails);
    console.log('Current Mahadasha:', dasha.currentMahadasha.planet);
    console.log('Current Antardasha:', dasha.currentAntardasha.planet);

    // 4. AI-Powered Question
    console.log('\nAsking AI about career...');
    const response = await vedika.query({
      question: 'What are the career prospects for this person?',
      birthDetails
    });
    console.log('AI Response:', response.answer);

  } catch (error) {
    console.error('Error:', error.message);
  }
}

main();

Run the Example

# Set your API key
export VEDIKA_API_KEY=vk_live_your_key_here

# Run with Node.js
node quickstart.js

# Or with TypeScript
npx tsx quickstart.ts

SDK Methods Overview