New Numerology API

Rulebook

Astrology API rulebook

Each page states one rule the API follows, what kind of rule it is, and why. Astrologers and support teams can link to any rule by its ID. A practicing astrologer reviews the rules. There are 480 rules in 42 sections, taken from the API's own rulebook.

Updated

Why an astrology API should show its rules

© API for Astrology (apiforastrology.com). "A rule in action". All rights reserved. Not to be copied or reused.John Doe's birth chartVirgo rising, house 1 at the top678910111212345AscSaRaMaMoSuJuVeKeMeDO-01from the rulebookManglik (kuja) doshaManglik dosha: Mars in house 1, 2, 4, 7,8 or 12. The houses are counted threeseparate ways, from the rising sign,from the Moon and from Venus, and eachcount is reported.Counted from the rising sign:John's Mars is in house 8.Applied: present

What the rule kinds mean

classical 123 rules
from the classical texts, where the major traditions agree
school 284 rules
traditions differ here, and the API follows one stated choice
invention 59 rules
a rule the API adds where the texts give no method, so its answers stay consistent
gap 14 rules
something the API does not compute, named so no one assumes it does

CH Chart fundamentals 19

The basics every other rule rests on. They cover which planet rules each sign and where each planet is strong or weak. They also cover how houses are counted, and when a planet is combust or retrograde.

YG Yogas 104

Named planetary combinations the API looks for in a birth chart. Each yoga it finds, and each one it checked and did not find, comes back with the rule it tested.

KT Kartari: hemmed in 1

Kartari means "hemmed in". This checks every house and every planet for hard or helpful planets on both sides.

DO Doshas 5

The three doshas the API checks: manglik, kaal sarp and pitra. Each has competing definitions, so every result states the rule it used and the placements that decided it.

VG Divisional charts 6

The 16 divisional charts (vargas), from D1 to D60. Each splits every sign into parts and gives each part a sign. The schools differ most on where the counting starts.

AS Aspects (graha drishti) 7

Aspects (graha drishti): which houses each planet looks at from where it sits. They are counted in whole houses.

DA Vimshottari dasha 4

Vimshottari dasha, the 120-year cycle of planetary periods. It covers the order of the periods, which one runs first, and how much of it was already over at birth.

AV Ashtakavarga 8

Ashtakavarga, a point system that scores how much support each sign gives each planet, from 0 to 8 points (bindus).

TR Transits (gochar) 10

Transits (gochar): where the planets are now, counted from the birth Moon, with the classical results and the vedha rule that can block them.

SS Sade sati 5

Sade sati: Saturn's passage over the birth Moon's sign and the signs on each side of it, in three dated phases.

KM Kundli matching (guna milan) 17

Kundli matching: the 36-point guna milan (ashtakoot), the classical exceptions, the checks that carry no points, the ten southern poruthams, and the final verdict.

JM Jaimini 13

Jaimini astrology: the chara karakas, the arudha padas, sign aspects, argala, chara dasha and Narayana dasha.

UG Upagrahas 4

Upagrahas: sensitive points that are not planets. Gulika, Mandi and five others come from the time of day, and five more come from the Sun's position.

SL Special lagnas 10

Special lagnas: extra rising points counted from sunrise or from the Moon. Also the yogi point, two Jaimini significators and the signs a lunar day marks as unlucky.

SB Shadbala 12

Planetary strength: shadbala, the six-part strength of each planet in virupas, and the strength of the houses.

VB Vimshopaka bala, ishta and kashta 5

Strength across the divisional charts on a scale of 20, and how much good and harm each planet can give. Also the table of planet friendships these are graded on.

BD Birth details 11

Birth details: the avakhada chakra and the panchang at the moment of birth, as on the second page of a printed kundli.

DR Reading a dasha period 4

How a dasha period is read: what the main period, sub-period and sub-sub-period each mean for this chart.

RC Where a chart disagrees with itself 3

Where a chart disagrees with itself. When two rules about the same part of life point opposite ways, the API names the disagreement instead of hiding it.

KR Karmic reading 3

The karmic reading: the Rahu-Ketu axis, the atmakaraka and its karakamsa, and the 5th, 9th and 12th houses, with no claims about past lives.

PQ Question chart (prashna) 51

A chart cast for the moment and place a question is asked, read for one topic you pick from a list. It shows tendencies of the moment. It is not a yes or no answer and not medical, legal or financial advice.

SP Spiritual path 15

The spiritual path reading: what one classical book, BPHS chapter 33, says about devotion and inner freedom from the soul planet's navamsa sign and the sign before it.

GA Planetary states 7

The five traditional sets of planetary states (avasthas): a planet's age, whether it is awake or asleep, its mood, its emotional condition and its activity. They are shown side by side and never added into a score.

OL Theme forecasts 7

Forecasts on one theme, such as love, career or wealth, over a date range. They list the transits and the dasha periods that touch that theme, and why each one does.

PS Pair reading 6

Two charts read against each other: each person's planets placed in the other's houses, the half of compatibility the 36 points leave out. Nothing here is scored.

YD Yogini dasha 5

Yogini dasha, a 36-year cycle of eight periods that runs beside Vimshottari.

KP Krishnamurti Paddhati 9

The KP system, with its own ayanamsa, its own house cusps and its star and sub lords.

RD Classical conditions 4

The classical conditions that decide which half of a placement's reading applies to this chart.

NR The nakshatra remedy 3

The nakshatra remedy: a remedy based on the birth nakshatra, with its deity, mantra, wood and the dates to do it.

VP Varshaphal 14

Varshaphal: the yearly chart cast for your birthday, read with the Tajik system.

SG The signature page 5

The signature page: the lucky day, colors, numbers and stones, worked out from the chart.

AN Annual forecast 6

The annual forecast: a year of dated sky events, then read against the chart.

MF Monthly forecast 4

Monthly forecasts: how a month is read from the planets moving through it, and why these sections need a date.

LP Life prediction topics 4

Life prediction topics: which part of the chart answers each life question, such as career, love or wealth.

RM Remedies 12

Remedies: which gemstone, rudraksha, mantra and havan the chart calls for, and what decided each one.

MU Muhurat and times of the day 9

Muhurat and times of the day: horas, the choghadiya, and where they disagree with rahu kaal and the other windows.

MS Muhurat for an activity 25

The rules a time window must pass before it is returned as a good time for an activity, such as buying a vehicle or a wedding.

PA Panchang 21

The panchang: the five parts of the Hindu day, the lunar month and season, and the daily windows such as rahu kaal.

PR Which rule leads 8

How the readings decide which rule leads when two rules about the same subject differ. This part is not classical: the weights are the API's own, stated openly.

CON Edge cases we settled 3

Places where two parts of the API once gave different answers, and how each was settled.

GAP What the API does not compute 5

Rules an astrologer might expect and not find in the API, named here so their absence is clear.

Think a rule is wrong?

Tell us and give its ID, for example "DO-01 is wrong". We check every report and reply.

Report a rule

Astrology API

Every answer follows a published rule

Create a free test key and compare any response with the rule behind it. Or try a request in the API reference first.

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer