Exact Aspect Dates API

Exact conjunctions, sextiles, squares, trines and oppositions over a range

POST/v1/transits/aspects

2 credits · Secret key (test or live) · getAspectEvents

Angles of ecliptic longitude between the seven planets, in UTC to the minute. These are angular aspects, not graha drishti: use /v1/kundli/aspects for drishti. At most 366 days, or 31 with the Moon, which covers lunar aspects.

Request body

from string (date) required
e.g. "1990-08-13"
to string (date) required
Inclusive. At most 366 days after from, or 31 with the Moon.
e.g. "1990-08-13"
include_moon boolean
default false
aspects array of string

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

from string (date) required
e.g. "1990-08-13"
to string (date) required
e.g. "1990-08-13"
frame string required
count integer required
events array of object required
- at string (date-time) required
- a string required
- b string required
- aspect string required
- angle number required
- longitude_a number required
- longitude_b number required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/transits/aspects' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"from":"2026-11-01","to":"2026-11-30"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/transits/aspects", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "from": "2026-11-01",
    "to": "2026-11-30"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "from": "2026-11-01",
    "to": "2026-11-30",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/transits/aspects",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/transits/aspects');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"from":"2026-11-01","to":"2026-11-30"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 2,062 characters

{
  "data": {
    "from": "2026-11-01",
    "to": "2026-11-30",
    "frame": "ecliptic_longitude",
    "count": 8,
    "events": [
      {
        "at": "2026-11-04T10:21:00.000Z",
        "a": "venus",
        "b": "jupiter",
        "aspect": "sextile",
        "angle": 60,
        "longitude_a": 180.4912,
        "longitude_b": 120.4915
      },
      {
        "at": "2026-11-04T14:26:00.000Z",
        "a": "sun",
        "b": "mercury",
        "aspect": "conjunction",
        "angle": 0,
        "longitude_a": 197.9475,
        "longitude_b": 197.9465
      },
      {
        "at": "2026-11-10T06:40:00.000Z",
        "a": "venus",
        "b": "mars",
        "aspect": "sextile",
        "angle": 60,
        "longitude_a": 178.9103,
        "longitude_b": 118.9105
      },
      {
        "at": "2026-11-16T06:22:00.000Z",
        "a": "mars",
        "b": "jupiter",
        "aspect": "conjunction",
        "angle": 0,
        "longitude_a": 121.6537,
        "longitude_b": 121.6537
      },
      {
        "at": "2026-11-18T09:38:00.000Z",
        "a": "sun",
        "b": "jupiter",
        "aspect": "square",
        "angle": 90,
        "longitude_a": 211.8232,
        "longitude_b": 121.8232
      },
      {
        "at": "2026-11-19T17:49:00.000Z",
        "a": "sun",
        "b": "mars",
        "aspect": "square",
        "angle": 90,
        "longitude_a": 213.1757,
        "longitude_b": 123.1757
      },
      {
        "at": "2026-11-28T12:07:00.000Z",
        "a": "venus",
        "b": "jupiter",
        "aspect": "sextile",
        "angle": 60,
        "longitude_a": 182.4464,
        "longitude_b": 122.4462
      },
      {
        "at": "2026-11-30T06:02:00.000Z",
        "a": "sun",
        "b": "saturn",
        "aspect": "trine",
        "angle": 120,
        "longitude_a": 223.7978,
        "longitude_b": 343.7976
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "from": "2026-11-01",
  "to": "2026-11-30"
}

Exact Aspect Dates API

Request body

Response

Example request

Example response

More in Transits