Total Human DesignDashboard|
Documentation

SAGE API

Separate Plan Required

SAGE API is a separate subscription from Advanced Chart — it requires its own API key. An Advanced Chart key cannot access SAGE endpoints. See billing for details.

SAGE (Semantic Astrology & Gene-key Engine) is an AI-mediated knowledge engine with 23,000+ curated Human Design and astrology nodes. Ask natural-language questions and get synthesized, source-backed answers.

Endpoints

EndpointDescription
QueryAsk a question, get an AI-synthesized answer with sources

How it works

  1. Domain detection — Your query is automatically classified as Human Design or Astrology based on keyword analysis
  2. Knowledge retrieval — Matches nodes via direct lookup, text search with synonym expansion, and semantic vector search
  3. AI synthesis — Retrieved knowledge chunks are sent to an LLM that synthesizes a professional, source-backed answer

Unit consumption

Each SAGE query consumes 5 units from your monthly quota.

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.