Changelog what is new

Every change that affects integrator code: new endpoints, SDK updates, /openapi.json schema changes, credit-price revisions, deprecations, breaking changes. Most recent at the top. Internal site work is not listed here.

The API contract is stable inside /v1/* — any breaking change ships under /v2/*, and /v1/* keeps working for at least 12 months.

2026-05-09 — Three SDKs launched: TypeScript, Python, PHP

Three official SDKs are live on public registries — wrappers around the same 700+ API endpoints. One OpenAPI 3.1 spec → three language-idiomatic clients.

What this is for integrators:

• Type-safe alternative to raw HTTP. Path autocomplete + request/response types in your IDE. Helper methods aw.post('/chart', body=...) or aw.client.POST('/chart', { body }) for TS — instead of hand-rolled fetch / requests / Guzzle.
• Identical surface across languages. Constructor Astroway({apiKey, baseUrl, authScheme, timeout, retry}) works the same in TS / Python / PHP. If your project is multi-language, less cognitive overhead.
• Built-in retry on 408/409/429/5xx with exponential backoff + full jitter. Honors Retry-After header. Default 2 retries, configurable via retry={maxRetries: 0}.
• Stainless-template error hierarchy — same template Stripe / OpenAI / Cloudflare SDKs use. Catch RateLimitError (with retryAfterSeconds), AuthenticationError (rotate key), BadRequestError (validation), ApiError (generic) — in that order.
• Two auth schemes. Default X-Api-Key: aw_live_... (matches curl/Postman). Or Authorization: Bearer aw_live_... (matches Stripe/OpenAI/Anthropic SDKs) via auth_scheme="bearer" in the constructor.
• Identification headers, no telemetry. Every request carries User-Agent: astroway-sdk-<lang>/<version> + X-Astroway-Channel: sdk-<lang>. No phone-home, no opt-in/opt-out toggle.
• OIDC + SLSA L3 provenance (TS + Python). Sigstore-attested record that the package was built from a specific commit in the public repo. No long-lived tokens in CI.
• MIT, full source open on github.com/astroway/{astroway-typescript,astroway-python,astroway-php}.

Quick start:

// TypeScript / Node 20+
import { Astroway } from '@astroway/sdk';
const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
const { data } = await aw.client.POST('/chart', { body: { date: '1990-07-14', /* ... */ } });

# Python 3.9+
from astroway import Astroway
aw = Astroway(api_key=os.environ['ASTROWAY_API_KEY'])
chart = aw.post('/chart', body={'date': '1990-07-14', ...})

// PHP 8.1+
use Astroway\Astroway;
$aw = new Astroway(['apiKey' => getenv('ASTROWAY_API_KEY')]);
$chart = $aw->post('/chart', body: ['date' => '1990-07-14', /* ... */]);

Python also offers AsyncAstroway with identical surface for async/await workloads. PHP is sync-only (no unified async story in the language). TS uses native promises through openapi-fetch.

This is an alpha — the public API may shift before 0.1.0 proper based on integrator feedback. Pin the exact version (@astroway/sdk@0.1.0-alpha.1) during the alpha window — or latest alpha at install time.

@astroway/mcp — the MCP server for Claude / Cursor / GPT — keeps living alongside as a separate product.

2026-05-07 — MCP server refresh

@astroway/mcp got an update — it now auto-generates the tool catalog from the live /openapi.json instead of hand-curated routes. Everything that landed in the API over the past weeks (compat suite, reports endpoints) is immediately visible in Claude / Cursor / GPT.

For integrators:

• Tool catalog reflects live API state
• Path-template endpoints (/v1/.../id) are skipped for now — the description parser in MCP clients gets confused otherwise
• Cost annotations in tool descriptions — Claude can see the credit cost of each call before execution
• OIDC trusted publishing + SLSA L3 provenance — the package is attested to a specific commit in the public repo astroway/astroway-mcp

Install:

npm install -g @astroway/mcp

Or through Claude Desktop / Cursor MCP config:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"]
    }
  }
}

Source: public astroway/astroway-mcp (MIT).

2026-04-11 — Cross-system compatibility (+10 endpoints)

A new group /v1/compat/* — composite compatibility score across western, vedic, chinese, numerology, tarot, and human design. Six traditions combine into a unified metric for UX indicators in multi-tradition astrology apps.

Each endpoint returns JSON with a disclaimer field — this is AstroWay’s scoring methodology, not a clinical or legal statement. Tier 4 (100 credits) per call — heavy cross-system compute.

Manifest in /openapi.json updated — SDKs / MCP pick it up automatically.

2026-03-28 — Reports + Webhooks (+17 endpoints)

Two new groups in production.

/v1/reports/* (12 endpoints) — HTML / PDF report generation via Puppeteer. Render runs server-side in api-calc, returning a signed download URL (TTL 24h).

/v1/webhooks/* (5 endpoints) — subscription management, event delivery, HMAC signing. Subscribe to events credits.low, key.created, usage.threshold, error.spike.

curl -X POST https://api.astroway.info/v1/webhooks \
  -H "Authorization: Bearer aw_live_..." \
  -d '{"url": "https://...", "events": ["credits.low"], "secret": "wh_secret_..."}'

Each delivery carries X-Astroway-Signature: sha256=<hmac> — verify with the secret. Retry policy: exponential backoff on 5xx, up to 5 attempts within 24 hours.

2026-03-14 — Reference endpoints: public, no key, no credits

14 /v1/reference/* endpoints (signs, planets, houses, aspects, elements, modalities, polarities, dignities, decans, nakshatras, lots, asteroids, zodiac-systems, glyphs) are now callable without X-Api-Key and cost 0 credits. These are canonical lookup tables — gating them through the billing channel was a design accident.

What this means for integrators:

• No key required — external MCP agents / SDKs / preview pages can pull reference data without authentication. The same IP rate limit as /public (30 req/hr) still applies.
• Cost manifest updated — 14 paths moved from TIER_HALF (5 credits) to 0. If your astroway_cost_estimate budget planner referenced these paths, new calls do not touch your quota anymore.
• Existing clients that send a key keep working unchanged. X-Api-Key is ignored for /reference/* (we do not error on the extra header).

Backward-compatible: 200 responses and the JSON schema are unchanged; only the auth requirement is dropped.

2026-03-07 — Founders’ Lifetime Deal: $299 → Indie tier for life

Launching Founders’ Lifetime Deal — a limited relaunch project. First 100 customers pay $299 one-time and get the Indie tier (50,000 credits/mo) forever, no recurring charges, locked-in price.

What this means for integrators:

• Standard Indie = $5/mo. Founders’ = $299 one-time → breakeven at year 5, infinite ROI thereafter. If your project will be in astrology / numerology / Tarot space for at least 5 years, the Founders’ Deal pays off.
• Webhook payload for SKU astroway-api-indie-lifetime: api_keys row gets plan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULL. No monthly charges, no renewal webhooks.
• DB schema: added columns is_lifetime TINYINT(1) to api_keys and shared_user_quotas. ApiKeyInfo TS type extended. Existing keys = is_lifetime=0 (no behavior change).
• WP REST endpoint GET /wp-json/astroway/v1/founders-count returns {sold, total: 100, remaining, available} — consumed by site/components/founders/FoundersCounter.astro for the realtime counter on /founders/ landing.
• Auto-deactivation at 100/100: WC product _stock_status flips to outofstock via the woocommerce_order_status_completed hook. After that, the checkout link redirects to /pricing/#indie (standard Indie $5/mo).

Live pages: /founders/ (uk) + /en/founders/ (en). Sidebar entry “Founders’ Lifetime Deal” with 🚀 100 only badge.

WP product: astroway-api-indie-lifetime, ID 30618, $299 (13,225 UAH), stock=100. Checkout: astroway.info/checkout/?add-to-cart=30618.

2026-03-05 — GDPR / EU residency landing page + Pro card EU badge

Launching /en/eu/ — a dedicated page for EU developers building GDPR-sensitive products. What integrators need to know:

• Pro $59 = EU-residency by default (Hetzner Nuremberg, EU-only data flow, anonymized analytics — Plausible cookie-free on roadmap).
• Standard DPA is not Enterprise-gated — signed via email on the standard Pro tier within 5 business days.
• DELETE /v1/me/account endpoint for GDPR right-to-erasure (instantly removes your wp_user_id from all tables).
• Pro card on /pricing/ now carries a 🇪🇺 GDPR-ready badge — click leads to /en/eu/ with the full FAQ.
• DivineAPI / AstrologyAPI / Prokerala are US/India-hosted with DPA only on Enterprise. If EU compliance is a hard requirement, Pro $59 is the cheapest path.

Live: /eu/ (uk) + /en/eu/ (en). Sidebar entry “GDPR / EU residency” with 🇪🇺 badge.

2026-03-03 — Annual prepay 25% off + credit rollover + Pro feature surfacing

Two integrator-affecting changes:

• Annual discount 17% → 25% (3 months free instead of 2). New yearly USD prices: Indie $45, Starter $171, Pro $531, Business $1791, HD/Esoteric Pack $81, Vedic Pack $171, Reports Pack $891. Existing annual subscribers are not affected — the new price applies only to future renewals. If you parsed USD prices via /wp-json/astroway/v1/api-prices, updated values are returned automatically.
• Credit rollover for annual subscribers: unused credits roll over to the next monthly cycle, capped at 1× tier monthly allocation. Activated automatically on annual checkout. Visible through new response headers:
  • X-Credits-Limit: <int> — effective monthly limit (includes rollover)
  • X-Credits-Remaining: <int> — same as before, now accounting for rollover
  • X-Credits-Rollover: <int> — current rolled-over balance (annual subscribers only)
• Pro tier ($59) now openly advertises: streaming endpoints (real-time), GDPR-compliant EU billing, MCP advanced (multi-agent / debate / RAG), webhooks (10 event types). These features were already in Pro — previously buried in docs.

DB schema: added columns credit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED to api_keys and shared_user_quotas. Initially both = 0 for all existing keys.

2026-03-01 — Per-endpoint credit cost transparency table

Public page /credits/ now lists the credit cost of all 700+ endpoints. No competitor (DivineAPI, AstrologyAPI, Prokerala) publishes anything similar — they charge a flat 1 credit per call and hide their internal mapping.

For integrators this gives three things:

• Transparent unit economics — exact $/call per endpoint (monthly budgets from /pricing/ × tier cost = real cost-per-call).
• Auto-sync with code — the table is generated at build time from endpoint-costs.ts. Adding a new endpoint or changing a tier propagates automatically on the next deploy.
• Free-tier marker — the column shows which endpoints require Indie+ (🔒 icon, 28 right now).

Available at /credits/ (uk) and /en/credits/ (en). Cross-linked from /rate-limits-credits/ and Starlight sidebar (badge “New”).

2026-02-27 — Vedic charts, cosmogram, eclipse path, star map (+6 endpoints)

Closes the Visualization category at 14/14 endpoints per the roadmap:

• POST /v1/render/wheel-vedic-north — North Indian (diamond) layout. Houses fixed, signs rotate by lagna.
• POST /v1/render/wheel-vedic-south — South Indian (4×4 grid). Signs fixed (Pisces top-left), houses float.
• POST /v1/render/wheel-vedic-east — East Indian (Bengali). Square with diagonals + inner rotated square.
• POST /v1/render/cosmogram — Hamburg School / Cosmobiology 90° dial (Ebertin 1940 + Witte 1928).
• POST /v1/render/eclipse-path — equirectangular world map with caller-supplied lat/lon track; renders centerline + band of given degree-width.
• POST /v1/render/star-map — stereographic projection of a list of (RA, Dec) points with magnitude scaling.

All renderers are pure SVG, no headless Chrome.

2026-02-25 — Bi-/tri-wheel + composite + biorhythm (+4 endpoints)

Four more visualization endpoints extending the SVG engine:

• POST /v1/render/bi-wheel — two concentric wheels: natal inner + transit (or progression) outer ring.
• POST /v1/render/tri-wheel — three wheels: natal + progressed + transit.
• POST /v1/render/composite — render a composite chart from two natal inputs (midpoint composite).
• POST /v1/render/biorhythm — three-cycle sine plot: physical (23d), emotional (28d), intellectual (33d).

No new math — visualization only; bi-wheel computes both charts in parallel via Promise.all.

2026-02-24 — Visualization: SVG rendering (+4 endpoints)

Four new endpoints return SVG renders of natal charts and related visuals. Pure server-side — no Puppeteer / headless Chrome, so latency is ~10 ms instead of 1-2 s and free for the free tier.

• POST /v1/render/wheel-western — Western wheel (signs ring + houses ring + planets + aspect lines).
• POST /v1/render/aspect-grid — triangular aspect matrix with glyph + orb per cell.
• POST /v1/render/moon-phase — moon disk illumination; returns SVG plus illuminationFraction, phase, waxing.
• POST /v1/render/timeline — Gantt-style transit-event timeline (caller passes the events array).

Options: size, theme (light / dark / console), format (json returns { svg, byteLength }; svg serves image/svg+xml directly). Base tier — 2 credits per call.

2026-02-23 — Typed schemas in /v1/openapi.json (612 endpoints, 98%)

/v1/openapi.json is now a fully machine-readable specification both for request bodies and for response data. 612 of 624 POST endpoints are now typed, landing as a coordinated three-stage upgrade:

• Request bodies — 386 endpoints typed via components.schemas (128 reusable components). Of these, 5 are shared (ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper) and 123 are local (DashaInput, MuhuratWindow, ChartWithTnp, WheelWestern, etc.). Composition through allOf for inheritance (DashaInput extends ChartInput).
• Response data — 612 endpoints typed via an inferrer that walks ep.response examples in the manifest: {type: 'object', properties: {...}} instead of the flat {type: 'object'}. The natal chart now declares data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[] with real field types.
• Remaining 12 endpoints — dasha pratyantar/sookshma with unparseable shorthand examples in the manifest — keep {type: object}. Backward-compatible, will be added in upcoming releases.

What this means for integrators:

• Regenerate your OpenAPI client — openapi-typescript, openapi-fetch, swagger-codegen produce interfaces with typed fields instead of Record<string, unknown>. Code completion on request bodies + response data works natively.
• The Postman collection at /postman/astroway-api.json is regenerated from the same types — re-import and you get autocompletion across all typed endpoints.

Backward-compatible: the previous {"type": "object"} form was permissive — every existing client keeps working untouched.

2026-02-21 — Pricing rebase: Reports unified, Business +500K credits, Free hardening

Three integrator-affecting pricing changes:

• Reports unified at 5 000 credits — /v1/reports/transit-yearly, /v1/reports/vedic-kundli, /v1/reports/lal-kitab dropped from 10 000 cr to 5 000 cr per call (2× cheaper). All PDF reports now charge the same — simpler bundle-budget math.
• Business plan +500K credits/mo — Business tier now ships 3 500 000 credits per month (was 3 000 000) at the same $199 price. Existing subscribers get the increased allocation automatically from the next billing cycle.
• Free plan: /v1/reports/* requires a paid tier — 12 PDF endpoints (reports/natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) now return 402 PLAN_UPGRADE_REQUIRED for Free keys. Everything else — charts, synastry, transits, horoscope — stays on Free.

If your Free key was hitting one of those endpoints, upgrade to Indie ($5/mo) or higher, or switch to the JSON equivalents (/v1/chart, /v1/synastry, etc.) for similar content without the PDF render.

2026-02-19 — Sign-in with Google and GitHub (+2 endpoints)

One account across the whole ecosystem — a user who registered on astroway.info or app.astroway.info now signs into the developer console with the same email/SSO and sees their existing orders, credits and API keys.

• GET /v1/auth/oauth/google/start?return=<path> — kicks off the Google OAuth flow.
• GET /v1/auth/oauth/github/start?return=<path> — kicks off the GitHub OAuth flow.

Callback ends with a redirect to /dashboard/oauth/callback#access_token=&refresh_token=&user= — the dashboard persists tokens just like after /v1/auth/login. If the email is already registered via the standard form and the provider asserts email_verified=true, the account is linked rather than duplicated.

2026-02-17 — Reports Pack ($99 / 500,000 credits) + white-label included

Tier for PDF report integrators — 100 PDFs/mo at $0.99 effective, with white-label included by default:

• reports_pack tier ($99/mo or $990/yr) grants 500,000 credits and 200 req/min.
• Access restricted to /reports/* (12 PDF types: natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) + /whitelabel/* (custom logo + colors + domain). Anything else returns 402 PLAN_PACK_MISMATCH (upgrade_to: pro).
• White-label included as default — no Enterprise upgrade needed for branded PDFs.
• Overage rate $3 / 10,000 credits (same as Pro), spend cap toggle available.
• 21 PDF localizations, A4 format, signed-URL CDN delivery (TTL 24h).

API plan enum is now: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack | reports_pack. New WC slug: astroway-api-reports-pack.

2026-02-15 — Cross-school: Jaimini yogas + Lal Kitab and KP doshas (+17 endpoints)

Seventeen endpoints close out the cross-school yoga / dosha grid.

• Jaimini Yogas (5) — /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}. Built on chara karakas (AK / Amk / PK).
• Lal Kitab dosha variants (6) — /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}. LK-specific cancellations and upayas.
• KP dosha variants (6) — /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}. BPHS rules + KP sub-lord chain. Sade Sati is transit-aware (requires targetDate).

Sources: Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI. Pricing: TIER_3 (50 credits).

2026-02-13 — Vedic Pack ($19 / 100,000 credits)

Dedicated tier for Vedic astrology — 165 endpoints at the Starter price point:

• vedic_pack tier ($19/mo or $190/yr) grants 100,000 credits and 100 req/min.
• Access restricted to Vedic namespaces (/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional). Anything else returns 402 PLAN_PACK_MISMATCH.
• Coverage: 16 vargas D1-D60, panchang (7), shadbala (7), yogas (7), doshas (7), compatibility ashtakoot (6), muhurat (12 categories), 8 dasha systems × 5 levels (40), KP, Lal Kitab, Jaimini.
• 2.5-5× more charts at the same price as Prokerala Ruby (~5K kundlis/mo vs their 1-2K).

API plan enum is now: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack. New WC slug: astroway-api-vedic-pack.

2026-02-09 — Lal Kitab: complete pack (+12 endpoints)

Twelve endpoints from the North-Indian Vedic school based on the anonymous Urdu MSS of 1939-1952. The whole school is shipped as YELLOW (intrinsic — single-school with author divergence across modern English commentaries).

• /vedic/lal-kitab/teva — fixed-house chart (house = sign).
• /vedic/lal-kitab/lal-kundali — 12-house grid layout.
• /vedic/lal-kitab/kismat + /prosperity — fortune & dhana yoga scoring.
• /vedic/lal-kitab/dasha (35y) + /varshphal + /life-graph — timing.
• /vedic/lal-kitab/debts — six Rin (Pitri/Stree/Kanya/Atma/Rishi/Daiva) detection + remedy.
• /vedic/lal-kitab/remedies — per-planet upayas (day / mantra / donation).
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}.

Disclaimer surfaced in responses. Sources: K. Ashant Vols I-VI + R.D. Mathur + U.C. Mahajan.

2026-02-06 — Esoteric Pack ($9 / 200,000 credits)

New add-on tier for developers building esoteric / divination apps — 180 endpoints for $9/mo:

• esoteric_pack tier ($9/mo or $90/yr) grants 200,000 credits and 60 req/min.
• Access restricted to esoteric / divination namespaces (/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa). Any other endpoint returns 402 PLAN_PACK_MISMATCH.
• Cannot be combined with another tier on the same key — separate add-on, analogous to HD Pack.

API plan enum is now: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack. New WC slug: astroway-api-esoteric-pack (monthly + yearly variations). If you create keys via /v1/keys without explicit plan, nothing changes.

2026-02-02 — BaZi + Zi Wei Dou Shu (+17 endpoints)

Third Chinese category lands after Chinese Zodiac + Feng Shui:

• BaZi (5) — /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}. Year + month pillars canonical; day + hour pillars deferred until cross-verified against Hong Kong Observatory (sources disagree on JD anchor offset).
• Zi Wei Dou Shu MVP (12) — /ziwei/{twelve-palaces, main-stars, full-chart, palace-destiny, palace-siblings, palace-spouse, palace-children, palace-wealth, palace-health, palace-travel, palace-career, palace-property}. MVP — palace meanings + 14 main stars list. Full chart deferred (specialized lunar-month ephemeris needed).

API now exposes 505 endpoints — width parity with the broadest competitor (Astrology-API.io).

2026-01-30 — Wellness (+9 endpoints)

Nine wellness endpoints — medical astrology + diet + yoga + crystals etc. Educational use only — not medical advice, disclaimer in every response.

• POST /v1/wellness/medical-astrology — body rulership per traditional Melothesia.
• POST /v1/wellness/diet — food by element (focus / emphasize / avoid).
• POST /v1/wellness/yoga — focus + asanas + pranayama by sign.
• POST /v1/wellness/exercise — intensity + recommended/avoid by element.
• POST /v1/wellness/mental-health — element profile + dominant element + strengths/vulnerabilities/coping.
• POST /v1/wellness/sleep-cycles — moon-phase sleep tips.
• POST /v1/wellness/herbs — herbs by sign’s traditional planetary ruler (Culpeper 1653).
• POST /v1/wellness/crystals — crystals by sign + intentions.
• POST /v1/wellness/cycle — age-based wellness milestones (Saturn return, Uranus opposition, …).

Sources: Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible. Tier — 2 credits (cycle = 1 credit).

2026-01-27 — Mayan calendars (+8 endpoints)

Mayan block: classical Tzolkin + Haab + Long Count + Calendar Round + Lord of the Night, plus Dreamspell (modern Argüelles 1990).

• POST /v1/mayan/tzolkin — 260-day sacred calendar (number 1-13 + 1 of 20 day-names).
• POST /v1/mayan/haab — 365-day civil calendar (18 months × 20 + 5-day Wayeb).
• POST /v1/mayan/long-count — 5-place positional notation baktun.katun.tun.uinal.kin.
• POST /v1/mayan/calendar-round — combined Tzolkin+Haab (52-year cycle).
• POST /v1/mayan/lord-of-night — 9-day cycle (G1-G9).
• POST /v1/mayan/full — all classical components in one call.
• POST /v1/mayan/compatibility — pair compatibility by tone/name/element/direction.
• POST /v1/mayan/dreamspell — modern Argüelles (kin 1-260, tone × seal).

Source: Goodman-Martínez-Thompson correlation (Thompson 1935 + Lounsbury 1976). Validation anchor: 2012-12-21 = Long Count 13.0.0.0.0 ✓ (Bak’tun rollover).

2026-01-23 — Sthira + Shoola Dasha (+10 endpoints)

Two Jaimini rasi-dasha schools with full (maha, antar, pratyantar, sookshma, prana) cascade:

• Sthira — seed = sign of the Brahma planet, MD walks forward 12 signs (7y movable / 8y fixed / 9y dual).
• Shoola — seed = stronger_rasi(asc, asc+6), MD forward 12×9y, optional antardasaSeedOption ∈ 3.

Closes the set of 10 dasha schools × 5 levels = 50 endpoints. Sources: BPHS Adhyayas 49-50 + Jaimini Sutras 2.x.

2026-01-19 — Pet + Business + Financial (+36 endpoints)

Three categories in one shipment:

• Pet (14) — /pet/{birth-chart, sun-sign-meaning, personality, temperament, training-style, diet-by-sign, grooming-by-element, exercise-needs, communication-style, play-style, health-tips, best-names, lucky-day, owner-pet-compatibility}. Disclaimer: entertainment only — not vet care.
• Business (12) — /business/{founder-personality, leadership-style, ideal-industry, founding-chart, electional-day, name-suggestions, team-compatibility, customer-archetype, marketing-style, risk-profile, ideal-partner-sign, expansion-timing}. Disclaimer: strategic ideation, not legal/tax/investment advice.
• Financial (10) — /financial/{investor-archetype, risk-tolerance, spending-style, savings-tips, career-money-style, wealth-house, lucky-numbers, lucky-day, market-timing, wealth-cycle}. ⚠️ NOT INVESTMENT ADVICE — strong disclaimer in every response.

Tier — 2 credits (Financial market-timing / wealth-cycle = 3 credits).

2026-01-16 — Jaimini analysis suite (+10 endpoints)

Ten Jaimini analytical endpoints — chara/naisargika karakas, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK in D9), running dasha summary, basic Jaimini yogas.

Sources: Jaimini Sutras 1-2 + BPHS Adhyayas 26/47.

2026-01-09 — Status page + AI agents + default base URL

• Public status page: https://api.astroway.info/status — uptime, latency p50/p95/p99, cached 60s.
• llms.txt for AI agents: https://api.astroway.info/llms.txt — structured instructions for Claude / ChatGPT / Perplexity Code agents.
• Default base URL across docs, MCP server, SDKs, Postman collection — api.astroway.info/v1 (with 301 redirect from the old api-calc.astroway.info).

2025-12-30 — Tribhagi, Shatabdika, Shodashottari Dashas (+15 endpoints)

Three nakshatra-dasha systems with full cascade:

• Tribhagi — 1/3-scale Vimshottari (40-year cycle).
• Shatabdika — 100-year cycle, 7 planets (no shadow planets).
• Shodashottari — 116-year cycle, 8 planets (Rahu excluded).

Sources: BPHS Adhyaya 46.

2025-12-25 — Credit plans: 5-tier rebalance + Free 5K → 10K

Recalibrated credit tiers after an 18-competitor audit. Free plan now grants 10 000 credits per month (was 5 000). Spend rates for typical use-cases (natal chart + 7 transits) are down ~22%. No breaking API changes — economics only.

2025-12-17 — Chinese Zodiac + Feng Shui Kua (+8 endpoints)

First Chinese astrology chunk, foundational layer (BaZi + Zi Wei Dou Shu coming next):

• POST /v1/chinese/zodiac/animal — animal sign + full pillar (Geng-Wu, Wood-yang, etc.).
• POST /v1/chinese/zodiac/element — fixed + cycling Wu Xing element with yin/yang.
• POST /v1/chinese/zodiac/inner-animal — inner animal (month branch).
• POST /v1/chinese/zodiac/secret-animal — secret animal (hour branch — time required).
• POST /v1/chinese/zodiac/compatibility — pair compatibility from San He trine / Liu Chong conflict pairs.
• POST /v1/chinese/feng-shui/kua — personal Kua number + East/West group.
• POST /v1/chinese/feng-shui/lucky-directions — 4 lucky + 4 unlucky compass directions.
• POST /v1/chinese/feng-shui/bagua — Bagua map of 9 life areas with elements + colors.

Source: 60-jiazi canonical + L. Skinner Living Earth Manual (1976) + Lillian Too. Pricing tier — 2 credits per call. Lichun cutoff = Feb 4 (±1-day accuracy for 1900–2100).

2025-12-09 — Quality pass: 24 bug fixes across Vedic categories

Fixed 24 calculation bugs via 6 parallel deep-research agents. Most critical: Mangal dosha cancellation (own/exalted Mars cancels per BPHS), Pitru dosha trigger (Sun-Saturn vs Sun-Rahu), composite Davison ARMC drift, ACG meridian-line accuracy. Snapshot tests added: 47.

2025-12-02 — Vedic Compatibility + Muhurat (+18 endpoints)

• Compatibility (6) — Ashta-Koota matching (Varna / Vasya / Tara / Yoni / Graha-Maitri / Gana / Bhakoot / Nadi) + Mangal-dosha compat + Bhrigu summary.
• Muhurat (12) — electional astrology for marriage, business, journey, education, surgery, naming, mahurta types (abhijit, vijaya, amrit, brahma).

Sources: BPHS + Muhurta Chintamani.

2025-11-29 — KP (Krishnamurti Paddhati): complete pack (+10 endpoints)

Ten endpoints implementing the canonical KP school (K.S. Krishnamurti 1971).

• /vedic/kp/{cusps, sub-lords, planet-cuspal-position} — Placidus cusps + 4-level sub-lord chain (sign / star / sub / sub-sub).
• /vedic/kp/ruling-planets — Day/Hora + Asc + Moon chain, deduplicated.
• /vedic/kp/horary — KP horary number 1..249 → ASC longitude lookup.
• /vedic/kp/significators — primary / secondary / tertiary per planet.
• /vedic/kp/sub-sub-lord — chain at arbitrary sidereal longitude.
• /vedic/kp/asc-sub — Ascendant sub-lord.
• /vedic/kp/fortuna — Part of Fortune (day/night) + KP chain.
• /vedic/kp/transit-kp — current-moment positions + KP chain.

Algorithm: Vimshottari proportional sub-divisions (27 stars × 9 sub-lords). Sources: K.S. Krishnamurti Reader I-VI (1971-77).

2025-11-22 — Vimshottari + Yogini + Ashtottari + Kalachakra Dashas (+20 endpoints)

Four classical Vedic dasha systems with full (maha, antar, pratyantar, sookshma, prana) cascade:

• Vimshottari — 120-year cycle, 9 planets.
• Yogini — 36-year cycle, 8 yoginis.
• Ashtottari — 108-year cycle, 8 planets (no Ketu), Ardradi tradition.
• Kalachakra — sign-based dasha, paramayu varies per pada (100/85/83/86).

Sources: BPHS Adhyaya 46 + Saravali. Cross-validated against PyJHora 7.02.

2025-11-08 — Chara Dasha (Jaimini K.N. Rao variant) (+5 endpoints)

Jaimini rasi-dasha in the K.N. Rao variant (1995). Direction = forward for movable / dual lagnas, reverse for fixed lagnas. Co-lord rule for Scorpio (Mars+Ketu) and Aquarius (Saturn+Rahu).

2025-10-25 — MCP server + AI gateway

• MCP server @astroway/mcp — Model Context Protocol for Claude Desktop, Cursor, Cody. Every API endpoint is exposed as an MCP tool.
• AI gateway — separate private microservice ai.astroway.info handles LLM requests with a provider chain (Gemini Flash → Groq Llama → OpenRouter → Cerebras → SambaNova → Mistral).
• TypeScript SDK is planned as a separate release — until then, use OpenAPI codegen against https://api.astroway.info/v1/openapi.json (openapi-typescript / openapi-fetch produce a typed client off the 612 typed request/response pairs).

2025-10-08 — Vedic Yogas + Doshas Parashara (+14 endpoints)

• Yogas (7) — Raja, Dhana, Dharma-Karmadhipati, Pancha-Mahapurusha, Gajakesari, Adhi + composite.
• Doshas (7) — Mangal, Kaal Sarp, Pitru, Shrapit, Grahan, Guru-Chandal + composite.

Sources: BPHS Adhyayas 36-39, Phaladeepika.

2025-08-10 — Vedic Vargas D1-D60 + Panchang + Shadbala (+31 endpoints)

• 16 Vargas D1-D60 (16) — from Rasi (D1) to Shashtiamsa (D60), per BPHS Adhyaya 7.
• Panchang (8) — tithi, vara, nakshatra, yoga, karana + sunrise/sunset, abhijit, rahu kaal.
• Shadbala (7) — 6 sources of strength per planet + composite (Sthana, Dig, Kala, Cheshta, Naisargika, Drig).

2025-05-18 — Esoteric dictionaries + Crystal/Angel/Dream (+30 endpoints)

Reference-dictionary expansion: 15 esoteric concepts (chakras, koshas, tattvas, gunas) + 15 crystal / angel / dream lookup tables. Cached on edge (Cloudflare R2).

2025-03-12 — Reference glossary + Tarot Lenormand (+24 endpoints)

• Reference (14) — dictionaries for signs, planets, houses, aspects, nakshatras, fixed stars, Sabian symbols.
• Tarot Lenormand (10) — 36-card system: single, 3-card, 9-card, Grand Tableau, by-question.

2024-11-15 — Tarot Marseille (+20 endpoints)

20 Marseille-deck endpoints: spreads (single, 3-card, Cross, 5-card, Celtic Cross, year-ahead), card meanings, reversed mode, by-question. Sources: Camoin / Jodorowsky public references.

2024-08-25 — Numerology — full pack: Pythagorean + Chaldean + Kabbalistic + Vedic (+40 endpoints)

Four numerology systems × 10 endpoints each: life path, expression, soul urge, personality, birthday, maturity, current personal year/month/day, name compatibility.

Sources: Pythagorean (Cheiro 1908), Chaldean (Cheiro), Kabbalistic Hebrew gematria, Vedic Chaldean Indian.

2024-05-08 — Tarot Rider-Waite-Smith (+35 endpoints)

35 RWS-deck endpoints: every canonical spread (single, 3-card, Celtic Cross, year-ahead, relationship, 5-card horseshoe, 7-card ellipse, decision, situation, monthly), card meanings (upright + reversed), by-question, daily card, deck shuffle.

Sources: Smith images PD since 2021, Waite “Pictorial Key” 1909 PD.

2024-02-20 — AI horoscope generation + interpretations (+12 endpoints)

Natural-language interpretation generation:

• /horoscope/{daily, weekly, monthly} — text horoscopes.
• /interpret/{natal, transit, synastry, compatibility} — detailed interpretations.

Provider chain: GPT-4 → Anthropic Claude → fallback Groq.

2023-11-28 — Destiny Matrix (Ladini) (+1 endpoint)

/destiny-matrix/ladini — Natalia Ladini system (Russian/CIS market). Single-author method shipped with explicit disclaimer.

2023-09-20 — Aspects timeline + harmonics + cyclic index (+12 endpoints)

Expanded aspect analysis:

• /aspect-timeline — exact moments of aspects N days ahead.
• /harmonics/{2..12} — harmonic charts.
• /cyclic-index — André Barbault’s cyclic index of social tensions.
• /sabian-symbols — Marc Edmund Jones 360 symbols.

2023-05-10 — Astrocartography + Local Space + Geodetic (+18 endpoints)

Geo-astrology:

• /acg + /acg-zones — Astrocartography lines per planet.
• /local-space — Local Space horizon.
• /parans — parans (Bernadette Brady).
• /relocation — relocation chart.
• /zenith + /horizon + /geodetic — additional geo engines.
• /ccg-analysis — CCG/CMG detailed geo-analysis.

Sources: Jim Lewis Astro*Carto*Graphy, Sepharial Theory of Geodetic Equivalents, Bernadette Brady.

2023-02-15 — Human Design module (+12 endpoints)

Full Human Design engine:

• /human-design — bodygraph (gates, channels, centers, type, profile, authority, strategy, environment, perspective).
• /hd/incarnation-cross — incarnation cross + 4 gates.
• /hd/{channels, gates, profiles, definition, authority, strategy, environment, perspective, mental-projector, etc}.

Sources: Ra Uru Hu The Human Design System + Chetan Parkyn + Lynda Bunnell.

2022-08-20 — Server-side synastry + composite

Relational astrology (synastry, composite, Davison) implemented server-side. First available via /v1/synastry, /v1/composite, /v1/davison. Marker of expansion into relational analysis.

Validated against Solar Fire / Astrodienst — drift within method tolerance (≤0.5″ on the average calculation).

2022-07-28 — Synastry, composite, Davison + group synastry (+5 endpoints)

• /synastry — relationship comparison with aspects matrix.
• /composite — Robert Hand midpoint composite.
• /davison — Ronald Davison time-place composite.
• /group-synastry — multi-person (3+) synastry matrix.

Sources: Hand Planets in Composite, Davison Synastry, Lois Sargent.

2022-04-15 — app.astroway.info SPA — consumer product live

Launched app.astroway.info — React/TypeScript SPA calling the backend via /v1/*. User accounts, saved charts, favorites. Marker of the transition from website-only to a full product.

The same backend later becomes the foundation of the public API.

2022-03-18 — Essential dignities + receptions + almuten + arabic parts (+13 endpoints)

Classical-tradition astrology:

• /essential-dignities — domicile, exaltation, triplicity, terms, faces.
• /receptions — mutual reception detection.
• /almuten — Almuten Figuris (chart ruler).
• /arabic-parts — Lots of Fortune, Spirit, Eros, Necessity and 30+ other Hellenistic lots.
• /hyleg — hyleg + alcocoden.
• /algol-minimum + /fixed-stars — fixed stars.

Sources: Lilly Christian Astrology + Brennan Hellenistic Astrology.

2021-08-10 — Transit calendar + forecast calendar + phase return (+10 endpoints)

• /transit-calendar — exact transit moments 6/12 months ahead.
• /forecast-calendar — monthly forecasts.
• /phase-return — solar return, lunar return, Saturn return, Jupiter return.
• /eclipse-analysis — eclipses in the context of the natal chart.

2021-04-05 — Aspects calculation + house systems expansion (+8 endpoints)

• /aspects — full aspects matrix with orb tables (Ptolemy, modern, asteroid).
• /coalescent — coalescent points.
• /disposition-chains — planet rulership chains.
• House systems expansion: Placidus, Koch, Equal, Whole, Campanus, Regiomontanus, Topocentric, Porphyry, Alcabitius, Morinus.

2020-07-10 — Aspects matrix + classical aspects

Calculation suite stabilized. /v1/aspects ready: support for conjunction, opposition, square, trine, sextile with Ptolemaic orbs. Foundational for all later analytics (transits, synastry, returns).

Swiss Ephemeris WASM build fully integrated — ~5× faster than the previously used analytical model.

2020-06-15 — Daily/weekly horoscope text (+4 endpoints)

• /horoscope/daily/{sign} — daily horoscope per sign.
• /horoscope/weekly + /horoscope/monthly — weekly / monthly.
• /sun-signs — sun-sign meanings.

Text was authored by a manual editorial team (LLM-augmented texts came later in 2024).

2020-03-20 — Synastry beta + ephemeris extras (+5 endpoints)

• /synastry-beta — initial synastry (full release in 2022).
• /ephemeris/{planets, asteroids, lunar-nodes} — historical 1900-2100.
• /extra — fixed stars, Black Moon Lilith, Chiron.

2020-02-20 — REST API skeleton + OpenAPI 2.0

Internal OpenAPI 2.0 spec published. First /v1/* namespace. Authentication via X-Api-Key header. Rate-limiting infrastructure in place.

Internal milestone — the public API launches later, but the contract has been stable since this point.

2019-12-15 — Internal /chart calculation engine

First server-side /chart implementation (private). Placidus houses, sidereal offsets, planetary positions, fixed stars. Tested against the Astro.com baseline.

Fully Node.js — moved off the previous PHP-only logic.

2019-09-25 — Initial release

The first public release of the AstroWay Astrology API. Baseline functionality:

• /chart — natal chart (planets, houses, ascendant, MC).
• /transit — current transit positions.
• /aspects — primary aspects (conjunctions, oppositions, squares, trines, sextiles).
• /horoscope — daily horoscope (by sun sign).
• /ephemeris — ephemeris for any date.
• /health — health check.

OpenAPI 2.0 specification, REST/JSON, X-Api-Key authentication. Backend on Swiss Ephemeris. Free tier — 1000 requests / month.

2019-09-01 — Swiss Ephemeris integration — the foundation

Swiss Ephemeris 2.x library integrated into the astroway.info backend. Sub-arcsecond accuracy on planetary positions, lunar nodes, asteroids within 1900–2100.

Every subsequent calculation endpoint sits on top of this layer. Same library used by Solar Fire, Kepler, Astro Gold, Astrodienst.