Skip to main content

Changelog

Every change to the Asterwise API is recorded here. Entries are dated by deployment day and grouped by category. See versioning for what counts as a breaking vs additive change.

The current API version is 2026-03-01.

2026-03-01 — Initial public release​

Asterwise v1 launched with:

Endpoints​

  • 50 Vedic Astrology endpoints (foundations, dashas, chart analysis, yogas, doshas, matchmaking, forecasting, panchanga, KP system, Lal Kitab, remedies)
  • 17 Western Astrology endpoints (foundations, relationships, transits, returns, progressions)
  • 21 Numerology endpoints (Pythagorean, Chaldean, lucky numbers, compatibility, business names, Lo Shu grid)
  • 9 Tarot endpoints (full deck, draws, spreads, individual cards)
  • 5 Crystals endpoints
  • 4 Angel Numbers endpoints
  • 4 Vedic Horoscope endpoints (daily, weekly, monthly, yearly)
  • 4 Western Horoscope endpoints
  • 2 Dreams endpoints
  • 2 Utilities endpoints

Response contract​

  • Canonical 8-field error envelope across all endpoints (except /v1/oauth/*, which uses RFC 6749 format)
  • Stable 3-field success envelope (success, message, data)
  • 50 documented error codes with stable wire values
  • Per-error reference pages at /reference/errors/{code}

Authentication​

  • Bearer token authentication via the Authorization header
  • Four plan tiers: Sandbox (free), Builder ($39/mo), Launch ($99/mo), Scale ($249/mo)
  • Subscription expiry handled gracefully with the subscription_expired error code

Rate limiting​

  • IP burst limit: 60 requests/minute (unauthenticated)
  • Tier-specific burst limits (10/60/200/500 per minute)
  • Per-plan monthly quotas (500/15,000/60,000/300,000 calls)
  • Retry-After HTTP header on every retry-bearing response per RFC 7231 §7.1.3
  • Graceful degradation: rate limiting fails open if Redis is unreachable

MCP server​

  • 103 MCP tools available via mcp.asterwise.com
  • Authentication via OAuth 2.0 Authorization Code + PKCE
  • Support for Claude Desktop, Cursor, Windsurf, VS Code

SDKs​

  • asterwise-python — typed Python client with ErrorCode Literal type
  • asterwise-typescript — typed TypeScript client with ErrorCode union type
  • Both SDKs expose the full canonical envelope shapes

Reporting issues​

If you spot a discrepancy between the API behavior and what's documented here, file an issue at github.com/asterwise/asterwise-api/issues or email [email protected] with the X-Request-Id from any affected response.