Beta & Roadmap
What's coming, what's in beta, and — just as important — what is not included
in current plans. We'd rather under-promise here than surprise you at integration
time.
In beta (live, included with Advanced keys, not yet guaranteed)
| Capability | Status | Notes |
|---|
| BaZi / Saju (Four Pillars) | Live beta | POST /api/bazi (MCP: get_bazi_chart) — full Four Pillars calculation (Lichun-corrected year boundary, true solar time option, EN/中文/한국어 interpretation). Works with any Advanced key today — see the BaZi docs. Response shape may still evolve; production guarantees come with the official launch. |
| Penta (group dynamics) | Live beta | POST /api/penta (MCP: get_penta) — group field for a family or business team of 3-5 people. 5 chart requests per call. Live beta — see the Penta docs. Response shape may still evolve. |
| Eclipses | Live | GET /api/eclipses (MCP: get_eclipses) — solar + lunar eclipses over a date range. 1 chart request. See the Eclipses docs. |
On the roadmap (not yet available — do not build against these)
| Capability | Status | Notes |
|---|
| Visual rendering API (HD bodygraph SVG/PNG, astrology wheel SVG/PNG) | Planned | Renderers exist in our web products; API endpoints do not exist yet. The only chart image the API serves today is the legacy Saju chart SVG. |
| Vedic / Jyotish | Planned | Not implemented. No sidereal zodiac, ayanamsha, nakshatra, or dasha calculations exist in the engine today. |
| House system selection | Planned | Astrology currently uses Placidus. Whole Sign, Koch, Equal and others are roadmap items. |
| SAGE self-serve | Live | SAGE is now self-serve — subscribe on the Billing page to get a key with the sage_api product. No contact required. |
What "beta" means here
- The endpoint is live and your Advanced key can call it.
- Meter costs (Chart requests or SAGE responses) are real and shown above.
- Response shapes are not yet covered by our no-breaking-changes guarantee.
- We may add fields; we will still never remove endpoints silently.
What "planned" means here
- It does not exist yet. There is no endpoint, no pricing, no date commitment.
- When it ships, it will appear in the changelog and this page moves it to beta.