Agent Platform1

AI & MCP7

AI Interpretations5

AI Reports5

Aspects & Points11

Astro-Geography18

BaZi (Four Pillars)11

Business Astrology12

Calendar & Cycles15

Chinese: Zodiac & Feng Shui14

Comparisons10

Content Localization4

Core4

Cosmobiology / Hamburg School10

Destiny Matrix1

Dignities & Receptions6

Elder Futhark Runes5

Embeddable Widgets14

Esoteric17

Evolutionary Astrology5

Family Astrology5

Financial Astrology10

Geomancy (Agrippa)16

Hellenistic: Brennan tradition10

Hellenistic: Greenbaum tradition10

Hellenistic: Hand tradition10

Hellenistic: Schmidt tradition10

Horary6

Horoscope5

Human Design12

I Ching (Standalone)5

Kabbalah3

Mayan Calendars8

MCP Advanced5

Modern Psychological15

Numerology: Chaldean10

Numerology: Kabbalistic (Mathers strict)10

Numerology: Kabbalistic (phonetic)10

Numerology: Pythagorean10

Numerology: Vedic10

Palmistry (Cheiro)5

Pet Astrology14

Prognostics15

Public9

Real-time Streaming10

Reference14

Reports18

Specialized Charts5

System6

Tarot: Lenormand10

Tarot: Marseille21

Tarot: Rider-Waite-Smith35

Vedic174

Visualization14

Webhooks15

Wellness10

White-label5

Zi Wei Dou Shu (Purple Star): MVP13

Zodiac Signs (Per-Sign Deep)12

Prognostics

Primary Directions

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

post/primary-directions

Request body

datestring required

timestring required

timezoneOffsetnumber nullable

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

latitudenumber required

longitudenumber required

houseSystemstring

namestring

citystring

zodiacType'tropical' | 'sidereal'

ayanamsaIdnumber nullable

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

cosmogramboolean

keynumber

maxAgeinteger

aspectAnglesnumber[]

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}

Changes

Changed in 4 of the 13 revisions of this API.41111

Aug 24, 20268ab5a768b52158See the full diff
- ●
  removed the optional property data/directions/items/age from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/directions/items/date from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/directions/items/directedPlanet from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/directions/items/natalPlanet from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/directions/items/type from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property data/directions/items/ageYears to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/directions/items/arc to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/directions/items/aspectAngle to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/directions/items/isDirect to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/directions/items/promissor to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/directions/items/promissorId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/directions/items/significator to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/directions/items/significatorId to the response with the 200 status
  response-optional-property-added
Aug 18, 2026dd3764875e7a1See the full diff
- ○
  added the new optional request property allOf[ChartInput]/ayanamsa
  new-optional-request-property
Aug 15, 2026e637d1a9911b2See the full diff
- ●
  the allOf[ChartInput]/timezoneOffset request property's max was set to 14.00
  request-property-max-set
- ●
  the allOf[ChartInput]/timezoneOffset request property's min was set to -14.00
  request-property-min-set
Aug 11, 2026b0533bcc12c0442See the full diff
- ▲
  the request property allOf[ChartInput]/latitude became not nullable
  request-property-became-not-nullable
- ▲
  the request property allOf[ChartInput]/longitude became not nullable
  request-property-became-not-nullable
- ▲
  the request property allOf[ChartInput]/latitude became required
  request-property-became-required
- ▲
  the request property allOf[ChartInput]/longitude became required
  request-property-became-required
- ●
  the allOf[ChartInput]/latitude request property's max was set to 90.00
  request-property-max-set
- ●
  the allOf[ChartInput]/longitude request property's max was set to 180.00
  request-property-max-set
- ●
  the allOf[ChartInput]/latitude request property's min was set to -90.00
  request-property-min-set
- ●
  the allOf[ChartInput]/longitude request property's min was set to -180.00
  request-property-min-set
- ○
  the latitude request property default value 0 was removed
  request-property-default-value-removed
- ○
  the longitude request property default value 0 was removed
  request-property-default-value-removed

Full history