quickstart.mjs

// VedAstro API quickstart — no API key required (free tier, 5 req/min).
// Run: node quickstart.mjs  (Node.js 18+ for built-in fetch)

const BASE = "https://api.vedastro.org/api";

/** Call the VedAstro API and unwrap the Status/Payload envelope. */
async function call(method, url, body) {
  const res = await fetch(url, {
    method,
    headers: body ? { "Content-Type": "application/json" } : undefined,
    body: body ? JSON.stringify(body) : undefined,
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const json = await res.json();
  if (json.Status !== "Pass") throw new Error(`VedAstro API error: ${json.Payload}`);
  return json.Payload;
}

async function main() {
  // 1. Resolve an address to coordinates.
  // NOTE: result is nested under Payload.AddressToGeoLocation — not all
  // endpoints nest this way, check the README's verified examples per endpoint.
  const payload = await call("POST", `${BASE}/Calculate/AddressToGeoLocation`, {
    Address: "mumbai",
    Ayanamsa: "RAMAN",
  });
  console.log("Resolved location:", payload.AddressToGeoLocation);

  const birthTime = {
    StdTime: "14:30 25/10/1992 +05:30", // HH:MM DD/MM/YYYY +-HH:MM — NOT ISO 8601
    Location: { Name: "Mumbai", Latitude: 19.076, Longitude: 72.8777 },
  };

  // 2. Horoscope predictions — this endpoint returns the array directly as
  // Payload (no nested key), unlike AddressToGeoLocation above.
  const predictions = await call("POST", `${BASE}/Calculate/HoroscopePredictions`, {
    birthTime,
    Ayanamsa: "RAMAN",
    sortByWeight: true,
  });
  console.log(`Got ${predictions.length} predictions`);

  // 3. Dasa period active at a given check time — nested under Payload.DasaAtTime
  const dasa = await call("POST", `${BASE}/Calculate/DasaAtTime`, {
    birthTime,
    checkTime: { StdTime: "12:00 11/07/2026 +05:30", Location: birthTime.Location },
    Ayanamsa: "RAMAN",
    levels: 1,
  });
  console.log("Dasa at check time:", dasa.DasaAtTime);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});