SAGE API
On the SAGE, Advanced, or Pro tier
SAGE is part of the tier ladder. It is unlocked by the SAGE, Advanced, and Pro tiers, and every key also includes a small Free floor of 25 SAGE responses per month. A Chart-only tier does not unlock SAGE beyond that floor. Subscribe to a tier that covers SAGE, or stack a SAGE subscription on top of your Chart one. See billing for details.
SAGE is an AI-mediated knowledge engine over the curated Total Human Design knowledge base (Human Design, Western astrology, and BaZi). Ask natural-language questions and get synthesized answers as { answer, domain }.
Endpoints
| Endpoint | Description |
|---|---|
| Query | Ask a question, get an AI-synthesized answer (answer + domain) |
How it works
- Domain detection — Your query is automatically classified as Human Design or Astrology based on keyword analysis
- Knowledge retrieval — Matches nodes via direct lookup, text search with synonym expansion, and semantic vector search
- AI synthesis — Retrieved knowledge chunks are sent to an LLM that synthesizes a professional, source-backed answer
SAGE responses
Each answered query counts as 1 SAGE response against your monthly SAGE allowance. A cache hit costs 0 SAGE responses. SAGE responses and Chart requests are separate meters, so a SAGE query never draws down your Chart requests.
Supported topics
SAGE covers the full Human Design and Western Astrology knowledge space:
- Human Design: Types, authorities, profiles, gates (1–64), channels, centers, circuits, incarnation crosses, PHS, Variable
- Astrology: Zodiac signs, planets, houses, aspects, transits, synastry, natal charts
Queries are automatically routed to the correct knowledge domain. Terms like "gate", "channel", and "profile" route to Human Design. Terms like "zodiac", "ascendant", and "conjunction" route to Astrology.