asterwise

The official TypeScript library for Asterwise — Vedic + Western astrology, numerology, tarot, crystals, and dreams. 115+ endpoints. Ships in days.

Documentation · API Reference · Pricing · MCP server

Installation

npm install asterwise

Quickstart

import { createClient, createConfig, natalChart } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
}));

const result = await natalChart({
  client,
  body: {
    date: '1985-11-12',
    time: '06:45',
    location: 'Mumbai, India',
    ayanamsa: 'lahiri',
  },
});

console.log(result.data);

Get a free API key at asterwise.com.

What you can build

Domain	Operations
Vedic astrology	40
Matchmaking	5
Western astrology	17
Horoscope	8
Numerology	24
KP + Lal Kitab	5
Tarot	9
Crystals & dreams	7
Utilities	2

117 typed SDK methods across 13 API classes; marketed as 115+ REST endpoints.

What makes Asterwise different

• Structured classical interpretations on every response
• 5-level Vimshottari Dasha (Maha → Antar → Pratyantar → Sookshma → Prana) — most APIs return two
• Rajju and Vedha as hard vetoes in matchmaking — not just point scores
• HMAC-signed responses for auditability
• MCP server with 100+ tools for Claude and Cursor integration

Examples

import {
  createClient,
  createConfig,
  westernNatalChart,
  lifePath,
  tarotThreeCard,
} from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const western = await westernNatalChart({
  client,
  body: {
    date: '1985-11-12',
    time: '06:45',
    location: 'Mumbai, India',
  },
});

const path = await lifePath({
  client,
  query: { date: '1985-11-12' },
});

const spread = await tarotThreeCard({
  client,
  body: { question: 'What should I focus on this month?' },
});

Requirements

Node.js 18+. An API key from asterwise.com.

Documentation

Full API reference: docs.asterwise.com

Development

Regenerate from https://api.asterwise.com/openapi-sdk.json:

npm run generate

The scripts/post-generate.mjs hook re-exports createClient and createConfig from the package root after each generation.

Versioning: regenerate → bump version in package.json → npm install (sync lockfile) → update CHANGELOG.md → npm run build → npm publish.

Support

support@asterwise.com

License

Commercial. See LICENSE.