New Numerology API

Chart basics

Drishti (aspect) in Vedic astrology

Drishti means sight: a planet's aspect, or influence, on other houses. In Vedic astrology every planet aspects the 7th house from itself. Mars also aspects the 4th and 8th, Jupiter the 5th and 9th, and Saturn the 3rd and 10th. The API counts aspects in whole houses, not in exact degrees.

Updated

More terms in Chart basics

© API for Astrology (apiforastrology.com). "Glossary houses chart". All rights reserved. Not to be copied or reused.123456789101112A North Indian chart has 12 houses

Drishti: how the API computes it

The API counts a planet's aspects in whole houses, using the whole-sign houses of the chart. Count the planet's own house as 1 and move forward. Every planet looks at the 7th house.

Mars also looks at the 4th and 8th (AS-03), Jupiter at the 5th and 9th, and Saturn at the 3rd and 10th. Rahu and Ketu, the two nodes, are given the 5th, 7th and 9th. Schools disagree on the nodes, so POST /v1/aspects accepts nodes=false to leave them out (AS-05).

The response lists which planet aspects which house, and which planets sit in that house. An aspect is one-way: Jupiter can look at Mars without Mars looking at Jupiter. Aspects feed other results, such as yogas (special planet combinations) and the Jaimini reading.

Jaimini is a separate classical school, and its rule is different: it works by sign. So the API keeps the two methods apart.

Get it from the API

Planet aspects (graha drishti). Here is the call to API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990, 10:30 AM, New York.

POST /v1/aspects

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/aspects" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Answer (long lists shortened)200 OK
{
  "by_graha": {
    "Sun": {
      "house": 11,
      "aspects_houses": [
        5
      ],
      "aspects_grahas": [
        "Rahu"
      ],
      "aspected_by": [
        "Mars",
        "Rahu"
      ],
      "special": []
    },
    "Moon": {
      "house": 9,
      "aspects_houses": [
        3
      ],
      "aspects_grahas": [],
      "aspected_by": [
        "Rahu"
      ],
      "special": []
    },
    "Mars": {
      "house": 8,
      "aspects_houses": [
        11,
        2,
        3
      ],
      "aspects_grahas": [
        "Sun",
        "Jupiter",
        "Venus"
      ],
      "aspected_by": [],
      "special": [
        4,
        8
      ]
    },
    "Mercury": {
      "house": 12,
      "aspects_houses": [
        6
      ],
      "aspects_grahas": [],
      "aspected_by": [],
      "special": []
    },
    "Jupiter": {
      "house": 11,
      "aspects_houses": [
        3,
        5,
        7
      ],
      "aspects_grahas": [
        "Rahu"
      ],
      "aspected_by": [
        "Mars",
        "Rahu"
      ],
      "special": [
        5,
        9
      ]
    },
    "Venus": {
      "house": 11,
      "aspects_houses": [
        5
      ],
      "aspects_grahas": [
        "Rahu"
      ],
      "aspected_by": [
        "Mars",
        "Rahu"
      ],
      "special": []
    },
    "Saturn": {
      "house": 4,
      "aspects_houses": [
        6,
        10,
        1
      ],
      "aspects_grahas": [],
      "aspected_by": [],
      "special": [
        3,
        10
      ]
    },
    "Rahu": {
      "house": 5,
      "aspects_houses": [
        9,
        11,
        1
      ],
      "aspects_grahas": [
        "Moon",
        "Sun",
        "Jupiter"
      ],
      "aspected_by": [
        "Sun",
        "Jupiter",
        "Venus"
      ],
      "special": []
    },
    "Ketu": {
      "house": 11,
      "aspects_houses": [
        3,
        5,
        7
      ],
      "aspects_grahas": [
        "Rahu"
      ],
      "aspected_by": [
        "Mars",
        "Rahu"
      ],
      "special": []
    }
  },
  "by_house": {
    "1": [
      "Saturn",
      "Rahu"
    ],
    "2": [
      "Mars"
    ],
    "3": [
      "Moon",
      "Mars",
      "Jupiter"
    ],
    "4": [],
    "5": [
      "Sun",
      "Jupiter",
      "Venus"
    ],
    "6": [
      "Mercury",
      "Saturn"
    ],
    "7": [
      "Jupiter",
      "Ketu"
    ],
    "8": [],
    "9": [
      "Rahu"
    ],
    "10": [
      "Saturn"
    ],
    "11": [
      "Mars",
      "Rahu"
    ],
    "12": []
  },
  "rule": "whole-house drishti, counted inclusively from the occupied house; every graha aspects the 7th, with special aspects for Mars (4, 8), Jupiter (5, 9) and Saturn (3, 10)",
  "include_nodes": true,
  "graded": {
    "unit": "virupas",
    "by_graha": {
      "Sun": {
        "on_grahas": {
          "Moon": 2.1,
          "Mars": 15.53,
          "Mercury": 0,
          "Jupiter": 0,
          "Venus": 0,
          "Saturn": 2.65,
          "Rahu": 29.47,
          "Ketu": 0
        },
        "on_houses": {
          "1": 10.58,
          "2": 36.16,
          "3": 34.42,
          "4": 8.84,
          "5": 42.32,
          "6": 49.42,
          "7": 34.42,
          "8": 19.42,
          "9": 4.42,
          "10": 0,
          "11": 0,
          "12": 0
        }
      },
      "Moon": {
        "on_grahas": {
          "Sun": 19.2,
          "Mars": 0,
          "Mercury": 44.41,
          "Jupiter": 5.56,
          "Venus": 6.88,
          "Saturn": 44.22,
          "Rahu": 35.53,
          "Ketu": 9.47
        },
        "on_houses": {
          "1": 32.32,
          "2": 4.64,
          "3": 50.72,
          "4": 47.32,
          "5": 32.32,
          "6": 17.32,
          "7": 2.32,
          "8": 0,
          "9": 0,
          "10": 0,
          "11": 12.68,
          "12": 40.36
        }
      },
      "Venus": {
        "on_grahas": {
          "Sun": 0,
          "Moon": 0,
          "Mars": 5.31,
          "Mercury": 8.71,
          "Jupiter": 0,
          "Saturn": 35.6,
          "Rahu": 57.41,
          "Ketu": 0
        },
        "on_houses": {
          "1": 26.61,
          "2": 39.2,
          "3": 18.39,
          "4": 23.22,
          "5": 54.2,
          "6": 39.2,
          "7": 24.2,
          "8": 9.2,
          "9": 0,
          "10": 0,
          "11": 0,
          "12": 5.8
        }
      },
      "Jupiter": {
        "on_grahas": {
          "Sun": 0,
          "Moon": 0,
          "Mars": 3.99,
          "Mercury": 10.03,
          "Venus": 0,
          "Saturn": 40.87,
          "Rahu": 56.09,
          "Ketu": 0
        },
        "on_houses": {
          "1": 29.24,
          "2": 52.12,
          "3": 45.76,
          "4": 28.49,
          "5": 52.88,
          "6": 52.12,
          "7": 45.76,
          "8": 7.88,
          "9": 0,
          "10": 0,
          "11": 0,
          "12": 7.12
        }
      },
      "Mercury": {
        "on_grahas": {
          "Sun": 0,
          "Moon": 15.59,
          "Mars": 29.02,
          "Jupiter": 0,
          "Venus": 0,
          "Saturn": 29.62,
          "Rahu": 12.24,
          "Ketu": 0
        },
        "on_houses": {
          "1": 0,
          "2": 12.09,
          "3": 39.19,
          "4": 32.91,
          "5": 5.81,
          "6": 48.37,
          "7": 47.91,
          "8": 32.91,
          "9": 17.91,
          "10": 2.91,
          "11": 0,
          "12": 0
        }
      },
      "Mars": {
        "on_grahas": {
          "Sun": 58.94,
          "Moon": 0,
          "Mercury": 31.97,
          "Jupiter": 26.96,
          "Venus": 30.92,
          "Saturn": 31.59,
          "Rahu": 22.1,
          "Ketu": 38.69
        },
        "on_houses": {
          "1": 7.78,
          "2": 44.44,
          "3": 60,
          "4": 37.78,
          "5": 18.89,
          "6": 3.89,
          "7": 0,
          "8": 0,
          "9": 0,
          "10": 11.11,
          "11": 48.33,
          "12": 37.78
        }
      },
      "Saturn": {
        "on_grahas": {
          "Sun": 43.68,
          "Moon": 1.55,
          "Mars": 28.41,
          "Mercury": 30.19,
          "Jupiter": 55.22,
          "Venus": 53.9,
          "Rahu": 0,
          "Ketu": 51.31
        },
        "on_houses": {
          "1": 53.81,
          "2": 12.38,
          "3": 0,
          "4": 0,
          "5": 0,
          "6": 47.62,
          "7": 48.1,
          "8": 33.1,
          "9": 6.19,
          "10": 47.62,
          "11": 48.1,
          "12": 33.1
        }
      }
    },
    "house_reference": "equal houses: the madhya (middle) of house N is the ascendant degree plus 30 x (N - 1), the same reference shadbala uses; not Sripati cusps",
    "casts_none": [
      "Rahu",
      "Ketu"
    ],
    "rule": "the graded drishti curve of shadbala (SB-09): 0 below 30 degrees, full at 180, nothing past 300; special aspects of Mars, Jupiter and Saturn graded by degree, full only at the center of each band"
  },
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Where the API returns it

POST/v1/aspectsPlanet aspects (graha drishti)
POST/v1/jaiminiJaimini: sign aspects, argala, chara dasha and karakas
POST/v1/prashnaQuestion chart (prashna): one question, read for the moment it is asked
POST/v1/reading/rulesRules this chart triggers, ranked
POST/v1/varshaphalThe Tajik annual chart (varshaphal) for one year
POST/v1/yogasYogas: planetary combinations found and not found

What the API reference says

Each line is quoted from the reference page of the endpoint named above it.

  • POST /v1/jaimini · Jaimini: sign aspects, argala, chara dasha and karakasSigns aspect signs, instead of planets aspecting houses.
  • POST /v1/aspects · Planet aspects (graha drishti)Returns which houses and planets each planet aspects.
  • POST /v1/prashna · Question chart (prashna): one question, read for the moment it is askedThe response says how each stands (asker, quesited), whether the two are linked (connection), how the Moon stands (moon), and which planets occupy or aspect each house (influences).
  • POST /v1/varshaphal · The Tajik annual chart (varshaphal) for one yearyear_lord (the varsheshwar) is the strongest office-bearer that aspects the annual lagna, is not the Moon and holds at least 5 of 20 vishwa (a strength score out of 20).

Feature page: Kundli and birth charts. Who uses it: Astrology apps. The classical rules the API follows are in the rulebook.

How we check the numbers

Every value here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test.

Related terms

Free tools

See it with your own details

Runs on the same API call. Enter your details and see the answer in your browser.

  • Free kundli

    Your Vedic birth chart: the rising sign and all nine planets, with sign, house and nakshatra.

    Make my kundli

From the blog

Astrology API

Get these values from the API

Create a free test key and call any endpoint on this page. 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