asterwise

The official TypeScript library for Asterwise — Vedic + Western astrology, numerology, tarot, crystals, and dreams. 118 endpoints, generated from the API's OpenAPI document so the types match what the server sends. Every position is checked against NASA JPL Horizons, median 0.046 arcseconds over 80 positions from 1950 to 2050.

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 |

118 typed SDK methods across 13 API classes covering 118 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 103 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

[email protected]

License

Commercial. See LICENSE.