API reference › Kundli

Sidereal Ephemeris Series API

A series of sidereal positions over a range, at up to 400 steps

POST/v1/planets/series

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

Request body

from string (date) required
e.g. "1990-08-13"
to string (date) required
e.g. "1990-08-13"
step string
one of hour, 6h, day, week · default "day"
planets array of string

No other fields are accepted.

Response

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

step string required
count integer required
at array of string (date-time) required
planets array of object required
- planet string required
- points array of object required
  Fields
  - longitude number required
  - speed number required
  - retrograde boolean required
  - sign string required
  - nakshatra string required

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

Example request

curl -X POST 'https://api.astrologics.in/v1/planets/series' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"from":"2026-01-01","to":"2026-01-03","step":"day","planets":["moon"]}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/planets/series", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "from": "2026-01-01",
    "to": "2026-01-03",
    "step": "day",
    "planets": [
      "moon"
    ]
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "from": "2026-01-01",
    "to": "2026-01-03",
    "step": "day",
    "planets": [
        "moon",
    ],
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/planets/series",
    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/planets/series');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"from":"2026-01-01","to":"2026-01-03","step":"day","planets":["moon"]}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 1,029 characters

{
  "data": {
    "step": "day",
    "count": 3,
    "at": [
      "2026-01-01T00:00:00.000Z",
      "2026-01-02T00:00:00.000Z",
      "2026-01-03T00:00:00.000Z"
    ],
    "planets": [
      {
        "planet": "moon",
        "points": [
          {
            "longitude": 42.4949,
            "speed": 14.9863,
            "retrograde": false,
            "sign": "taurus",
            "nakshatra": "rohini"
          },
          {
            "longitude": 57.5326,
            "speed": 15.0594,
            "retrograde": false,
            "sign": "taurus",
            "nakshatra": "mrigashira"
          },
          {
            "longitude": 72.5616,
            "speed": 14.9676,
            "retrograde": false,
            "sign": "gemini",
            "nakshatra": "ardra"
          }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2,
    "ayanamsa": "lahiri"
  },
  "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-01-01",
  "to": "2026-01-03",
  "step": "day",
  "planets": [
    "moon"
  ]
}

Sidereal Ephemeris Series API

Request body

Response

Example request

Example response

More in Kundli