Planets Now API
The sky now: sidereal positions at the top of the current hour
GET/v1/planets/now
1 credit · Secret or publishable key · getPlanetsNow
POST /v1/planets/positions at the first instant of the current UTC hour, for a "sky now" widget. Every call in the same hour and place gets the same answer; meta.valid_until says when it changes.
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
lat required | query | number | ≥ -90 · ≤ 90 |
lon required | query | number | ≥ -180 · ≤ 180 |
include_outer | query | boolean | Add Uranus, Neptune and Pluto. default false |
Response
JSON { data, meta, warnings }, where data is:
atstring (date-time) requiredbodiesarray of object requiredidstring requiredlongitudenumber requiredsignstring requireddegree_in_signnumbernakshatrastringpadaintegerretrogradebooleannakshatra_lordstringsub_lordstringThe KP sub lord of the longitude.
combustbooleandmsobjectFields
degreesinteger requiredminutesinteger requiredsecondsinteger required
speednumber or nullOne of:
- number
- null
localobjectdatestring (date) requirede.g.
"1990-08-13"timestring requiredweekdaystring requiredtimezoneobject requiredFields
namestring requiredoffset_hoursnumber required
ayanamsanumberjulian_daynumber
Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.
Example request
curl 'https://api.astrologics.in/v1/planets/now?lat=28.6139&lon=77.209' \
-H 'Authorization: Bearer al_test_YOUR_KEY'Node.js
const res = await fetch("https://api.astrologics.in/v1/planets/now?lat=28.6139&lon=77.209", {
headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));Python
import json
import urllib.error
import urllib.request
req = urllib.request.Request(
"https://api.astrologics.in/v1/planets/now?lat=28.6139&lon=77.209",
method="GET",
headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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/now?lat=28.6139&lon=77.209');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;Example response
200 OK · 5,960 characters
{
"data": {
"at": "2026-11-03T02:00:00.000Z",
"bodies": [
{
"id": "lagna",
"longitude": 207.43,
"sign": "libra",
"degree_in_sign": 27.43,
"nakshatra": "vishakha",
"pada": 3,
"retrograde": false,
"nakshatra_lord": "jupiter",
"sub_lord": "venus",
"combust": false,
"dms": {
"degrees": 27,
"minutes": 25,
"seconds": 48
},
"speed": null
},
{
"id": "sun",
"longitude": 196.427,
"sign": "libra",
"degree_in_sign": 16.4269,
"nakshatra": "swati",
"pada": 3,
"retrograde": false,
"nakshatra_lord": "rahu",
"sub_lord": "venus",
"combust": false,
"dms": {
"degrees": 16,
"minutes": 25,
"seconds": 37
},
"speed": 1.0012120515234528
},
{
"id": "moon",
"longitude": 122.1136,
"sign": "leo",
"degree_in_sign": 2.1136,
"nakshatra": "magha",
"pada": 1,
"retrograde": false,
"nakshatra_lord": "ketu",
"sub_lord": "venus",
"combust": false,
"dms": {
"degrees": 2,
"minutes": 6,
"seconds": 49
},
"speed": 13.598587346100771
},
{
"id": "mars",
"longitude": 115.4295,
"sign": "cancer",
"degree_in_sign": 25.4294,
"nakshatra": "ashlesha",
"pada": 3,
"retrograde": false,
"nakshatra_lord": "mercury",
"sub_lord": "rahu",
"combust": false,
"dms": {
"degrees": 25,
"minutes": 25,
"seconds": 46
},
"speed": 0.49674536039890427
},
{
"id": "mercury",
"longitude": 199.921,
"sign": "libra",
"degree_in_sign": 19.9211,
"nakshatra": "swati",
"pada": 4,
"retrograde": true,
"nakshatra_lord": "rahu",
"sub_lord": "mars",
"combust": true,
"dms": {
"degrees": 19,
"minutes": 55,
"seconds": 16
},
"speed": -1.2782815325149386
},
{
"id": "jupiter",
"longitude": 120.3365,
"sign": "leo",
"degree_in_sign": 0.3364,
"nakshatra": "magha",
"pada": 1,
"retrograde": false,
"nakshatra_lord": "ketu",
"sub_lord": "ketu",
"combust": false,
"dms": {
"degrees": 0,
"minutes": 20,
"seconds": 11
},
"speed": 0.11664002424913633
},
{
"id": "venus",
"longitude": 181.0406,
"sign": "libra",
"degree_in_sign": 1.0406,
"nakshatra": "chitra",
"pada": 3,
"retrograde": true,
"nakshatra_lord": "mars",
"sub_lord": "mercury",
"combust": false,
"dms": {
"degrees": 1,
"minutes": 2,
"seconds": 26
},
"speed": -0.43089237112917544
},
{
"id": "saturn",
"longitude": 344.9205,
"sign": "pisces",
"degree_in_sign": 14.9206,
"nakshatra": "uttara_bhadrapada",
"pada": 4,
"retrograde": true,
"nakshatra_lord": "saturn",
"sub_lord": "jupiter",
"combust": false,
"dms": {
"degrees": 14,
"minutes": 55,
"seconds": 14
},
"speed": -0.06060120589654616
},
{
"id": "rahu",
"longitude": 301.729,
"sign": "aquarius",
"degree_in_sign": 1.7289,
"nakshatra": "dhanishta",
"pada": 3,
"retrograde": true,
"nakshatra_lord": "mars",
"sub_lord": "mercury",
"combust": false,
"dms": {
"degrees": 1,
"minutes": 43,
"seconds": 44
},
"speed": null
},
{
"id": "ketu",
"longitude": 121.729,
"sign": "leo",
"degree_in_sign": 1.7289,
"nakshatra": "magha",
"pada": 1,
"retrograde": true,
"nakshatra_lord": "ketu",
"sub_lord": "venus",
"combust": false,
"dms": {
"degrees": 1,
"minutes": 43,
"seconds": 44
},
"speed": null
},
{
"id": "rahu_true",
"longitude": 302.6986,
"sign": "aquarius",
"degree_in_sign": 2.6986,
"nakshatra": "dhanishta",
"pada": 3,
"retrograde": true,
"nakshatra_lord": "mars",
"sub_lord": "venus",
"combust": false,
"dms": {
"degrees": 2,
"minutes": 41,
"seconds": 55
},
"speed": 0.00040231041884908336
},
{
"id": "ketu_true",
"longitude": 122.6986,
"sign": "leo",
"degree_in_sign": 2.6986,
"nakshatra": "magha",
"pada": 1,
"retrograde": true,
"nakshatra_lord": "ketu",
"sub_lord": "venus",
"combust": false,
"dms": {
"degrees": 2,
"minutes": 41,
"seconds": 55
},
"speed": 0.00040231041884908336
}
],
"local": {
"date": "2026-11-03",
"time": "07:30:00",
"weekday": "tuesday",
"timezone": {
"name": "Asia/Kolkata",
"offset_hours": 5.5
}
},
"ayanamsa": 24.2343,
"julian_day": 2461347.58333
},
"meta": {
"request_id": "req_example",
"api_version": "v1",
"engine_version": "2026.10.10",
"mode": "live",
"credits_charged": 1,
"ayanamsa": "lahiri",
"house_system": "whole_sign",
"node": "true",
"timezone_used": {
"name": "Asia/Kolkata",
"utc_offset": "+05:30",
"source": "auto"
},
"valid_until": "2026-11-03T03:00:00.000Z"
},
"warnings": []
}Try it
More in Kundli
- Kundli Chart API: Lagna and Nine Grahas: Birth chart: lagna and the nine grahas
- Avakhada Birth Details API: Avakhada birth details
- Divisional Charts API (D1–D60, Navamsa): Divisional charts D1–D60
- Graha Drishti (Aspects) API: Graha drishti: houses and planets aspected
- Kundli Yogas API: Yogas present, with strength and rule
- Ashtakavarga API: Bhinna and Sarva Ashtakavarga, the bindus of the signs being transited, each planet's best and worst signs
- Wealth Astrology API (D2, D9, D10): Wealth reading from D1, D2, D9 and D10: hora placements, the D10 lagna and 10th lord, vargottama, scores 0–10
- Gemstone Recommendation API: Gemstones by functional lordship: the lagna lord's, the 9th (or 5th) lord's, the mahadasha lord's, and those to avoid
- Shadbala API: Shadbala: the six-fold strength of the seven grahas
- Bhava Bala and Graha Avastha API: The classical layer: house cusps, bhava bala, prastara ashtakavarga, graha avasthas, sthira karakas, lucky points
- Outer Planets in the Kundli API: Uranus, Neptune and Pluto: sidereal position, house from the lagna, and the house reading in English and Hindi
- Dwadasamsa (D12) API: Dwadasamsa (D12) read for the lineage: father, mother, the 4th and 9th, strength 0–10
- Upagrahas API (Gulika and More): Upagrahas: the five from the Sun, and Kala, Mrityu, Ardhaprahara, Yamaghantaka and Gulika from the day's eight parts
- Arudha Lagna and Upapada API: Arudha padas of the twelve houses, with Arudha Lagna and Upapada
- Jaimini Chara Karaka API: Jaimini chara karakas on the seven-planet scheme, with the karakamsha
- Bhav Chalit Chart API: Bhav chalit: the Sripati bhavas, and which planets shift from their rashi house
- Planet Combustion (Asta and Uday) API: Asta and Uday: when each planet sets and rises near the Sun, for a place
- Sidereal Ephemeris Series API: A series of sidereal positions over a range, at up to 400 steps
- Rashi Reference API: The 12 rashis: span, lord, element, modality, varna, vashya and nakshatras
- Nakshatra Reference API: The 27 nakshatras: span, lord, gana, yoni, nadi, deity and symbol
- Sidereal Planet Positions API: Sidereal positions at any moment and place
- Retrograde Cycle API (Saturn to Pluto): The retrograde cycle of Saturn, Uranus, Neptune or Pluto: its stations and whether it is retrograde now
- Kundli Bundle API: Several Charts in One Call: Several chart operations in one call: one rate-limit slot, charged their sum less one credit