New Numerology API

Divisional charts (vargas)

Chaturthamsa (D4) in Vedic astrology

Chaturthamsa (D4) is one of the 16 divisional charts. It divides each sign into 4 parts of 7°30′ and gives each part a sign, which makes a new chart. The API describes its use as: property and fortune. POST /v1/chart/D4 returns the sign and house of the ascendant and each planet in it.

Updated

More terms in Divisional charts (vargas)

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

Chaturthamsa: how the API computes it

The chaturthamsa, D4, splits each sign into 4 parts of 7 degrees 30 minutes. A planet's part sets its D4 sign. Tradition reads this chart for property, home and fortune. So it is the one to look at when a user asks about buying a house or land.

The API lists the use as property and fortune in the signifies field. POST /v1/chart/D4 returns the ascendant (rising sign) and every planet with the sign and house in this chart. Like every equal-part chart, it follows the shared counting rules (VG-02, VG-03).

There is a start sign for the first part, then a fixed step from part to part. A planet that moves only a few degrees can land in a new part. That is why a divisional chart needs an accurate birth time.

If the time is only a guess, say so in your app. The smaller the parts, the more a small error changes the chart. D4 has large parts compared with the later charts. So a small time error matters less here than in most of them.

Get it from the API

Any of the 16 divisional charts (D1 to D60). 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/chart/D4

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/chart/D4" \
  -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"}'

Where the API returns it

POST/v1/chart/{division}Any of the 16 divisional charts (D1 to D60)
GET/v1/metaSupported options and limits

Feature page: Kundli and birth charts. Who uses it: Astrologer consultation platforms. 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

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.

Get a free API keyOpen the API reference

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