Check current API key status: tier, credit balance, rate limits, monthly cycle reset. 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.

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.

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)]

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]

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)]

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)]

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 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)]

Calculate the Ashtakavarga benefic point table for a Vedic chart: individual bindus for each planet in each sign and the total Sarvashtakavarga.

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

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)]

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)]

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, 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)]

Month stem + branch from solar-term boundaries.

[Group: BaZi (Four Pillars)] [Endpoint: POST /v1/bazi/month-pillar] [Required: date] [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)]

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)]

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)]

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)]

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)]

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)]

Calculate a full natal chart: planets, house cusps, aspects, sect, and angular data for a given birth moment. When the birth time is unknown, send timeUnknown: true instead of time and the response carries planets and aspects with houses, angles and sect set to null, plus a timeUnknown block giving the range the Moon covers that day. With ?lang= the response adds localized: planet, sign and aspect names in that language, keyed by the English names.

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

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)]

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)]

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)]

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)]

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)]

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 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)]

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.]

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)]

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)]

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)]

Return planet positions for a date range with configurable step (min 0.01 days). Max range: 1 year for sub-day steps, 5 years otherwise. Optionally filter by planetIds.

[Group: Core] [Endpoint: POST /v1/ephemeris] [Required: startDate, endDate] [Cost: 100 credits (Tier 4)]

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 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)]

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)]

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]

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)]

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 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)]

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 Swiss Ephemeris fixstars.cat: 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 ½)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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)]

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.]

Deterministic hexagram from question text.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/by-question] [Required: question] [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]

Seeded 3-coin method.

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

Primary + transformed hexagrams.

[Group: I Ching (Standalone)] [Endpoint: POST /v1/iching/with-changing-lines] [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)]

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)]

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 ½)]

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)]

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)]

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)]

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)]

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)]

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 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 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 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)]

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)]

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)]

List the 12 supported muhurat activities (key + Sanskrit name + one-line purpose) so a client can discover them without hard-coding. Free metadata read, no calculation.

[Group: Vedic] [Endpoint: GET /v1/muhurta/types] [Cost: see your plan — endpoint not in the public credit manifest]

Calculate the Nakshatra (lunar mansion) for each planet using the sidereal zodiac. Returns nakshatra name, pada, deity, and quality.

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

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 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 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 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 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)]

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 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 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 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 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 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 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)]

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 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 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 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 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 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 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)]

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)]

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)]

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)]

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)]

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)]

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)]

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 raw planet longitudes for a given date/time without full chart context (no houses, no aspects).

[Group: Core] [Endpoint: POST /v1/planets] [Required: date, time, latitude, longitude] [Cost: 10 credits (Tier 1)]

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)]

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)]

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.

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)]

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)]

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)]

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)]

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.

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.

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.

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.

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.

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.

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)]

All 24 runes.

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes] [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)]

Pennick layout 9-rune cast.

[Group: Elder Futhark Runes] [Endpoint: POST /v1/runes/nine] [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)]

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)]

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)]

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)]

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)]

Current 8-phase + countdown to next major phase.

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

Current planetary hour + next 24.

[Group: Real-time Streaming] [Endpoint: POST /v1/stream/planetary-hour-changes] [Required: latitude, longitude] [Cost: 10 credits (Tier 1)]

Current planetary positions snapshot, tickSeconds=30.

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

All planets retro state + next stations.

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

Today + tomorrow sun events.

[Group: Real-time Streaming] [Endpoint: POST /v1/stream/sunrise-sunset] [Required: latitude, longitude] [Cost: 10 credits (Tier 1)]

Natal-transit hits within next N hours.

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

Current Moon VOC + next ingress.

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

Calculate sunrise, sunset, twilight times, and day length for a given date and geographic location.

[Group: Core] [Endpoint: POST /v1/sun-times] [Required: date, latitude, longitude] [Cost: 10 credits (Tier 1)]

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 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)]

Every deck with its spreads and the public-domain card art sets you can pick with art on any tarot route: id, artist, year, source, a preview image, the card back, and any card a set has no picture for.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/decks] [Cost: 5 credits (Tier ½)]

36-card Lenormand oracle deck.

[Group: Tarot: Lenormand] [Endpoint: GET /v1/tarot/lenormand/cards] [Cost: 10 credits (Tier 1)]

Single Lenormand card lookup by slug.

[Group: Tarot: Lenormand] [Endpoint: GET /v1/tarot/lenormand/cards/{slug}] [Required: slug] [Cost: see your plan — endpoint not in the public credit manifest]

Daily three-card draw based on date seed.

[Group: Tarot: Lenormand] [Endpoint: POST /v1/tarot/lenormand/daily] [Cost: 10 credits (Tier 1)]

Three-by-three grid: rows = past/present/future, cols = mind/heart/body.

[Group: Tarot: Lenormand] [Endpoint: POST /v1/tarot/lenormand/draw/9-card-square] [Cost: 10 credits (Tier 1)]

Adapted Celtic Cross with Lenormand cards.

[Group: Tarot: Lenormand] [Endpoint: POST /v1/tarot/lenormand/draw/celtic-cross-lenormand] [Cost: 10 credits (Tier 1)]

Full 36-card layout: every card and house used.

[Group: Tarot: Lenormand] [Endpoint: POST /v1/tarot/lenormand/draw/grand-tableau] [Cost: 10 credits (Tier 1)]

Five-card linear story spread.

[Group: Tarot: Lenormand] [Endpoint: POST /v1/tarot/lenormand/draw/line-of-five] [Cost: 10 credits (Tier 1)]

7-card relationship dynamics.

[Group: Tarot: Lenormand] [Endpoint: POST /v1/tarot/lenormand/draw/relationship] [Cost: 10 credits (Tier 1)]

Subject / Situation / Outcome three-card line.

[Group: Tarot: Lenormand] [Endpoint: POST /v1/tarot/lenormand/draw/three-card] [Cost: 10 credits (Tier 1)]

The 36 fixed houses for Grand Tableau interpretation.

[Group: Tarot: Lenormand] [Endpoint: GET /v1/tarot/lenormand/houses] [Cost: 10 credits (Tier 1)]

Birth card per Greer method, Marseille deck.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/birth-card] [Required: date] [Cost: 10 credits (Tier 1)]

78-card Marseille deck. Justice = 8, Strength = 11 (pre-Waite swap). Pip minors interpreted by number+suit.

[Group: Tarot: Marseille] [Endpoint: GET /v1/tarot/marseille/cards] [Cost: 10 credits (Tier 1)]

Single Marseille card lookup by slug.

[Group: Tarot: Marseille] [Endpoint: GET /v1/tarot/marseille/cards/{slug}] [Required: slug] [Cost: see your plan — endpoint not in the public credit manifest]

Single clarifying card.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/clarify] [Cost: 10 credits (Tier 1)]

Daily Marseille card based on date seed.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/daily] [Cost: 10 credits (Tier 1)]

4-card career spread.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/career] [Cost: 10 credits (Tier 1)]

Adapted 10-card Celtic Cross with Marseille pip-style reading.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/celtic-cross] [Cost: 10 credits (Tier 1)]

Authentic 5-card cross from Jodorowsky/Costa "The Way of Tarot" + Camoin ArtduTarot: 4 Major Arcana (consultant / external / higher / result) + 5th synthesis card (numerological sum reduced ≤22).

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/cross] [Cost: 10 credits (Tier 1)]

Single-card yes/no with verdict.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/decision] [Cost: 10 credits (Tier 1)]

Authentic 6-card Hero's Journey spread from Jodorowsky/Costa "The Way of Tarot": Hero / Objective / two Obstacles / Key / Resolution.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/hero] [Cost: 10 credits (Tier 1)]

5-card love and connection spread.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/love] [Cost: 10 credits (Tier 1)]

7-card pyramid spread.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/seven-card] [Cost: 10 credits (Tier 1)]

Single-card draw from Marseille deck.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/single] [Cost: 10 credits (Tier 1)]

4-card spiritual development spread.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/spiritual] [Cost: 10 credits (Tier 1)]

Past / Present / Future three-card spread.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/draw/three-card] [Cost: 10 credits (Tier 1)]

Resolve list of card slugs into meanings.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/interpret] [Required: cards] [Cost: 10 credits (Tier 1)]

22 Major Arcana of Marseille deck.

[Group: Tarot: Marseille] [Endpoint: GET /v1/tarot/marseille/majors] [Cost: 10 credits (Tier 1)]

List of all Marseille spreads (incl. Jodorowsky cross).

[Group: Tarot: Marseille] [Endpoint: GET /v1/tarot/marseille/spreads] [Cost: 10 credits (Tier 1)]

Definition of a single Marseille spread.

[Group: Tarot: Marseille] [Endpoint: GET /v1/tarot/marseille/spreads/{slug}] [Required: slug] [Cost: see your plan — endpoint not in the public credit manifest]

Single timing card.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/timing] [Cost: 10 credits (Tier 1)]

Year card per Greer method.

[Group: Tarot: Marseille] [Endpoint: POST /v1/tarot/marseille/year-card] [Required: date, year] [Cost: 10 credits (Tier 1)]

Single advice card.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/advice] [Cost: 10 credits (Tier 1)]

Birth card from date per Mary Greer's method (m+d+y reduced).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/birth-card] [Required: date] [Cost: 10 credits (Tier 1)]

Full 78-card RWS deck listing with upright/reversed meanings, keywords, astrology, and yes/no affinity.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/cards] [Cost: 10 credits (Tier 1)]

Single RWS card lookup by slug (e.g. "the-fool", "ace-of-cups"). Returns full meaning structure.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/cards/{slug}] [Required: slug] [Cost: see your plan — endpoint not in the public credit manifest]

Single clarifying card after a primary draw.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/clarify] [Cost: 10 credits (Tier 1)]

The 16 Court cards (Page, Knight, Queen, King × 4 suits).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/courts] [Cost: 10 credits (Tier 1)]

Birth-card meditation pair for court-card practice.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/cross-sum] [Required: date] [Cost: 10 credits (Tier 1)]

Daily card based on date seed (deterministic per day).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/daily] [Cost: 10 credits (Tier 1)]

5-card career trajectory spread.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/career] [Cost: 10 credits (Tier 1)]

Classical 10-card Celtic Cross spread.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/celtic-cross] [Cost: 10 credits (Tier 1)]

7-card chakra spread (Root → Crown).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/chakra] [Cost: 10 credits (Tier 1)]

Single-card draw with yes/no/maybe verdict from card affinity.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/decision] [Cost: 10 credits (Tier 1)]

7-card horseshoe progression.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/horseshoe] [Cost: 10 credits (Tier 1)]

6-card three-person love dynamics.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/love-triangle] [Cost: 10 credits (Tier 1)]

7-card relationship dynamics.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/relationship] [Cost: 10 credits (Tier 1)]

6-card shadow integration spread.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/shadow-work] [Cost: 10 credits (Tier 1)]

Draw 1 card from the RWS deck. Optional seed for deterministic shuffle.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/single] [Cost: 10 credits (Tier 1)]

5-card spiritual development spread.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/spiritual-path] [Cost: 10 credits (Tier 1)]

Past / Present / Future three-card spread.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/three-card] [Cost: 10 credits (Tier 1)]

13-card spread (12 months + theme).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/draw/year-ahead] [Cost: 10 credits (Tier 1)]

All Minor cards mapped to fire / water / air / earth element.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/elements/{element}] [Required: element] [Cost: see your plan — endpoint not in the public credit manifest]

Resolve a list of card slugs into structured meanings (POST /interpret/tarot writes the reading of the whole spread).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/interpret] [Required: cards] [Cost: 10 credits (Tier 1)]

Substring search across upright and reversed keywords across all 78 cards.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/keywords/{keyword}] [Required: keyword] [Cost: see your plan — endpoint not in the public credit manifest]

The 22 Major Arcana cards only.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/majors] [Cost: 10 credits (Tier 1)]

The 40 numbered Minor Arcana cards (Ace through 10 of each suit).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/minors] [Cost: 10 credits (Tier 1)]

Single card to surface hidden information.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/missing-info] [Cost: 10 credits (Tier 1)]

All Minor Arcana cards of a given number 1-14 (Ace=1..King=14).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/numbers/{n}] [Required: n] [Cost: see your plan — endpoint not in the public credit manifest]

Single outcome card.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/outcome] [Cost: 10 credits (Tier 1)]

Shadow card pair (mirror in major arcana of personality card).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/shadow-card] [Required: date] [Cost: 10 credits (Tier 1)]

Returns soul card and personality card pair from birth date.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/soul-personality-card] [Required: date] [Cost: 10 credits (Tier 1)]

List of all 12 RWS spread definitions.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/spreads] [Cost: 10 credits (Tier 1)]

Definition of a single spread by slug.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/spreads/{slug}] [Required: slug] [Cost: see your plan — endpoint not in the public credit manifest]

All 14 cards of a suit (wands, cups, swords, or pentacles).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: GET /v1/tarot/rider-waite/suits/{suit}] [Required: suit] [Cost: see your plan — endpoint not in the public credit manifest]

Single timing card to indicate when.

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/timing] [Cost: 10 credits (Tier 1)]

Year card per Greer (m+d+year reduced).

[Group: Tarot: Rider-Waite-Smith] [Endpoint: POST /v1/tarot/rider-waite/year-card] [Required: date, year] [Cost: 10 credits (Tier 1)]