Check the calling API key: plan, credit balance and when the billing period ends. Run this BEFORE invoking expensive endpoints (Tier 4+ at 100+ credits, Tier 6/7 at 500-5000 credits) to confirm the user has budget. Returns plain-text human-readable summary.

Tool definitions for an agent framework, generated from the live OpenAPI document, so the schema a model fills is the schema the endpoint validates. format=openai (default) returns { type, function } objects you can spread straight into a chat completion; format=anthropic returns { name, description, input_schema }. The objects carry nothing of ours: how to call each tool lives in a separate executors map keyed by tool name, because an unexpected key inside a vendor tool object is a 400 at their end.

[Group: Agent Platform] [Endpoint: GET /v1/agent/tools] [Cost: see your plan — endpoint not in the public credit manifest]

AI interpretation of a single chart element (planet/house/aspect) in context. Useful for chart-detail pages.

[Group: AI Interpretations] [Endpoint: POST /v1/interpret/element] [Cost: 100 credits (Tier 4)]

Generate AI interpretation of a natal chart: personality traits, life themes, strongest archetypes. Multi-language. Token-cached for repeats.

[Group: AI Interpretations] [Endpoint: POST /v1/interpret/natal] [Cost: 100 credits (Tier 4)]

AI interpretation of a specific planet+sign+house combination: concise, focused on the placement only.

[Group: AI Interpretations] [Endpoint: POST /v1/interpret/placement] [Cost: 100 credits (Tier 4)]

AI interpretation of synastry between two charts: relationship dynamics, attractions, friction points, long-term outlook.

[Group: AI Interpretations] [Endpoint: POST /v1/interpret/synastry] [Cost: 100 credits (Tier 4)]

AI reading of a tarot, Marseille or Lenormand spread: each position read in context, then a synthesis of the whole spread and one piece of advice. Takes card slugs or the drawn array of any draw response. Multi-language.

[Group: AI Interpretations] [Endpoint: POST /v1/interpret/tarot] [Required: cards] [Cost: 100 credits (Tier 4)]

AI interpretation of current/upcoming transits to a natal chart: what each major transit means in life context.

[Group: AI Interpretations] [Endpoint: POST /v1/interpret/transits] [Cost: 100 credits (Tier 4)]

Calculate antiscia (mirror points along the Cancer/Capricorn axis) and contra-antiscia, plus their aspects to natal planets.

[Group: Aspects & Points] [Endpoint: POST /v1/antiscia] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Calculate Arabic parts (Lots) from a natal chart. Returns positions for standard lots (Fortune, Spirit, etc.) and any custom formula.

[Group: Aspects & Points] [Endpoint: POST /v1/arabic-parts] [Cost: 20 credits (Tier 2)]

Transform aspect timelines into Gantt-style bars grouped by transit planet. Each bar shows the duration an aspect is in orb, with exact dates marked. Useful for visual transit calendars.

[Group: Aspects & Points] [Endpoint: POST /v1/aspect-bar] [Required: startDate, endDate] [Cost: 10 credits (Tier 1)]

Calculate a timeline of when two specific planets form an exact aspect within a date range, including enter/exact/leave dates.

[Group: Aspects & Points] [Endpoint: POST /v1/aspect-timeline] [Required: startDate, endDate] [Cost: 100 credits (Tier 4)]

Positions of fixed stars at the birth moment (36 classic stars, or the names in stars), and the conjunctions of natal planets with them within orb degrees (default 1, at most 5), closest first.

[Group: Aspects & Points] [Endpoint: POST /v1/fixed-stars] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

The star names this API accepts, from our fixed-star catalogue (953 stars): traditional name, Bayer nomenclature, constellation and magnitude, with the 36-star astrological default set flagged. Optional ?maxMagnitude= trims to the bright end. Static lookup, no chart needed.

[Group: Aspects & Points] [Endpoint: GET /v1/fixed-stars/catalog] [Cost: 5 credits (Tier ½)]

Calculate Gauquelin sector positions (1–36) for all planets, indicating whether each planet is in a power zone.

[Group: Aspects & Points] [Endpoint: POST /v1/gauquelin-sectors] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Calculate all planetary midpoints and their zodiac positions. Optionally include midpoint aspects to natal points.

[Group: Aspects & Points] [Endpoint: POST /v1/midpoints] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Calculate Uranian midpoint trees and planetary pictures (symmetries) for each focal planet within a given orb.

[Group: Aspects & Points] [Endpoint: POST /v1/midpoint-trees] [Cost: 20 credits (Tier 2)]

Calculate parallel (same declination) and contra-parallel (opposite declination) aspects between all planets within orb.

[Group: Aspects & Points] [Endpoint: POST /v1/parallel-aspects] [Cost: 20 credits (Tier 2)]

Return the Sabian symbol (Dane Rudhyar) for each given ecliptic longitude.

[Group: Aspects & Points] [Endpoint: POST /v1/sabian-symbols] [Required: longitudes] [Cost: 10 credits (Tier 1)]

The four pillars with everything the classical apparatus reads off them in one call: hidden stems, na yin, the twelve stages of the day master, element balance over all eight characters, the strength verdict, symbolic stars from both reference pillars, and the branch and stem interactions. Localised by language. Pass longitude with trueSolarTime true to cut the double-hour from the sun over the birth place; the correction reaches the day and hour only, never the year and month, which turn on world instants.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/chart] [Required: date] [Cost: 20 credits (Tier 2)]

Day stem element + yin/yang polarity + canonical archetype description. The "self" character in BaZi from which all other pillars are interpreted.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/day-master] [Required: date] [Cost: 10 credits (Tier 1)]

Element balance across the whole chart. The balance object opens the branches and counts all eight characters three ways: visible, with every hidden stem, and weighted so the total stays at eight. The top-level elementCounts, dominantElement and missingElements are DEPRECATED (year and month only, four characters, branches unopened) and keep answering unchanged until 2027-09-08; the response carries RFC 8594 Deprecation and Sunset headers.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/element-balance] [Required: date] [Cost: 10 credits (Tier 1)]

All four pillars: year, month, day, hour. Day pillar uses the canonical 60-jiazi cycle (anchor 1990-01-01 = Bing-Yin). Pass time to compute the hour pillar; day and hour roll at 23:00 local, year and month at the exact Lichun and 節 instants.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/four-pillars] [Required: date] [Cost: 10 credits (Tier 1)]

The one to three stems each branch shelters, with role and weight. This is where most of a chart's elements live: a chart with no visible Water can still be soaked in it. On the four storage branches the middle role belongs to the stored element, not to the second in the list.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/hidden-stems] [Required: date] [Cost: 10 credits (Tier 1)]

Hour pillar via 五鼠遁 (Five-Rats-Escape) day-stem → hour-stem table. The Zi hour opens the day at 23:00 local time.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/hour-pillar] [Required: date, time] [Cost: 10 credits (Tier 1)]

Stem combinations, six harmonies, full and half trines, three-branch seasons (三會), clashes, harms, punishments and self-punishments present in the chart, with the pillars involved and the element a combination produces.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/interactions] [Required: date] [Cost: 10 credits (Tier 1)]

A stem read against each branch as a life cycle, from Chang Sheng through Di Wang to Jue. The day master through the chart; pass includeFullTable for the ten-by-twelve reference table. stageSchool picks the classical yin-reverse rule or the unified one.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/life-stages] [Required: date] [Cost: 10 credits (Tier 1)]

10-year luck pillars sequence. Direction by gender + year-stem polarity per Ziping canon.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/luck-pillars] [Required: date, gender] [Cost: 10 credits (Tier 1)]

Same Sheng-Ke + branch-clash analysis as yearly, but applied to a specific calendar month. Month branch resolved via mid-month jieqi.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/monthly] [Required: natalDate, targetYear, targetMonth] [Cost: 10 credits (Tier 1)]

Month stem + branch from solar-term boundaries.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/month-pillar] [Required: date] [Cost: 10 credits (Tier 1)]

The sound-element of each pillar. The sixty jiazi collapse into thirty names, two consecutive pillars to a name; the year pillar na yin is what popular readings mean by "your element", and it is not the day master.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/na-yin] [Required: date] [Cost: 10 credits (Tier 1)]

The support-and-suppress reading over the weighted hidden-stem count, with the three classical criteria (season, root, allies) reported unweighted and the favourable elements that follow. The caveat names both limits: the month is counted like any other branch, and the cut points are this API's convention.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/strength] [Required: date] [Cost: 10 credits (Tier 1)]

Peach Blossom, Travelling Horse, Canopy, Heavenly Nobleman, Blade and Void, computed from BOTH the year and the day reference pillar because the transmissions disagree about which one the rules read from. Where two transmissions place a star differently, both placements ship and each names the other.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/symbolic-stars] [Required: date] [Cost: 10 credits (Tier 1)]

Ten Gods classification per day master. Bi Jian/Jie Cai (peer), Shi Shen/Shang Guan (output), Pian Cai/Zheng Cai (wealth), Qi Sha/Zheng Guan (officer), Pian Yin/Zheng Yin (resource).

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/ten-gods] [Required: date] [Cost: 10 credits (Tier 1)]

Compares target year pillar against natal day master + natal year branch. Returns element-flow relation (companion / mother / output / control / wealth) per Sheng-Ke cycle, branch clashes (六冲), and trine support (三合).

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/yearly] [Required: natalDate, targetYear] [Cost: 10 credits (Tier 1)]

Year stem + branch + animal + element with yin/yang.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/year-pillar] [Required: date] [Cost: 10 credits (Tier 1)]

10 consecutive year pillars from a given starting year.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/year-pillar-decade] [Required: startYear] [Cost: 10 credits (Tier 1)]

Native customer persona that resonates with the founder's sun-sign brand voice.

[Group: Business Astrology] [Endpoint: POST /v1/business/customer-archetype] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Suitability of a proposed launch date for the venture type.

[Group: Business Astrology] [Endpoint: POST /v1/business/electional-day] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

High-level expansion guidance; pair with /transits for actual windows.

[Group: Business Astrology] [Endpoint: POST /v1/business/expansion-timing] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Founder type + strengths/weaknesses + ideal industry.

[Group: Business Astrology] [Endpoint: POST /v1/business/founder-personality] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Treat the proposed founding date as a chart; returns sun/moon/ASC + theme.

[Group: Business Astrology] [Endpoint: POST /v1/business/founding-chart] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Industries best suited to this founder profile.

[Group: Business Astrology] [Endpoint: POST /v1/business/ideal-industry] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Trine elemental partners with natural synergy.

[Group: Business Astrology] [Endpoint: POST /v1/business/ideal-partner-sign] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Concise leadership archetype + key strengths.

[Group: Business Astrology] [Endpoint: POST /v1/business/leadership-style] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Element-based marketing voice and campaign style.

[Group: Business Astrology] [Endpoint: POST /v1/business/marketing-style] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Naming hints (syllable structure, palette, semantic field) by sign.

[Group: Business Astrology] [Endpoint: POST /v1/business/name-suggestions] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Element-based risk tolerance + recommended safeguards.

[Group: Business Astrology] [Endpoint: POST /v1/business/risk-profile] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Founder × partner compatibility score.

[Group: Business Astrology] [Endpoint: POST /v1/business/team-compatibility] [Required: founder, partner] [Cost: 10 credits (Tier 1)]

Find the nearest minimum brightness moment of Algol (Beta Persei), the eclipsing variable star, within a date range.

[Group: Calendar & Cycles] [Endpoint: POST /v1/algol-minimum] [Required: startDate, endDate] [Cost: 10 credits (Tier 1)]

Find the single nearest Algol brightness minimum before or after a given date.

[Group: Calendar & Cycles] [Endpoint: POST /v1/algol-minimum/nearest] [Required: date] [Cost: 10 credits (Tier 1)]

Standalone aspect calculation: full inter-planetary aspect list with type / exactAngle / orb / isApplying. Uses per-pair astro.com orb matrix. Same calcAspects() as /chart but without planet positions / houses / midpoints overhead.

[Group: Calendar & Cycles] [Endpoint: POST /v1/aspects] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Calculate the André Barbault Cyclic Index, sum of all outer planet separations, for a date range to indicate global crisis periods.

[Group: Calendar & Cycles] [Endpoint: POST /v1/cyclic-index] [Required: startYear, endYear] [Cost: 100 credits (Tier 4)]

Find solar and lunar eclipses within a given year or multi-year range. Returns type, date, and geographic visibility data.

[Group: Calendar & Cycles] [Endpoint: POST /v1/eclipses] [Required: year] [Cost: 100 credits (Tier 4)]

Standalone house calculation: 12 cusps + ascendant + MC + ARMC + vertex + co-asc + polar-asc. Supports Placidus, Koch, Regiomontanus, Campanus, Topocentric, Whole Sign, Equal, Porphyry, Morinus etc. Auto-fallback warning on |lat|>66.5° quadrant systems.

[Group: Calendar & Cycles] [Endpoint: POST /v1/houses] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Find all sign ingresses for a planet within a date range (including retrograde re-entries).

[Group: Calendar & Cycles] [Endpoint: POST /v1/ingresses] [Required: planetId, startDate, endDate] [Cost: 100 credits (Tier 4)]

Calculate a lunar calendar for a given month: Moon sign per day, lunar phases, void-of-course windows, and perigee/apogee.

[Group: Calendar & Cycles] [Endpoint: POST /v1/lunar-calendar] [Required: year, month] [Cost: 100 credits (Tier 4)]

Calculate all aspects the Moon makes within a date range (applying and separating), useful for electional and horary work.

[Group: Calendar & Cycles] [Endpoint: POST /v1/moon-aspects] [Required: year, month] [Cost: 100 credits (Tier 4)]

Current moon phase at a given moment: illumination %, age in days, elongation, waxing/waning, sun + moon zodiac signs. Geocentric Sun-Moon elongation per Meeus Ch.48.

[Group: Calendar & Cycles] [Endpoint: POST /v1/moon-phase] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Find Moon void-of-course periods within a date range. The Moon is VOC from its last aspect until it enters the next sign.

[Group: Calendar & Cycles] [Endpoint: POST /v1/moon-voc] [Required: date, time] [Cost: 10 credits (Tier 1)]

Find all conjunctions between two planets within a date range, defining the start of a new synodic cycle.

[Group: Calendar & Cycles] [Endpoint: POST /v1/planetary-cycles] [Required: planet1Id, planet2Id, startDate, endDate] [Cost: 100 credits (Tier 4)]

Chaldean planetary hours for a date and place: 12 from sunrise to sunset and 12 from sunset to sunrise, so an hour is rarely 60 minutes. startHour and endHour are decimal local hours. Send atLocalHour (decimal local time, e.g. 15.2 for 15:12) to have the hour containing it marked isCurrent; without it no hour carries the field, because the answer is cacheable and a flag from the server clock would be stale by the time it renders.

[Group: Calendar & Cycles] [Endpoint: POST /v1/planetary-hours] [Required: date, latitude, longitude] [Cost: 10 credits (Tier 1)]

Calculate the synodic phase of each planet relative to the Sun (new, crescent, first quarter, gibbous, full, disseminating, last quarter, balsamic).

[Group: Calendar & Cycles] [Endpoint: POST /v1/planetary-phases] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Retrograde periods of the planets in planetIds (default Mercury) within a date range: the two stations and their longitudes, plus shadowStart (the planet first reaches the longitude of its direct station) and shadowEnd (it regains the longitude of its retrograde station).

[Group: Calendar & Cycles] [Endpoint: POST /v1/retrograde-periods] [Required: startDate, endDate] [Cost: 50 credits (Tier 3)]

The nine annual stars for a solar year, plus Tai Sui, Sui Po, San Sha, the five yellow and the two black with the sectors they occupy. Optionally the monthly layer. The year turns at Li Chun, computed from the exact solar term.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/feng-shui/annual-stars] [Cost: 10 credits (Tier 1)]

Eastern-school Bagua mapping of 9 life areas (career, knowledge, family, wealth, fame, relationships, children, helpful-people, health) onto compass sectors.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/feng-shui/bagua] [Required: date, gender] [Cost: 10 credits (Tier 1)]

The nine-palace natal chart of a building: mountain star, period star and facing star per sector, the named arrangement (旺山旺水 and the other three), and the special patterns. Send the facing in degrees or as one of the 24 mountains, and the period directly or as the date the building was occupied. Neither is defaulted.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/feng-shui/flying-star] [Cost: 10 credits (Tier 1)]

Personal Kua number from solar-year digit sum + gender. Maps to East/West group for direction work.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/feng-shui/kua] [Required: date, gender] [Cost: 10 credits (Tier 1)]

Personal 4 lucky + 4 unlucky compass directions from Kua. Standard Pa Kua mapping.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/feng-shui/lucky-directions] [Required: date, gender] [Cost: 10 credits (Tier 1)]

Chinese lunar month and day for a Gregorian date, including leap-month detection, plus the Chinese New Year of that year.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/lunar-date] [Required: date] [Cost: 10 credits (Tier 1)]

The 24 solar terms of a Chinese solar year as exact instants, in UTC and Beijing time. Twelve of them open a BaZi pillar month; the other twelve decide where a leap month falls.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/solar-terms] [Required: year] [Cost: 10 credits (Tier 1)]

The almanac reading of one day: day pillar, the day officer (建除十二神) with what the register endorses and forbids, the 28 mansion with its quadrant and planet, and the animal the day clashes.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/tong-shu] [Required: date] [Cost: 10 credits (Tier 1)]

Walk a date range and return the days the almanac endorses for one activity, each with the officer that decided it. Optionally drop the days that clash a person's animal. Range capped at 366 days and a longer one is refused, not truncated.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/tong-shu/select] [Required: from, to, activity] [Cost: 20 credits (Tier 2)]

The clock corrected to the sun over the birth longitude, split into the meridian term and the equation of time. China runs one zone across sixty degrees, so a Kashgar birth reads nearly three hours from solar noon on a Beijing clock, which moves the hour pillar.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/true-solar-time] [Required: date, time, timezoneOffset, longitude] [Cost: 10 credits (Tier 1)]

Animal sign of the birth year, bounded by the exact Lichun instant, plus the full pillar (stem + branch + element). yearStart and yearEnd are the two Lichun instants that bound the solar year, in UTC and Beijing time. Pass time + timezoneOffset for births on the boundary day.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/zodiac/animal] [Required: date] [Cost: 10 credits (Tier 1)]

Pair compatibility score (0-100) using San He trine + Liu Chong conflict-pair canon.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/zodiac/compatibility] [Required: person1, person2] [Cost: 10 credits (Tier 1)]

Fixed-branch element + cycling-stem element + yin/yang for given solar year.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/zodiac/element] [Required: date] [Cost: 10 credits (Tier 1)]

Month-branch animal: represents inner motivations and private self.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/zodiac/inner-animal] [Required: date] [Cost: 10 credits (Tier 1)]

Hour-of-birth branch animal: represents the deepest self. Requires birth time.

[Group: Chinese: Zodiac & Feng Shui] [Endpoint: POST /v1/chinese/zodiac/secret-animal] [Required: date] [Cost: 10 credits (Tier 1)]

Translate one text into any of 21 languages with astrology-domain glossary pinning. Source defaults to English; pass source_lang to override. Credits: 15 + ceil(chars/40). Max 3000 chars.

[Group: Content Localization] [Endpoint: POST /v1/translate/astro] [Required: text, target_lang] [Cost: 16 credits (Tier 1)]

Translate up to 25 strings (≤2000 chars each, ≤20000 total) sharing one target language + domain. Credits: 15 + ceil(total_chars/40).

[Group: Content Localization] [Endpoint: POST /v1/translate/batch] [Required: items, target_lang] [Cost: 16 credits (Tier 1)]

Download the astrology glossary for a target language. Query: ?source= (default en), ?domain= (default generic). Free (0 credits).

[Group: Content Localization] [Endpoint: GET /v1/translate/glossary/{lang}] [Required: lang] [Cost: see your plan — endpoint not in the public credit manifest]

List the 21 supported language codes + names. Free (0 credits).

[Group: Content Localization] [Endpoint: GET /v1/translate/languages] [Cost: see your plan — endpoint not in the public credit manifest]

Ebertin cosmogram render data.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/cosmogram] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

All chart points in 90° cardinal modulus.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/dial-90] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

22.5° / 45° / 67.5° / 90° / 135° aspects.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/eight-harmonic-aspects] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Lefeldt-Brummund 22.5° subdivisions.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/lefeldt-extensions] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

A=B/C structures with sentence form.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/midpoint-pictures] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Tree per personal point.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/personal-point-tree] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Ebertin's personal points midpoint hits.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/sensitive-points] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Transits hitting natal midpoints in 90° dial.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/transit-midpoints] [Required: date, time, latitude, longitude, targetDate] [Cost: 10 credits (Tier 1)]

8 Hamburg trans-Neptunian bodies.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/uranian-tnps] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Witte planetary pictures A+B−C=D.

[Group: Cosmobiology / Hamburg School] [Endpoint: POST /v1/cosmobiology/witte-formulas] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Estimate the credit cost of one or more endpoints WITHOUT invoking them. Returns total + per-endpoint breakdown with tier annotations. Useful when planning multi-step workflows: estimate first, ask user confirmation, then invoke. Cache TTL 5 min.

The core of the Destiny Matrix per Natalia Ladini's method from a birth date: the personal square (pointA day, pointB month, pointC year digits, pointD bottom = A+B+C, pointE centre = A+B+C+D), the ancestral square corners, the sky (B+D) and earth (A+C) lines and the personal purpose, each with its arcanum. Numbers above 22 are reduced by summing digits. karmicTail, loveLine and moneyLine give the three arcana of each chain read from the centre outward, with code ("3-7-22"); the love and money channels share the crossing point.

[Group: Destiny Matrix] [Endpoint: POST /v1/destiny-matrix/ladini] [Required: date] [Cost: 20 credits (Tier 2)]

Calculate the Almuten Figuris: the planet with the highest essential dignity score across the key chart positions.

[Group: Dignities & Receptions] [Endpoint: POST /v1/almuten] [Cost: 20 credits (Tier 2)]

Calculate planetary disposition chains: the recursive sequence of sign rulers leading to the final dispositor.

[Group: Dignities & Receptions] [Endpoint: POST /v1/disposition-chains] [Cost: 20 credits (Tier 2)]

Return disposition chains with computed x/y layout coordinates for graph visualization.

[Group: Dignities & Receptions] [Endpoint: POST /v1/disposition-chains/layout] [Cost: 20 credits (Tier 2)]

Calculate the five Ptolemaic essential dignities (rulership, exaltation, triplicity, term, face) and debilities for each planet.

[Group: Dignities & Receptions] [Endpoint: POST /v1/essential-dignities] [Cost: 20 credits (Tier 2)]

Calculate the Hyleg (apheta, giver of life) and Alcocoden (indicator of lifespan) using traditional Hellenistic method.

[Group: Dignities & Receptions] [Endpoint: POST /v1/hyleg] [Cost: 20 credits (Tier 2)]

Find mutual receptions between planets: pairs where each planet is in a sign ruled, exalted, or in the dignity of the other.

[Group: Dignities & Receptions] [Endpoint: POST /v1/receptions] [Cost: 20 credits (Tier 2)]

Full angel number catalogue (singles, masters, repeating, mirror, sequential patterns) with short and full meanings, themes.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/angel-numbers] [Cost: 5 credits (Tier ½)]

Angel numbers aligned to a given life-path number (1-9, 11, 22, 33). Useful to identify recurring numerical signatures aligned with one's soul path.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/angel-numbers/by-life-path/{n}] [Required: n] [Cost: see your plan — endpoint not in the public credit manifest]

Decode a numeric sequence in optional life context. Returns pattern classification, exact match, and reduced single-digit meaning.

[Group: Esoteric] [Endpoint: POST /v1/esoteric/angel-numbers/decode] [Required: sequence] [Cost: 10 credits (Tier 1)]

Look up the meaning of a specific angel number sequence. Falls back to numerological reduction if not in catalogue.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/angel-numbers/{number}] [Required: number] [Cost: see your plan — endpoint not in the public credit manifest]

Compute today's personal angel number from date (digit-sum reduced to single digit). Optional ?date=YYYY-MM-DD query.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/angel-numbers/today] [Cost: 5 credits (Tier ½)]

Reference list of crystals with chakra, zodiac, planet, element, hardness, and purpose tags. Returns chakra and purpose taxonomies for filtering.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/crystals] [Cost: 5 credits (Tier ½)]

Crystals indexed for a given chakra (Root / Sacral / Solar Plexus / Heart / Throat / Third Eye / Crown).

[Group: Esoteric] [Endpoint: GET /v1/esoteric/crystals/by-chakra/{chakra}] [Required: chakra] [Cost: see your plan — endpoint not in the public credit manifest]

Crystals whose traditional planetary correspondence is the given planet (sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, earth).

[Group: Esoteric] [Endpoint: GET /v1/esoteric/crystals/by-planet/{planet}] [Required: planet] [Cost: see your plan — endpoint not in the public credit manifest]

Crystals indexed by intent keyword (love, prosperity, healing, protection, etc.). Substring-matches against purpose tags.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/crystals/by-purpose/{purpose}] [Required: purpose] [Cost: see your plan — endpoint not in the public credit manifest]

Crystals indexed for a given zodiac sign (case-insensitive English name).

[Group: Esoteric] [Endpoint: GET /v1/esoteric/crystals/by-zodiac/{sign}] [Required: sign] [Cost: see your plan — endpoint not in the public credit manifest]

Recommend crystals scored against natal sign placements (Sun/Moon/Asc) and intent keywords. Returns top-N matches with score.

[Group: Esoteric] [Endpoint: POST /v1/esoteric/crystals/recommend] [Cost: 10 credits (Tier 1)]

DEPRECATED: RED quality (oral Zoroastrian tradition, scattered manuscripts, no canonical reference). Still works until its 2027-06-15 sunset (12-month, per the /v1 stability policy), then will be removed. Migrate to broader /reference endpoints or remove the dependency. Calculate Djamaspa planetary positions for date.

[Group: Esoteric] [Endpoint: POST /v1/djamaspa] [Required: date] [Cost: 10 credits (Tier 1)] [⚠️ DEPRECATED — will be removed in a future API version. Avoid using.]

Full dream symbol dictionary with category, element, archetype, common and shadow meanings, and recurring-dream readings.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/dreams] [Cost: 5 credits (Tier ½)]

Dream symbols indexed by element (fire / earth / air / water / spirit).

[Group: Esoteric] [Endpoint: GET /v1/esoteric/dreams/by-element/{element}] [Required: element] [Cost: see your plan — endpoint not in the public credit manifest]

Scan dream narrative text for known symbols. Returns matched symbols with their meanings (recurring or single-event).

[Group: Esoteric] [Endpoint: POST /v1/esoteric/dreams/decode] [Required: text] [Cost: 10 credits (Tier 1)]

Up to 100 dated dream entries searched for every directory symbol and recurring theme as a whole word: per symbol the number of entries, first and last date, the dates, whether it recurs and its trend (later half against earlier half), with the recurring-dream reading when it repeats.

[Group: Esoteric] [Endpoint: POST /v1/esoteric/dreams/journal] [Required: entries] [Cost: 10 credits (Tier 1)]

Catalogue of common recurring dream themes (falling, naked in public, losing teeth, being chased) with universal psychological meanings.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/dreams/recurring-themes] [Cost: 5 credits (Tier ½)]

Look up a dream symbol by keyword. Exact match if available, otherwise partial substring matches.

[Group: Esoteric] [Endpoint: GET /v1/esoteric/dreams/symbol/{keyword}] [Required: keyword] [Cost: see your plan — endpoint not in the public credit manifest]

DEPRECATED: legacy un-namespaced random hexagram cast. Superseded by the /iching/* namespace: /iching/throw-coins (seeded + reproducible), /iching/by-question, /iching/with-changing-lines, /iching/daily, /iching/lookup/{n}, all on the Wilhelm-Baynes hexagram set. Still works until its 2027-06-16 sunset, then removed. Casts a single I Ching hexagram (input ignored).

[Group: Esoteric] [Endpoint: POST /v1/iching] [Cost: 10 credits (Tier 1)] [⚠️ DEPRECATED — will be removed in a future API version. Avoid using.]

Full NN/SN with rulers + conjuncts.

[Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/nodal-axis-detail] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

JWG: Pluto sign+house+ruler+hard aspects.

[Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/pluto-natal-condition] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Planets squaring nodal axis = unfinished karma.

[Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/skipped-steps] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

JWG's 4-type by Pluto house quadrant.

[Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/soul-types] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Forrest 2008 past-life method.

[Group: Evolutionary Astrology] [Endpoint: POST /v1/evolutionary/yesterday-sky] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Multi-generational family pattern map.

[Group: Family Astrology] [Endpoint: POST /v1/family/genogram] [Required: grandparent, parent, child] [Cost: 10 credits (Tier 1)]

Deep parent-child synastry analysis.

[Group: Family Astrology] [Endpoint: POST /v1/family/parent-child-deep] [Required: parent, child] [Cost: 10 credits (Tier 1)]

Saturn return timing across a family cohort.

[Group: Family Astrology] [Endpoint: POST /v1/family/saturn-return-cycles] [Required: members] [Cost: 10 credits (Tier 1)]

Inter-sibling synastry and dynamics.

[Group: Family Astrology] [Endpoint: POST /v1/family/sibling-dynamics] [Required: sibling1, sibling2] [Cost: 10 credits (Tier 1)]

System-level family astrological signatures.

[Group: Family Astrology] [Endpoint: POST /v1/family/system-pattern] [Required: members] [Cost: 10 credits (Tier 1)]

Income / earning archetype by sign.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/career-money-style] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Investor type + bias + strength + pitfall by sign.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/investor-archetype] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Days traditionally aligned with the sign.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/lucky-day] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Gematria-style number set per sign.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/lucky-numbers] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Generic caution windows (Mercury Rx, eclipses, Mars Rx, major macro aspects).

[Group: Financial Astrology] [Endpoint: POST /v1/financial/market-timing] [Required: date] [Cost: 10 credits (Tier 1)]

Element-based risk tolerance + suggested allocation buckets.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/risk-tolerance] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Element-based saving recommendations.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/savings-tips] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Sign-specific spending pattern.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/spending-style] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Long-cycle archetype tied to Jupiter (~12y) and Saturn (~29y) returns.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/wealth-cycle] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Personal money (2nd) and shared resources (8th) house cusps + signs.

[Group: Financial Astrology] [Endpoint: POST /v1/financial/wealth-house] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Calculate ACG lines for all planets: the geodetic map lines where each planet was on an angle at birth.

[Group: Astro-Geography] [Endpoint: POST /v1/acg] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Rank cities against the astrocartography lines of a chart for one of the 19 life categories. Distance to a line is computed from the body hour angle and altitude rather than against a discretised polyline, so it is exact: the distance to a horizon line IS the altitude in degrees of arc, and a meridian line offset is the hour angle times cos(latitude). Supportive and challenging totals are returned separately with every contributing line and its distance, so a strong-but-turbulent city is distinguishable from an average one. Bundled GeoNames set of 34,028 places above 15,000 people.

[Group: Astro-Geography] [Endpoint: POST /v1/acg/best-places] [Cost: 50 credits (Tier 3)]

ACG lines that govern one area of life, ranked by astrological weight and, when a point is supplied, by proximity to it. Returns curated interpretation text per line in 11 languages.

[Group: Astro-Geography] [Endpoint: POST /v1/acg/by-category] [Cost: 50 credits (Tier 3)]

Reference taxonomy: 19 areas of life, each naming the planet-and-angle lines that govern it with a weight and a polarity. Free, cacheable, drives the two endpoints below.

[Group: Astro-Geography] [Endpoint: GET /v1/acg/categories] [Cost: see your plan — endpoint not in the public credit manifest]

Which countries the bundled city list can rank, and how many qualifying cities each has. Asking for a country with two cities and getting two results should not look like a bug.

[Group: Astro-Geography] [Endpoint: GET /v1/acg/countries] [Cost: 5 credits (Tier ½)]

One line in full: its geometry, every life area it touches with weight and polarity, and the interpretation text for that planet-and-angle pair. Rising and setting curves arrive as several disjoint segments; all of them are returned.

[Group: Astro-Geography] [Endpoint: POST /v1/acg/line-report] [Cost: 20 credits (Tier 2)]

ACG lines passing within radiusDeg of one location, with the angular distance to each. The "what runs over this city" lookup.

[Group: Astro-Geography] [Endpoint: POST /v1/acg-zones] [Cost: 50 credits (Tier 3)]

Analyse Cyclo-Carto-Graphy (CCG) lines: progressed ACG lines at a target date with mundane/local aspects and latitude crossings.

[Group: Astro-Geography] [Endpoint: POST /v1/ccg-analysis] [Cost: 100 credits (Tier 4)]

Analyse the impact of upcoming eclipses on a natal chart: aspects to natal planets, house activations, and Saros series context.

[Group: Astro-Geography] [Endpoint: POST /v1/eclipse-analysis] [Cost: 100 credits (Tier 4)]

Convert geographic coordinates to geodetic chart degrees (Sepharial method): each longitude maps to a zodiac degree on the Earth's surface.

[Group: Astro-Geography] [Endpoint: POST /v1/geodetic] [Required: latitude, longitude] [Cost: 10 credits (Tier 1)]

Calculate local space chart: azimuth and altitude of each planet from a given geographic location at the birth moment.

[Group: Astro-Geography] [Endpoint: POST /v1/local-space] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Calculate the local space influence zone lines for a chart relocated to a specific city: lines on the map showing planet directions from that location.

[Group: Astro-Geography] [Endpoint: POST /v1/local-space/influence-zone] [Required: latitude, longitude, azimuth] [Cost: 50 credits (Tier 3)]

Gain, profit, abundance.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/acquisitio] [Cost: 10 credits (Tier 1)]

Wisdom, peace, clarity.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/albus] [Cost: 10 credits (Tier 1)]

Loss, letting go, slipping away.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/amissio] [Cost: 10 credits (Tier 1)]

Dragon's Head: beginnings, threshold.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/caput-draconis] [Cost: 10 credits (Tier 1)]

Restriction, confinement, isolation.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/carcer] [Cost: 10 credits (Tier 1)]

Dragon's Tail: endings, exit.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/cauda-draconis] [Cost: 10 credits (Tier 1)]

Union, meeting, partnership.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/coniunctio] [Cost: 10 credits (Tier 1)]

Greater Fortune: lasting success.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/fortuna-major] [Cost: 10 credits (Tier 1)]

Lesser Fortune: quick gains.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/fortuna-minor] [Cost: 10 credits (Tier 1)]

Happiness, optimism, healing.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/laetitia] [Cost: 10 credits (Tier 1)]

Crowd, gathering, public.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/populus] [Cost: 10 credits (Tier 1)]

Beauty, harmony, love.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/puella] [Cost: 10 credits (Tier 1)]

Young man, energy, impulse.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/puer] [Cost: 10 credits (Tier 1)]

Passion, anger, blood: ill omen.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/rubeus] [Cost: 10 credits (Tier 1)]

Sadness, depression, melancholy.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/tristitia] [Cost: 10 credits (Tier 1)]

Movement, change, journey.

[Group: Geomancy (Agrippa)] [Endpoint: POST /v1/geomancy/via] [Cost: 10 credits (Tier 1)]

Crossing points of two ACG lines: the places where two planets were simultaneously angular. Returns every planet-to-planet crossing with its coordinates.

[Group: Astro-Geography] [Endpoint: POST /v1/parans] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Latitudes where a fixed star and a planet are angular at the same moment, which is how Brady tabulates a paran: not a place, a latitude. Twelve event pairs per star and planet (rise, set, culminate, anticulminate, minus meridian against meridian, which is a shared right ascension rather than a paran). Each row carries the houses of the technique in plain form: which body does what, the latitude, and the meridian where it happens at this chart moment. Solved on hour angles rather than by intersecting map polylines, so the latitude is exact rather than quantised to the polyline step.

[Group: Astro-Geography] [Endpoint: POST /v1/parans/star] [Cost: 50 credits (Tier 3)]

Find dates when a planet returns to its same synodic phase relative to the Sun (e.g. next Venus heliacal rising, next Mars retrograde station).

[Group: Astro-Geography] [Endpoint: POST /v1/phase-return] [Cost: 100 credits (Tier 4)]

Recalculate a natal chart for a new geographic location (same birth moment, different lat/lng). Returns new houses and planet house positions.

[Group: Astro-Geography] [Endpoint: POST /v1/relocation] [Cost: 50 credits (Tier 3)]

The populated place nearest to a point, by great-circle distance over the same list as /geo/search, and the IANA zone of the point itself (which near a border can differ from the place's). Works across the antimeridian and at the poles. At sea timezone is the nautical hour band (Etc/GMT+2, whose sign is inverted by POSIX convention) and nautical is true; place.distanceKm says how far the nearest place is, so a point in open water is not mistaken for a town. featureCode PPLX marks a section of a city rather than a city.

[Group: Astro-Geography] [Endpoint: GET /v1/geo/reverse] [Required: lat, lon] [Cost: 5 credits (Tier ½)]

A place name to candidates with coordinates and the IANA zone, for a birthplace field. Matches a prefix, ignores case, accents and punctuation (krakow finds Kraków, St. Petersburg finds Saint Petersburg), and knows the names GeoNames carries in our 21 languages and older ones such as Kiev. Ranked by population, an exact name counting ten times its size, so an ambiguous name such as Springfield lists every town largest first; q=Springfield, Illinois or Springfield, MA narrows by region or country after the comma.

[Group: Astro-Geography] [Endpoint: GET /v1/geo/search] [Required: q] [Cost: 5 credits (Tier ½)]

Astrocartography for the solar return of a given year: the ACG map of the moment the Sun comes back to its natal longitude. Planet names carry an SR suffix.

[Group: Astro-Geography] [Endpoint: POST /v1/solar-acg] [Cost: 100 credits (Tier 4)]

The IANA zone at a point and the UTC offset its clocks kept at that local date and time, from the tz database, never a fixed offset: Kyiv answers +2 in January, +3 in July and +4 on 15 May 1990, when it kept Moscow summer time. time defaults to 12:00 and matters on the day clocks change; a skipped hour resolves to the offset from before the change, a repeated one to its first occurrence. standardOffset is the smaller of the year's offsets and isDst is true when the clock is ahead of it.

[Group: Astro-Geography] [Endpoint: GET /v1/geo/timezone] [Required: lat, lon] [Cost: 5 credits (Tier ½)]

Find all geographic locations where a given planet is exactly at the zenith (MC) at the birth moment.

[Group: Astro-Geography] [Endpoint: POST /v1/zenith] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Analyze which of the 3 Circuits (Tribal, Individual, Collective) and 6 Sub-circuits are activated in a Human Design chart based on defined channels.

[Group: Human Design] [Endpoint: POST /v1/hd/circuitry] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Find the Design date (the moment 88° of solar arc before birth) for a given birth moment, the unconscious imprinting point.

[Group: Human Design] [Endpoint: POST /v1/hd/design-date] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Calculate the Dream Rave chart: sleep type, active gates in lower centers (Sacral, Solar Plexus, Root), and dream themes.

[Group: Human Design] [Endpoint: POST /v1/hd/dream-rave] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Calculate a combined HD group overlay chart for 2 or more people, showing collectively defined centers and channels.

[Group: Human Design] [Endpoint: POST /v1/hd/group-overlay] [Required: inputs] [Cost: 100 credits (Tier 4)]

Calculate the Gene Keys hologenetic profile (Activation Sequence, Venus Sequence, Pearl Sequence) from HD gate activations.

[Group: Human Design] [Endpoint: POST /v1/hd/hologenetic] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Calculate a full Human Design BodyGraph chart: type, strategy, authority, profile, definition, incarnation cross, centers, channels, and gate activations. Centre identifiers are PascalCase with no separator and are stable: Head, Ajna, Throat, G, Heart, SolarPlexus, Spleen, Sacral, Root. channels[].centerA and centerB use the same nine. These identifiers are English and have no localised twin yet, unlike the sign and planet names on /public/moon-phase.

[Group: Human Design] [Endpoint: POST /v1/human-design] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Calculate Human Design connection chart (compatibility) between two people: electromagnetic connections, compromise, dominance, and companionship channels.

[Group: Human Design] [Endpoint: POST /v1/human-design/compatibility] [Required: chart1, chart2] [Cost: 100 credits (Tier 4)]

Calculate current Human Design transit activations. Optionally overlay on natal chart to show combined defined centers and channels.

[Group: Human Design] [Endpoint: POST /v1/human-design/transits] [Cost: 50 credits (Tier 3)]

Return the Incarnation Cross from birth data (or directly from gate numbers). Includes cross name, type, and theme description. With gate numbers, personalitySunLine and designSunLine decide the angle: lines 1-3 and profile 4/6 are right angle, 4/1 juxtaposition, 5 and 6 left angle.

[Group: Human Design] [Endpoint: POST /v1/hd/incarnation-cross] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Calculate the Penta (group) chart for 3–5 people: combined BodyGraph showing group dynamics and collective conditioning.

[Group: Human Design] [Endpoint: POST /v1/hd/penta] [Required: inputs] [Cost: 100 credits (Tier 4)]

Calculate Rave New Year dates (exact moment Sun enters Gate 41) for a range of years. Max range: 50 years.

[Group: Human Design] [Endpoint: POST /v1/hd/rave-new-years] [Required: startYear, endYear] [Cost: 10 credits (Tier 1)]

Analyze how sensitive the HD chart type/authority is to birth time changes. Returns windows where the chart is stable vs. in transition.

[Group: Human Design] [Endpoint: POST /v1/hd/sensitivity] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

Planet conditions per Valens: 9 categories.

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/bonifications-maltreatments] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Classical planetary joys (Sun-Leo-9th, etc.).

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/joys-of-planets] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

All 15 Hermetic Lots per Brennan §11.

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/lots-15] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Annual profection year-lord with full classical condition.

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/profections-detail] [Cost: 10 credits (Tier 1)]

Combined stack of profection + ZR + decennials for a date.

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/time-lord-stack] [Cost: 10 credits (Tier 1)]

Dorothean triplicity rulers (day/night/common).

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/triplicity-rulers] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Zodiacal Releasing from Lot of Fortune: body/livelihood periods.

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/zodiacal-releasing-fortune] [Cost: 10 credits (Tier 1)]

Zodiacal Releasing from Lot of Spirit: career/action periods.

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/zodiacal-releasing-spirit] [Cost: 10 credits (Tier 1)]

Loosing of Bond detection within ZR sequence.

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/zr-loosing-of-bond] [Cost: 10 credits (Tier 1)]

Peak periods in ZR (angular signs from Lot).

[Group: Hellenistic: Brennan tradition] [Endpoint: POST /v1/hellenistic/brennan/zr-peak-periods] [Cost: 10 credits (Tier 1)]

Solstitial antiscia per Hellenistic conventions.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/antiscia-hellenistic] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Equinoctial contra-antiscia.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/contra-antiscia] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Spirit-Fortune axis as primary chart spine.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/daimon-tyche-axis] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Dodecatemoria sub-divisions of zodiac.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/dodekatemoria] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Duodecima: 2.5° micro-sign per planet.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/duodecima] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Eros calculation with conditions analysis.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/lot-of-eros-detail] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Synchronistic quality of a moment.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/quality-of-time] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Constellations beyond the zodiac.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/sphaera-barbarica] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Temple-house assignments per Greenbaum.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/temple-doctrine] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Zodiacal decans with attributions.

[Group: Hellenistic: Greenbaum tradition] [Endpoint: POST /v1/hellenistic/greenbaum/zodiacal-decans] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Ptolemaic Egyptian bounds rulers.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/bounds] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Critical degrees by modality.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/critical-degrees] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Chaldean decan rulers per planet.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/decanic-rulers] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Hand's decennial timing technique.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/decennials] [Cost: 10 credits (Tier 1)]

Bodies trining the rising sign.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/horoscopos-trine] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Tetrabiblos III.10 hyleg + alcocoden.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/longevity-hyleg] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Seven primary Lots per Hand.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/lots-of-seven] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Perfection-of-aspects timing.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/perfections] [Cost: 10 credits (Tier 1)]

Lord of the chart's seasonal quarter.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/quarter-lord] [Cost: 10 credits (Tier 1)]

Numerical sect-light dignity scoring.

[Group: Hellenistic: Hand tradition] [Endpoint: POST /v1/hellenistic/hand/sect-strength] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Aspect classes per Schmidt.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/aspectual-typology] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Derived-house technique.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/derivative-houses-method] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Nine fates classification.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/ennea-mooirai] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Schmidt's causation tiers.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/levels-of-causation] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Predictive significator selection.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/lord-of-prediction] [Cost: 10 credits (Tier 1)]

Morning vs evening star classification.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/morning-evening-stars] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Qualitative + quantitative analysis.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/qualities-and-quantities] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Sect classifications per Schmidt.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/sect-classes] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Heliacal phases and stations.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/stations-and-phases] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Stoic doctrine of elemental natures.

[Group: Hellenistic: Schmidt tradition] [Endpoint: POST /v1/hellenistic/schmidt/stoic-elementhood] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Run a full horary radicality diagnostic including early/late ASC, Via Combusta, Saturn in 7th, and considerations before judgement.

[Group: Horary] [Endpoint: POST /v1/horary/diagnostics] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Calculate a horary chart for a question moment and return the chart data with radicality assessment and significator analysis.

[Group: Horary] [Endpoint: POST /v1/horary] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

List all aspects the Moon will make in this horary chart before leaving its sign, the key timing tool in horary.

[Group: Horary] [Endpoint: POST /v1/horary/moon-aspects] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Check if the Moon is void-of-course in this horary chart and return the last aspect it made and when it enters the next sign.

[Group: Horary] [Endpoint: POST /v1/horary/moon-voc] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Return the planetary hour ruler at the exact moment of a horary question and check if it matches the ASC ruler.

[Group: Horary] [Endpoint: POST /v1/horary/planetary-hours] [Required: dayOfWeek, sunriseHour, sunsetHour] [Cost: 20 credits (Tier 2)]

Check if the Moon or ASC is in the Via Combusta (15° Libra – 15° Scorpio), a classical prohibition in horary.

[Group: Horary] [Endpoint: POST /v1/horary/via-combusta] [Required: moonLongitude] [Cost: 10 credits (Tier 1)]

Generate a relationship horoscope based on synastry between two charts: strengths, friction points, and themes for the next 30 days.

[Group: Horoscope] [Endpoint: POST /v1/horoscope/compatibility] [Required: sign1, sign2] [Cost: 50 credits (Tier 3)]

Daily horoscope for a zodiac sign in 21 languages, written by a model from that sign's solar houses and the day's transits. style: "plain" gives everyday words with no astrological terms, written once in English and translated so every language says the same; length (short, medium) and topics choose its size and sections. Returns sections (overview, love, career, health, finance, advice) and the same text as horoscope, plus computed transits with solar houses, aspects, events, energy (1-10 with its factors), lucky and compatibleSigns.

[Group: Horoscope] [Endpoint: POST /v1/horoscope/daily] [Required: sign] [Cost: 50 credits (Tier 3)]

Monthly horoscope for a zodiac sign: the same shape as the daily one, over 30 days from date, with the month's ingresses, stations and lunar phases.

[Group: Horoscope] [Endpoint: POST /v1/horoscope/monthly] [Required: sign] [Cost: 50 credits (Tier 3)]

Weekly horoscope for a zodiac sign: the same shape as the daily one, with the week's ingresses, stations and lunar phases in events and in the text.

[Group: Horoscope] [Endpoint: POST /v1/horoscope/weekly] [Required: sign] [Cost: 50 credits (Tier 3)]

Generate a year-ahead horoscope (12-month window) with major transit cycles, solar return chart context, and time-lord (profection) for the year.

[Group: Horoscope] [Endpoint: POST /v1/horoscope/yearly] [Required: sign] [Cost: 100 credits (Tier 4)]

Deterministic hexagram from question text.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/by-question] [Required: question] [Cost: 10 credits (Tier 1)]

Compares two hexagrams: matching and differing lines, named relations (identical, complement, inverse, nuclear, shared or swapped trigrams), five-phase relations of the lower and of the upper trigrams, and a 0-100 score whose formula is stated in the response (a convention of this API, not a classical measure).

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/compatibility] [Required: hexagramA, hexagramB] [Cost: 10 credits (Tier 1)]

Deterministic per-date hexagram.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/daily] [Cost: 10 credits (Tier 1)]

Fetch hexagram 1-64 by King Wen number.

[Group: I Ching (Standalone)] [Endpoint: GET /v1/iching/lookup/{number}] [Required: number] [Cost: see your plan — endpoint not in the public credit manifest]

Casts a hexagram from the moment of the question by the Mei Hua Yi Shu method: Chinese lunar year branch, lunar month and day (from the ephemeris, Beijing days) and the hour branch give the upper trigram, the lower trigram and one moving line; the response shows every term and sum, the Legge reading, and ti and yong (the asker and the matter) with their five-phase verdict.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/plum-blossom] [Required: date, time] [Cost: 10 credits (Tier 1)]

A full reading in Legge's public-domain translation: the primary hexagram's judgment, the text of each changing line, the resulting hexagram, and focus, the texts to read for that count of changing lines by Zhu Xi's rule (none: the judgment; one: that line; two: both, the upper leads; three: both judgments; four: the two unchanged lines of the resulting hexagram; five: its one unchanged line; six: the use of nines or sixes on Qian and Kun, otherwise the resulting judgment).

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/reading] [Cost: 10 credits (Tier 1)]

Seeded 3-coin method.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/throw-coins] [Cost: 10 credits (Tier 1)]

For a hexagram (number or lines): both trigrams in full, the image (upper over lower), the five-phase relation of upper to lower, the nuclear trigrams and nuclear hexagram (lines 2-4 and 3-5), the inverse (turned over) and the complement (every line changed).

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/trigram-analysis] [Cost: 10 credits (Tier 1)]

All eight trigrams (bagua) with lines, image, attribute, family member, animal and body part from the Shuo Gua, Earlier and Later Heaven numbers and directions, and the five-phase element.

[Group: I Ching (Standalone)] [Endpoint: GET /v1/iching/trigrams] [Cost: 10 credits (Tier 1)]

Primary + transformed hexagrams.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/with-changing-lines] [Cost: 10 credits (Tier 1)]

A hexagram for a person and a year: the Mei Hua formula with the earthly branch of the year asked about in place of the year of asking and the lunar month, day and hour of birth. Labelled basis: convention: Mei Hua casts for a question, and this annual use is this API's convention. Returns the full Legge reading and ti/yong.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/yearly] [Required: birthDate, birthTime, year] [Cost: 10 credits (Tier 1)]

Seven standard ciphers over a Hebrew text: absolute, large, small, ordinal, inclusive, AtBash and AlBam. Vowel points and cantillation are stripped; a final letter counts as its ordinary form in the absolute value and as 500-900 in the large one, and both are returned rather than one being chosen.

[Group: Kabbalah] [Endpoint: POST /v1/kabbalah/gematria] [Required: text] [Cost: 10 credits (Tier 1)]

The Tree of Life as a reference table: Hebrew, meaning, pillar, triad and the Golden Dawn planetary attribution, grouped by pillar. Nothing here is computed, and the response says so.

[Group: Kabbalah] [Endpoint: GET /v1/kabbalah/sephiroth] [Cost: 5 credits (Tier ½)]

The 72 three-letter names, computed from Exodus 14:19-21 rather than read from a table, each with its five degrees of the zodiac. Filter with ?index=1..72 or ?longitude=0..360.

[Group: Kabbalah] [Endpoint: GET /v1/kabbalah/shem-names] [Cost: 5 credits (Tier ½)]

Combined Tzolkin + Haab: unique date label within the 52-year cycle (18,980 days).

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/calendar-round] [Required: date] [Cost: 10 credits (Tier 1)]

Pair compatibility from Tzolkin name + tone alignment plus elemental/directional affinity. Returns 0-100 score.

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/compatibility] [Required: person1, person2] [Cost: 10 credits (Tier 1)]

Modern synchronometer reinterpretation by José Argüelles. Returns kin (1-260) + tone + seal. Distinct from traditional Tzolkin.

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/dreamspell] [Required: date] [Cost: 10 credits (Tier 1)]

All four classical components in one call: Long Count + Tzolkin + Haab + Calendar Round + Lord of the Night.

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/full] [Required: date] [Cost: 10 credits (Tier 1)]

365-day civil calendar = 18 months × 20 days + 5-day Wayeb. Identifies if date falls in unlucky Wayeb period.

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/haab] [Required: date] [Cost: 10 credits (Tier 1)]

Five-place positional notation: baktun.katun.tun.uinal.kin. Days since 4 Ahau 8 Cumku (3114 BC).

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/long-count] [Required: date] [Cost: 10 credits (Tier 1)]

9-day cycle of underworld deities (G1-G9) governing the spiritual influence of each night.

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/lord-of-night] [Required: date] [Cost: 10 credits (Tier 1)]

260-day sacred calendar. Returns 1-13 number + 20 day-name + element + direction + keyword.

[Group: Mayan Calendars] [Endpoint: POST /v1/mayan/tzolkin] [Required: date] [Cost: 10 credits (Tier 1)]

2 personas debate a topic, multi-round transcript.

[Group: MCP Advanced] [Endpoint: POST /v1/mcp/agent-debate] [Required: topic, agentA, agentB] [Cost: 100 credits (Tier 4)]

8 personas with specialties.

[Group: MCP Advanced] [Endpoint: GET /v1/mcp/agent-pool-status] [Cost: 10 credits (Tier 1)]

Chat answered from the positions we computed for this birth moment, not from the model's memory of a sun sign. Carries up to 10 turns of history, replies in 21 languages, and takes four voices through persona. Send your own provider key and the turn costs 5 credits instead of the endpoint price.

[Group: AI & MCP] [Endpoint: POST /v1/ai/chat] [Required: message] [Cost: 100 credits (Tier 4)]

Coach two charts on relationship dynamics.

[Group: AI & MCP] [Endpoint: POST /v1/ai/comparison-coach] [Required: chart1, chart2, question] [Cost: 100 credits (Tier 4)]

Detailed explanation of an aspect between two planets.

[Group: AI & MCP] [Endpoint: POST /v1/ai/explain-aspect] [Required: planet1, planet2, aspectType] [Cost: 100 credits (Tier 4)]

Explain a current transit hitting your natal chart.

[Group: AI & MCP] [Endpoint: POST /v1/ai/explain-transit] [Required: chart, transitDate, transitPlanet, natalPlanet, aspectType] [Cost: 100 credits (Tier 4)]

Run N personas in parallel + LLM synthesis.

[Group: MCP Advanced] [Endpoint: POST /v1/mcp/multi-agent-coordinate] [Required: question, agents] [Cost: 100 credits (Tier 4)]

Compact context for MCP agents working across multiple charts.

[Group: AI & MCP] [Endpoint: POST /v1/mcp/multi-chart-context] [Required: charts] [Cost: 10 credits (Tier 1)]

Keyword-tag scoring over chart chunks.

[Group: MCP Advanced] [Endpoint: POST /v1/mcp/rag-search] [Required: query, chart] [Cost: 10 credits (Tier 1)]

Server-Sent Events streaming chat completion with optional chart context.

[Group: AI & MCP] [Endpoint: POST /v1/mcp/streaming] [Required: message] [Cost: 100 credits (Tier 4)]

SSE-stream of a tool call envelope.

[Group: MCP Advanced] [Endpoint: POST /v1/mcp/tool-call-stream] [Required: tool] [Cost: 10 credits (Tier 1)]

Auto-generated tool manifest for MCP clients (modelcontextprotocol/2025-03 spec).

[Group: AI & MCP] [Endpoint: GET /v1/mcp/tools-list] [Cost: see your plan — endpoint not in the public credit manifest]

Calculate the Balance number from initials of each part of the full name. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/balance] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Birthday number from the day-of-birth digit. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/birthday] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Challenge cycles: life-area difficulties to master, derived from birth date components. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/challenge] [Required: name, date] [Cost: 10 credits (Tier 1)]

The six core numbers in one call: Life Path, Expression, Soul Urge, Personality, Birthday and Personal Year (year defaults to the current year), each with its meaning. 20 credits instead of 60 for six single calls. Every number carries meaning (English) and meaningLocalized in the requested language (translated: false with the English text while a language's strings are on their way). Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/chart] [Required: name, date] [Cost: 20 credits (Tier 2)]

Calculate the Expression (Destiny) number from full birth name letters (all letters, reduced). Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/expression] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Life Path number from birth date (year + month + day, reduced). Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/life-path] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Maturity number: sum of Life Path and Expression, activates around age 35. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/maturity] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personality number from the consonants of the full birth name. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/personality] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personal Year number for a given calendar year: the 9-year cycle of personal evolution. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/personal-year] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Pinnacle cycles with their age boundaries: life chapters of opportunity. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/pinnacles] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Soul Urge number from the vowels of the full birth name. Numerology: Chaldean system.

[Group: Numerology: Chaldean] [Endpoint: POST /v1/numerology/chaldean/soul-urge] [Required: name, date] [Cost: 10 credits (Tier 1)]

Total and reduction of a house or flat number, a letter suffix (12B) counted by Chaldean value unless countLetters is false, Cheiro's compound reading and compatibility with the driver and conductor.

[Group: Numerology: Indian] [Endpoint: POST /v1/numerology/house-number] [Required: number] [Cost: 10 credits (Tier 1)]

Calculate the Balance number from initials of each part of the full name. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/balance] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Birthday number from the day-of-birth digit. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/birthday] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Challenge cycles: life-area difficulties to master, derived from birth date components. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/challenge] [Required: name, date] [Cost: 10 credits (Tier 1)]

The six core numbers in one call: Life Path, Expression, Soul Urge, Personality, Birthday and Personal Year (year defaults to the current year), each with its meaning. 20 credits instead of 60 for six single calls. Every number carries meaning (English) and meaningLocalized in the requested language (translated: false with the English text while a language's strings are on their way). Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/chart] [Required: name, date] [Cost: 20 credits (Tier 2)]

Calculate the Expression (Destiny) number from full birth name letters (all letters, reduced). Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/expression] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Life Path number from birth date (year + month + day, reduced). Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/life-path] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Maturity number: sum of Life Path and Expression, activates around age 35. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/maturity] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personality number from the consonants of the full birth name. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/personality] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personal Year number for a given calendar year: the 9-year cycle of personal evolution. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/personal-year] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Pinnacle cycles with their age boundaries: life chapters of opportunity. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/pinnacles] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Soul Urge number from the vowels of the full birth name. Numerology: Kabbalistic (phonetic) system.

[Group: Numerology: Kabbalistic (phonetic)] [Endpoint: POST /v1/numerology/kabbalistic/soul-urge] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Balance number from initials of each part of the full name. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/balance] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Birthday number from the day-of-birth digit. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/birthday] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Challenge cycles: life-area difficulties to master, derived from birth date components. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/challenge] [Required: name, date] [Cost: 10 credits (Tier 1)]

The six core numbers in one call: Life Path, Expression, Soul Urge, Personality, Birthday and Personal Year (year defaults to the current year), each with its meaning. 20 credits instead of 60 for six single calls. Every number carries meaning (English) and meaningLocalized in the requested language (translated: false with the English text while a language's strings are on their way). Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/chart] [Required: name, date] [Cost: 20 credits (Tier 2)]

Calculate the Expression (Destiny) number from full birth name letters (all letters, reduced). Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/expression] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Life Path number from birth date (year + month + day, reduced). Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/life-path] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Maturity number: sum of Life Path and Expression, activates around age 35. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/maturity] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personality number from the consonants of the full birth name. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/personality] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personal Year number for a given calendar year: the 9-year cycle of personal evolution. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/personal-year] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Pinnacle cycles with their age boundaries: life chapters of opportunity. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/pinnacles] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Soul Urge number from the vowels of the full birth name. Numerology: Kabbalistic (Mathers strict) system.

[Group: Numerology: Kabbalistic (Mathers strict)] [Endpoint: POST /v1/numerology/kabbalistic-strict/soul-urge] [Required: name, date] [Cost: 10 credits (Tier 1)]

The 3x3 Lo Shu square (4 9 2 / 3 5 7 / 8 1 6) filled from the digits of a birth date, with the driver (moolank) and conductor (bhagyank) added as Indian practice does (each can be switched off): present, missing and repeated numbers, the six planes (mental, emotional, practical, thought, will, action) and the arrows, the full and empty lines of the square.

[Group: Numerology: Indian] [Endpoint: POST /v1/numerology/lo-shu-grid] [Required: date] [Cost: 10 credits (Tier 1)]

Total and reduction of every digit of a phone number, Cheiro's compound reading of the total (an extension of his name table, labelled), compatibility with the driver and conductor under both conventions when a birth date is sent, and each adjacent digit pair judged by Cheiro's harmony. The response says why that convention was picked over pair-meaning tables and Cantonese homophones.

[Group: Numerology: Indian] [Endpoint: POST /v1/numerology/mobile-number] [Required: number] [Cost: 10 credits (Tier 1)]

The name number under two conventions, Chaldean as practised in India (one letter total, planets with Rahu and Ketu, BPHS planetary friendship) and Cheiro (each name reduced, the singles added into the compound, his harmony groups), its compatibility with the driver and conductor, and candidate spellings one change away (double a letter, add a silent E or an H, drop a silent letter) that land on a favourable number with a compound Cheiro does not read as unfavourable. Deterministic, no AI. 20 credits: it rescores every candidate.

[Group: Numerology: Indian] [Endpoint: POST /v1/numerology/name-correction] [Required: name, date] [Cost: 20 credits (Tier 2)]

Calculate the Balance number from initials of each part of the full name. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/balance] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Birthday number from the day-of-birth digit. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/birthday] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Challenge cycles: life-area difficulties to master, derived from birth date components. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/challenge] [Required: name, date] [Cost: 10 credits (Tier 1)]

The six core numbers in one call: Life Path, Expression, Soul Urge, Personality, Birthday and Personal Year (year defaults to the current year), each with its meaning. 20 credits instead of 60 for six single calls. Every number carries meaning (English) and meaningLocalized in the requested language (translated: false with the English text while a language's strings are on their way). Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/chart] [Required: name, date] [Cost: 20 credits (Tier 2)]

Calculate the Expression (Destiny) number from full birth name letters (all letters, reduced). Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/expression] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Life Path number from birth date (year + month + day, reduced). Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/life-path] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Maturity number: sum of Life Path and Expression, activates around age 35. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/maturity] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personality number from the consonants of the full birth name. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/personality] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personal Year number for a given calendar year: the 9-year cycle of personal evolution. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/personal-year] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Pinnacle cycles with their age boundaries: life chapters of opportunity. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/pinnacles] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Soul Urge number from the vowels of the full birth name. Numerology: Pythagorean system.

[Group: Numerology: Pythagorean] [Endpoint: POST /v1/numerology/pythagorean/soul-urge] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Balance number from initials of each part of the full name. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/balance] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Birthday number from the day-of-birth digit. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/birthday] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Challenge cycles: life-area difficulties to master, derived from birth date components. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/challenge] [Required: name, date] [Cost: 10 credits (Tier 1)]

The six core numbers in one call: Life Path, Expression, Soul Urge, Personality, Birthday and Personal Year (year defaults to the current year), each with its meaning. 20 credits instead of 60 for six single calls. Every number carries meaning (English) and meaningLocalized in the requested language (translated: false with the English text while a language's strings are on their way). Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/chart] [Required: name, date] [Cost: 20 credits (Tier 2)]

Calculate the Expression (Destiny) number from full birth name letters (all letters, reduced). Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/expression] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Life Path number from birth date (year + month + day, reduced). Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/life-path] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Maturity number: sum of Life Path and Expression, activates around age 35. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/maturity] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personality number from the consonants of the full birth name. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/personality] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Personal Year number for a given calendar year: the 9-year cycle of personal evolution. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/personal-year] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate four Pinnacle cycles with their age boundaries: life chapters of opportunity. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/pinnacles] [Required: name, date] [Cost: 10 credits (Tier 1)]

Calculate the Soul Urge number from the vowels of the full birth name. Numerology: Vedic system.

[Group: Numerology: Vedic] [Endpoint: POST /v1/numerology/vedic/soul-urge] [Required: name, date] [Cost: 10 credits (Tier 1)]

Same shape as the mobile number for a number plate: every digit counts, the letters (the state and district code on an Indian plate) only with countLetters, by Chaldean value.

[Group: Numerology: Indian] [Endpoint: POST /v1/numerology/vehicle-number] [Required: number] [Cost: 10 credits (Tier 1)]

Career, life direction.

[Group: Palmistry (Cheiro)] [Endpoint: POST /v1/palmistry/fate-line] [Cost: 10 credits (Tier 1)]

Intellect, mental approach.

[Group: Palmistry (Cheiro)] [Endpoint: POST /v1/palmistry/head-line] [Cost: 10 credits (Tier 1)]

Emotional life, romance.

[Group: Palmistry (Cheiro)] [Endpoint: POST /v1/palmistry/heart-line] [Cost: 10 credits (Tier 1)]

Vitality, health, life force.

[Group: Palmistry (Cheiro)] [Endpoint: POST /v1/palmistry/life-line] [Cost: 10 credits (Tier 1)]

Significant partnerships.

[Group: Palmistry (Cheiro)] [Endpoint: POST /v1/palmistry/marriage-line] [Cost: 10 credits (Tier 1)]

Sign-aligned name suggestions; optional gender filter.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/best-names] [Cost: 10 credits (Tier 1)]

Full natal chart for the pet (sun, moon, ASC + planets) plus disclaimer.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/birth-chart] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

How best to communicate with this pet.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/communication-style] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Element-based dietary focus.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/diet-by-sign] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Element-based daily exercise minutes + recommended activities.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/exercise-needs] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Grooming focus + frequency by element.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/grooming-by-element] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Sign-specific health vulnerabilities. NOT veterinary advice.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/health-tips] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Days of week traditionally aligned with the sign.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/lucky-day] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Compatibility score (0-100) based on element + sign distance.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/owner-pet-compatibility] [Required: owner, pet] [Cost: 10 credits (Tier 1)]

Full personality breakdown.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/personality] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Preferred play and toy types.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/play-style] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Personality + temperament + best-suited household.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/sun-sign-meaning] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Short temperament-only summary.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/temperament] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Preferred training style + 3 tips.

[Group: Pet Astrology] [Endpoint: POST /v1/pet/training-style] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Calculate Firdaria planetary periods: the traditional Persian time-lord system based on sect and planet order.

[Group: Prognostics] [Endpoint: POST /v1/firdaria] [Cost: 20 credits (Tier 2)]

Generate a combined forecast calendar including transits, lunar phases, ingresses, and retrograde stations for a given period.

[Group: Prognostics] [Endpoint: POST /v1/forecast-calendar] [Cost: 100 credits (Tier 4)]

Find the next date when the Moon returns to its natal longitude. Returns full lunar return chart.

[Group: Prognostics] [Endpoint: POST /v1/lunar-return] [Cost: 50 credits (Tier 3)]

Calculate minor progressions (lunar month-for-a-year) to a target date. Supports converse direction.

[Group: Prognostics] [Endpoint: POST /v1/minor-progressions] [Cost: 50 credits (Tier 3)]

Find all returns of any planet to its natal longitude within a given year. Returns full charts for each return.

[Group: Prognostics] [Endpoint: POST /v1/planetary-return] [Cost: 50 credits (Tier 3)]

Calculate primary directions (Ptolemaic or Regiomontanus) up to a maximum age. Returns a timeline of directed aspect hits.

[Group: Prognostics] [Endpoint: POST /v1/primary-directions] [Cost: 50 credits (Tier 3)]

Calculate annual profections: profected Ascendant, lord of the year, activated house, and monthly profection sub-rulers.

[Group: Prognostics] [Endpoint: POST /v1/profections] [Cost: 20 credits (Tier 2)]

Calculate secondary progressed chart (day-for-a-year) for a target date. Returns progressed planets, houses and angles, and the aspects between progressed planets.

[Group: Prognostics] [Endpoint: POST /v1/progressions] [Cost: 50 credits (Tier 3)]

Rectify an approximate birth time using a list of life events and transit/direction hits to narrow the birth time window.

[Group: Prognostics] [Endpoint: POST /v1/rectification] [Required: baseInput, events] [Cost: 500 credits (Tier 6)] ⚠️ Heavy — confirm with user before invoking.

Apply the Trutine of Hermes (Animodar) technique to derive the birth time from the Moon's prenatal syzygy position.

[Group: Prognostics] [Endpoint: POST /v1/rectification/trutine] [Required: date, time, latitude, longitude] [Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

Find the exact moment when the Sun returns to its natal longitude in a given year. Returns full solar return chart.

[Group: Prognostics] [Endpoint: POST /v1/solar-return] [Cost: 50 credits (Tier 3)]

Calculate symbolic arc directions to natal points for a target date. Key: "one_degree" (default), "naibod", or "solar_arc" (the arc of the progressed Sun).

[Group: Prognostics] [Endpoint: POST /v1/symbolic-directions] [Cost: 50 credits (Tier 3)]

Calculate tertiary progressions (day-for-a-lunar-month) to a target date. Supports converse direction.

[Group: Prognostics] [Endpoint: POST /v1/tertiary-progressions] [Cost: 50 credits (Tier 3)]

List the exact moments of transit-to-natal aspects in a date range, one event per exact pass, so a retrograde triple pass gives three events.

[Group: Prognostics] [Endpoint: POST /v1/transit-calendar] [Cost: 100 credits (Tier 4)]

Calculate transit planet aspects to natal planets for a given date. Returns applying and separating aspects.

[Group: Prognostics] [Endpoint: POST /v1/transits] [Cost: 50 credits (Tier 3)]

Arroyo's evolutionary cycle.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/arroyo/cycle-of-becoming] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Element distribution and integration.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/arroyo/element-balance] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Strategies for integrating weak elements.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/arroyo/element-integration] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Relational element compatibility map.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/arroyo/relational-element-map] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Water-house trauma patterns.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/arroyo/water-houses-trauma] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Archetypal patterns in the chart per Liz Greene.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/greene/archetypal-figures] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Individuation arc per natal chart.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/greene/individuation-path] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Lunar archetypes by sign and house.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/greene/lunar-myth] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Parental imagos analysis.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/greene/parental-imagos] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Saturn-as-shadow integration work.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/greene/saturn-shadow] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Outer-planet cycles as becoming.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/rudhyar/cycles-of-becoming] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

8-phase lunation classification.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/rudhyar/lunation-phase] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Single-keynote signature for the chart.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/rudhyar/personality-keynote] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Symbolic-degree analysis.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/rudhyar/symbolic-degrees] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Reframe major transits as rebirth.

[Group: Modern Psychological] [Endpoint: POST /v1/modern/rudhyar/transits-as-rebirth] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

Edited interpretation texts for a chart, no AI at request time. keys is a comma list of up to 64: sun.aries (planet in sign, also chiron, ascendant), moon.h4 (planet in house), sun_moon.trine (major aspect between two of Sun..Pluto). lang is required; a text that does not exist in that language is listed in missing, never replaced by another language. Planet in sign covers 20 languages; houses and aspects are being written. Plain text, paragraphs separated by a blank line.

[Group: Reference] [Endpoint: GET /v1/natal-texts] [Required: keys, lang] [Cost: 10 credits (Tier 1)]

Keys with no text in the requested lang come back listed in missing, not in texts. Do not invent, translate or guess a replacement body for a key that comes back in missing; report it as unavailable.

Calculate a coalescent chart: the harmonic chart that resonates most strongly between two charts.

[Group: Comparisons] [Endpoint: POST /v1/coalescent] [Required: input1, input2] [Cost: 50 credits (Tier 3)]

Calculate a midpoint composite chart by averaging the planetary positions and house cusps of two natal charts.

[Group: Comparisons] [Endpoint: POST /v1/composite] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

Calculate a Davison relationship chart using the midpoint in time and space between two birth moments.

[Group: Comparisons] [Endpoint: POST /v1/davison] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

Calculate synastry aspects among 2–8 charts simultaneously, returning all pairwise cross-chart aspect matrices.

[Group: Comparisons] [Endpoint: POST /v1/group-synastry] [Required: inputs] [Cost: 100 credits (Tier 4)]

One-call dating-compatibility aggregate over the synastry engine: overall score (0-100) + label + harmony/tension, the attraction score (Venus-Mars / Moon-Venus / 5th-house), the most influential cross-aspects, and green/red flags surfaced from those aspects. Built for dating apps that want a single call instead of synastry + attraction + their own flag logic. Same TwoChart input as /synastry.

[Group: Comparisons] [Endpoint: POST /v1/match/score] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

Calculate cross-chart aspects between two natal charts for relationship analysis. Either partner may set timeUnknown: true: cross-aspects are still returned, while that partner's houses, angles and sect come back null.

[Group: Comparisons] [Endpoint: POST /v1/synastry] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

NxM matrix of cross-chart aspects between the two charts (default 13×13: Sun..Pluto + nodes + Lilith + Chiron). Cells contain aspect or null.

[Group: Comparisons] [Endpoint: POST /v1/synastry/aspect-grid] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

Weighted 0–100 attraction score from Sun-Moon, Mars-Venus, ASC/DSC, Mars-Mars, Sun-Mars, Moon-Venus contacts and 5th-house overlay.

[Group: Comparisons] [Endpoint: POST /v1/synastry/attraction-score] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

Element (fire/earth/air/water) and modality (cardinal/fixed/mutable) tallies for each chart and the combined pair, with dominant and missing elements.

[Group: Comparisons] [Endpoint: POST /v1/synastry/element-balance] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

Locate each chart’s personal planets in the partner’s houses; reports top-3 emphasized houses on either side.

[Group: Comparisons] [Endpoint: POST /v1/synastry/house-overlay] [Required: chart1, chart2] [Cost: 50 credits (Tier 3)]

Triangular aspect matrix: rows × columns = planets, each cell shows aspect glyph + orb. Standard textbook layout.

[Group: Visualization] [Endpoint: POST /v1/render/aspect-grid] [Cost: 10 credits (Tier 1)]

Three-curve sine plot of physical (23d), emotional (28d), and intellectual (33d) cycles since birth.

[Group: Visualization] [Endpoint: POST /v1/render/biorhythm] [Required: birthDate, rangeStart, rangeEnd] [Cost: 10 credits (Tier 1)]

Two concentric wheels: inner natal + outer ring with transit (or progression) planets. Standard bi-wheel layout.

[Group: Visualization] [Endpoint: POST /v1/render/bi-wheel] [Cost: 10 credits (Tier 1)]

Composite-chart wheel from two natal inputs. Computes midpoint composite then renders as Western wheel.

[Group: Visualization] [Endpoint: POST /v1/render/composite] [Cost: 10 credits (Tier 1)]

Cosmobiology 90° dial. Plots planets at (longitude mod 90)° across 4 quadrants, Cardinal/Fixed/Mutable repeated.

[Group: Visualization] [Endpoint: POST /v1/render/cosmogram] [Cost: 10 credits (Tier 1)]

Equirectangular world graticule with caller-supplied eclipse track. Renders centerline + shaded band of given degree-width.

[Group: Visualization] [Endpoint: POST /v1/render/eclipse-path] [Required: path] [Cost: 10 credits (Tier 1)]

Render the moon disk with its illuminated fraction at the given moment. Returns SVG plus illumination metrics.

[Group: Visualization] [Endpoint: POST /v1/render/moon-phase] [Cost: 10 credits (Tier 1)]

Stereographic projection of caller-supplied points (RA/Dec). Handles brightness magnitude scaling and labels.

[Group: Visualization] [Endpoint: POST /v1/render/star-map] [Required: points] [Cost: 10 credits (Tier 1)]

Gantt-style horizontal timeline of transit/aspect events over a date window. Caller supplies events array.

[Group: Visualization] [Endpoint: POST /v1/render/timeline] [Required: rangeStart, rangeEnd, events] [Cost: 10 credits (Tier 1)]

Three concentric wheels: natal + progressed + transit. Used for advanced forecasting visuals.

[Group: Visualization] [Endpoint: POST /v1/render/tri-wheel] [Required: natal, middle, outer] [Cost: 10 credits (Tier 1)]

East Indian (Bengali) layout: square with diagonals + inner rotated square forming 12 sectors.

[Group: Visualization] [Endpoint: POST /v1/render/wheel-vedic-east] [Cost: 10 credits (Tier 1)]

North Indian diamond chart layout: 12 fixed positions, signs rotate per ascendant. Standard BPHS rendering.

[Group: Visualization] [Endpoint: POST /v1/render/wheel-vedic-north] [Cost: 10 credits (Tier 1)]

South Indian 4×4 grid layout (Pisces top-left, signs fixed). House numbers placed where lagna sign falls.

[Group: Visualization] [Endpoint: POST /v1/render/wheel-vedic-south] [Cost: 10 credits (Tier 1)]

Render a Western natal wheel as SVG: signs ring, houses ring, planets, aspect lines. Pure server-side, no browser needed.

[Group: Visualization] [Endpoint: POST /v1/render/wheel-western] [Cost: 10 credits (Tier 1)]

Single-month forecast. Tighter scope than year-ahead: uses fast and slow planet transits within the month. Inputs: chart, year, month (1-12), language, tone, length.

[Group: AI Reports] [Endpoint: POST /v1/reports/ai/monthly-narrative] [Required: chart, year, month] [Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

Long-form natal-chart narrative (markdown). Inputs: chart, language (21 codes), tone (warm/professional/concise), length (short/medium/long; ≤3200 tokens). Returns the narrative text plus model and token usage. AI grounded on the computed natal chart: Sun/Moon/Asc, 13 bodies, 12 houses, ≤25 major aspects.

[Group: AI Reports] [Endpoint: POST /v1/reports/ai/natal-narrative] [Required: chart] [Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

Long-form relationship narrative grounded in cross-chart aspects. Inputs: chart1, chart2, language, tone, length.

[Group: AI Reports] [Endpoint: POST /v1/reports/ai/synastry-narrative] [Required: chart1, chart2] [Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

Snapshot transit interpretation for a specific date. Inputs: chart + transitDate (+optional transitTime/tzOffset), language, tone, length. Returns narrative grounded in transit-to-natal aspects (orb ≤1°).

[Group: AI Reports] [Endpoint: POST /v1/reports/ai/transit-narrative] [Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

Long-form annual report. Combines natal context with the year's major outer-planet transits clustered by month. Inputs: chart, year (default = next year), language, tone, length (use long for full annual report).

[Group: AI Reports] [Endpoint: POST /v1/reports/ai/year-ahead-narrative] [Required: chart] [Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

The /bazi/chart reading as an A4 PDF (default), HTML or Markdown: the four pillars with stems, branches, animals, ten gods, hidden stems, na yin and the twelve stages; the day master with its classical image; the five elements counted three ways; the strength verdict with favourable elements and its stated thresholds; the symbolic stars; the branch interactions; and the ten-year luck pillars when gender is given. Takes the /bazi/chart birth input (date, time, timezoneOffset or timezone, longitude with trueSolarTime, dayBoundary), plus name and city for the cover. No AI.

[Group: Reports] [Endpoint: POST /v1/reports/bazi] [Required: date] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Founding-chart analysis (mundane astrology). Highlights Sun (purpose), MC (reputation), Jupiter (growth), Saturn (structure). Disclaimer: "not financial advice".

[Group: Reports] [Endpoint: POST /v1/reports/business] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Career-themed natal: MC, 10th-house cusp, Saturn placement, Mars motivation, aspects to Sun. Self-knowledge tool, not directive.

[Group: Reports] [Endpoint: POST /v1/reports/career] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Parenting-oriented natal report. Highlights Moon (emotional core), Mercury (learning style), Venus (connection style), Mars (energy/temperament). Includes full natal data and a disclaimer noting interpretive nature.

[Group: Reports] [Endpoint: POST /v1/reports/child] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

A Chinese zodiac year forecast as an A4 PDF (default), HTML or Markdown: your animal and the element of your birth year with their characterisation, the pillar of the year asked for with its exact Lichun dates, how the year's branch stands to yours (your own year 本命年, the clash 冲太岁, harmony, trine, harm or neutral) and how its element stands to yours, your allies and opposites, and the twelve solar months with their pillars and their relation to your branch. Animal from /chinese/zodiac/animal, boundaries from the ephemeris. year defaults to next calendar year.

[Group: Reports] [Endpoint: POST /v1/reports/chinese-year] [Required: date] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

The ratna prescription as a multi-page A4 PDF (default) or live HTML (add ?format=html). Same astrology as POST /vedic/gemstones, and pinned by a test to never disagree with it: same sidereal lagna, same two schools, same three gems. What the document adds is what a table cannot carry. Every recommended gem gets a page: what the graha it belongs to signifies classically, the basis in house ownership, mineral and substitutes, weight in ratti with gram and carat conversions, weekday, finger, metal, mantra and japa count, and the next auspicious day to first wear it, found by scanning th…

[Group: Reports] [Endpoint: POST /v1/reports/gemstone] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Single endpoint over the 12 type-specific renderers: pass report_type ("natal" | "transit-yearly" | "synastry" | "business" | "career" | "love" | "money" | "child" | "lal-kitab" | "human-design" | "tarot" | "vedic-kundli") plus the renderer-specific inputs. SDK ergonomics: one method instead of 12. Required fields vary by type: chart for most, chart1+chart2 for synastry, seed for tarot (chart optional).

[Group: Reports] [Endpoint: POST /v1/reports/generate] [Required: report_type] [Cost: 10 credits (Tier 1)]

List the calling key's most recently generated PDF reports: type, byte size, page count, language, created/expiry timestamps and a url. Re-fetch a report link while it lives (24 h, or the retain_days the report was made with), or surface recent exports in a dashboard. PDFs are purged after 24h, so older items return expired: true with a now-dead URL. Free to call. Query ?limit= (1–50, default 10).

[Group: Reports] [Endpoint: GET /v1/reports/history] [Cost: see your plan — endpoint not in the public credit manifest]

Bodygraph PDF: Type, Strategy, Authority, Profile, Definition, Not-Self theme, Incarnation Cross + 9 centers (defined/open) + activated channels with gate pairs.

[Group: Reports] [Endpoint: POST /v1/reports/human-design] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

The /vedic/compatibility/couple-report reading as an A4 PDF (default), HTML or Markdown: the summary (Guna Milan out of 36, Dashakoota out of 39, Porutham factors out of 10, doshas left uncancelled), the eight kootas with both partners' values, the ten Porutham factors with the essential ones marked, Mangal, Nadi and Bhakoot dosha with the rules that cancel them, the navamsa of both, and their Vimshottari periods side by side. chart1 is the groom and chart2 the bride, as on every /vedic/compatibility route; coordinates are required for both. No AI.

[Group: Reports] [Endpoint: POST /v1/reports/kundli-matching] [Required: chart1, chart2] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Lal Kitab analysis: Teva (graha placements with Pakka-ghar match), Kismat & Prosperity scores, detected Rins (ancestral debts) with triggers, suggested Upayas (remedies). Sidereal compute (Lahiri ayanamsa) with sign-from-Lagna house numbering per Lal Kitab convention.

[Group: Reports] [Endpoint: POST /v1/reports/lal-kitab] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Romantic-relationship natal report. Highlights Venus (attraction style), Mars (desire), Moon (emotional needs), Descendant (partner profile). Disclaimer: not a prophecy.

[Group: Reports] [Endpoint: POST /v1/reports/love] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Financial natal: 2nd house (earned income), 8th house (shared resources), Jupiter (expansion), Saturn (discipline). Disclaimer: not investment advice.

[Group: Reports] [Endpoint: POST /v1/reports/money] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Render a standard A4 report of the most auspicious dates for a chosen activity over a search window. Same window-scan engine as /vedic/muhurat/*: it scores each day by sunrise Panchang (Tithi/Vara/Nakshatra/Yoga/Karana) per Muhurta Chintamani + B.V.Raman, and lists ranked days with per-day Abhijit Muhurat and the scoring factors as the rationale. activity is one of the 12 from /muhurta/types. PDF default; ?format=html returns HTML.

[Group: Reports] [Endpoint: POST /v1/reports/muhurta] [Required: activity, search_window_start, latitude, longitude] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Render a Western tropical natal chart as a single-page A4 PDF (default) or live HTML (add ?format=html). Includes Big Three (Sun/Moon/ASC), full planets table with houses + retrograde, all 12 house cusps, and major aspects. Set whitelabel: true to apply the caller's branding overrides. depth: "extended" (10000 credits instead of 5000) adds the chart wheel and a chapter for each of Sun to Pluto, Chiron and the Ascendant in its sign, from edited texts in the 20 languages of /natal-texts; no AI at request time. Languages: uk (default) or en.

[Group: Reports] [Endpoint: POST /v1/reports/natal] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

A numerology reading as an A4 PDF (default), HTML or Markdown: Life Path, Expression, Soul Urge, Personality, Birthday and Maturity with what each position measures and the meaning of its number, the Balance number, the four pinnacles and challenges with their ages, and the personal year. Same engine and meanings as /numerology/{system}/*, five systems. The name must be in Latin letters (diacritics are dropped); any other letter is refused with 400 NAME_NOT_LATIN rather than counted as zero. No AI. Texts in Ukrainian or English; any other language gets the English document.

[Group: Reports] [Endpoint: POST /v1/reports/numerology] [Required: name, date] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Compare up to five places for one birth chart as a multi-page A4 PDF (default) or live HTML (add ?format=html). Per place: the relocated ascendant and midheaven with the signed shift from birth, which planets changed house (the substantive difference, diffed rather than left as two tables), every astrocartography line running within 300 km with its interpretation text, and supportive/challenging scores across the 19 life categories. With more than one place a side-by-side comparison leads the document.

[Group: Reports] [Endpoint: POST /v1/reports/relocation] [Required: chart, locations] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Render a data-rich, print-ready natal chart poster. A high-detail western wheel (colored element sectors, colored glyphs, degree labels, ASC arrow, MC marker, house cusps) plus the Sun/Moon/Rising trio, a placements table, element/modality balance bars, and the top aspects, fully deterministic, 0 AI. Three styles via style: editorial (light), celestial (dark + gold), classic (minimal). White-label via whitelabel. i18n via language. PDF default; ?format=html returns HTML. NB style is read from the request BODY, not the query string.

[Group: Reports] [Endpoint: POST /v1/reports/stellaforge] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Render a relationship synastry PDF: side-by-side Big Three, full cross-chart aspect table (top 40 major aspects), and per-chart + combined element/modality balance.

[Group: Reports] [Endpoint: POST /v1/reports/synastry] [Required: chart1, chart2] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Render a tarot reading PDF. Default spread three-card (Past/Present/Future from Rider-Waite-Smith deck). Available spreads: single-card, three-card, celtic-cross, horseshoe, relationship, year-ahead, decision, chakra, career, love-triangle. Pass seed for reproducibility (deterministic mulberry32 RNG); omit to use a daily seed. Set allowReversed: false to draw upright cards only.

[Group: Reports] [Endpoint: POST /v1/reports/tarot] [Cost: 100 credits (Tier 4)]

Render a year-ahead transit calendar PDF grouped by month. Includes major aspects (conjunction, sextile, square, trine, opposition) of outer planets (Mars through Pluto) to natal positions, with 0.5° max orb. Defaults to next calendar year if year omitted.

[Group: Reports] [Endpoint: POST /v1/reports/transit-yearly] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

The /vastu/plan reading as an A4 PDF (default) or live HTML (add ?format=html): the school and the north on the cover, the score with its band, the plan drawn with the mandala (and the 16 zones for school sixteen-zone), every finding heaviest first with its source, and the remedies with their effort and whether they can be undone. Takes the /vastu/plan input. Texts in Ukrainian or English; any other language gets the English document.

[Group: Reports] [Endpoint: POST /v1/reports/vastu] [Required: coords, northAngle, boundary] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Sidereal Vedic chart (Lahiri ayanamsa): Lagna + Moon nakshatra/pada, all sidereal planet positions with nakshatra+pada+house, full 9-period Vimshottari Mahadasha tree with current period highlighted.

[Group: Reports] [Endpoint: POST /v1/reports/vedic-kundli] [Required: chart] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Joins two to four runes on one stave (or the runes whose meanings name an intent), returning each rune with its poem stanza and SVG, the combined strokes as coordinates and a ready SVG of the bind rune.

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/bind-rune] [Cost: 10 credits (Tier 1)]

Tropical-sign → Elder Futhark affinity rune.

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/by-zodiac] [Required: sign] [Cost: 10 credits (Tier 1)]

The medieval Scandinavian runic calendar for a date: the day rune (fé, úr, þurs, óss, reið, kaun, hagall for letters A-G from 1 January), the year's Sunday rune or runes (the dominical letter, two in a leap year) and the golden-number rune of the 19-year lunar cycle (the sixteen Younger Futhark runes plus arlaug, tvímaðr, belgþór).

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/calendar] [Cost: 10 credits (Tier 1)]

Five runes in a cross: Present (centre), Past, Future, Help (above), Challenge (below). Reproducible with seed; each rune carries its Old English Rune Poem stanza with our gloss. The layout is modern practice (basis: convention).

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/five] [Cost: 10 credits (Tier 1)]

Pennick layout 9-rune cast.

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/nine] [Cost: 10 credits (Tier 1)]

All 24 runes.

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes] [Cost: 10 credits (Tier 1)]

Deterministic 1-rune draw.

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/single] [Cost: 10 credits (Tier 1)]

Past/Present/Future (Urdr/Verdandi/Skuld).

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/three] [Cost: 10 credits (Tier 1)]

Calculate the draconic chart by shifting all planet longitudes relative to the True Node (0° = True Node).

[Group: Specialized Charts] [Endpoint: POST /v1/draconic] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Calculate a harmonic chart by multiplying all planet longitudes by the given harmonic number (H2–H36).

[Group: Specialized Charts] [Endpoint: POST /v1/harmonics] [Cost: 20 credits (Tier 2)]

Calculate heliocentric planetary positions (Sun-centered) for a given birth moment. Earth replaces Sun; Moon is excluded.

[Group: Specialized Charts] [Endpoint: POST /v1/heliocentric] [Required: date, time, latitude, longitude] [Cost: 20 credits (Tier 2)]

Calculate azimuth and altitude of planets above the local horizon for a given time and location.

[Group: Specialized Charts] [Endpoint: POST /v1/horizon] [Required: date, time, latitude, longitude] [Cost: 50 credits (Tier 3)]

DEPRECATED: moved to dedicated per-varga endpoints /vedic/varga/{D1..D60} for OpenAPI/SDK ergonomics. This generic endpoint still works and stays live until its 2027-06-15 sunset (12-month, per the /v1 stability policy), then will be removed; migrate to /vedic/varga/{D}. Calculate a Vedic divisional (varga) chart using sidereal zodiac. Supported vargas: D1–D60 (e.g. D9 Navamsha).

[Group: Specialized Charts] [Endpoint: POST /v1/vedic-divisional] [Cost: 20 credits (Tier 2)] [⚠️ DEPRECATED — will be removed in a future API version. Avoid using.]

Countdown to next 5 eclipses.

[Group: Real-time Streaming] [Endpoint: POST /v1/stream/eclipse-incoming] [Cost: 10 credits (Tier 1)]

Next solar+lunar eclipses with totality info.

[Group: Real-time Streaming] [Endpoint: POST /v1/stream/eclipse-totality] [Cost: 10 credits (Tier 1)]

Next planet sign-ingresses for N days.

[Group: Real-time Streaming] [Endpoint: POST /v1/stream/ingress] [Cost: 10 credits (Tier 1)]