Annual Flying Stars API
A year's flying stars, Five Yellow, Tai Sui, Sui Po and San Sha, with the twelve monthly charts
POST/v1/feng-shui/annual
1 credit · Secret key (test or live) · getFengShuiAnnual
Request body
yearinteger required≥ 1901 · ≤ 2099
optionsobjectlangstring requiredone of
en,hi· default"en"
No other fields are accepted.
No other fields are accepted.
Response
JSON { data, meta, warnings }, where data is:
yearinteger requiredfromstring (date-time) requiredtostring (date-time) requiredyear_pillarstring requiredperiodinteger requiredcenter_starinteger requiredstarsarray of object requiredpalaceobject requiredFields
idstring requirednamestring required
starinteger required
five_yellowobject requiredidstring requirednamestring required
tai_suiobject requiredidstring requiredchinesestring requiredpalaceobject requiredFields
idstring requirednamestring required
order_in_palaceinteger requiredfrom_degreenumber requiredto_degreenumber required
sui_poobject requiredidstring requiredchinesestring requiredpalaceobject requiredFields
idstring requirednamestring required
order_in_palaceinteger requiredfrom_degreenumber requiredto_degreenumber required
san_shaobject requiredidstring requirednamestring required
monthsarray of object requiredmonthinteger requiredcenter_starinteger requiredfive_yellowobject requiredFields
idstring requirednamestring required
starsarray of object requiredFields
palaceobject requiredFields
idstring requirednamestring required
starinteger required
Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.
Example request
curl -X POST 'https://api.astrologics.in/v1/feng-shui/annual' \
-H 'Authorization: Bearer al_test_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"year":2026}'Node.js
const res = await fetch("https://api.astrologics.in/v1/feng-shui/annual", {
method: "POST",
headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
"year": 2026
}),
});
console.log(JSON.stringify(await res.json(), null, 2));Python
import json
import urllib.error
import urllib.request
body = {
"year": 2026,
}
req = urllib.request.Request(
"https://api.astrologics.in/v1/feng-shui/annual",
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/feng-shui/annual');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"year":2026}',
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;Example response
200 OK · 19,633 characters
{
"data": {
"year": 2026,
"from": "2026-02-03T20:01:54.541Z",
"to": "2027-02-04T01:46:24.431Z",
"year_pillar": "丙午",
"period": 9,
"center_star": 1,
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 2
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 3
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 4
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 5
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 6
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 7
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 8
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 9
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 1
}
],
"five_yellow": {
"id": "S",
"name": "south"
},
"tai_sui": {
"id": "wu",
"chinese": "午",
"palace": {
"id": "S",
"name": "south"
},
"order_in_palace": 2,
"from_degree": 172.5,
"to_degree": 187.5
},
"sui_po": {
"id": "zi",
"chinese": "子",
"palace": {
"id": "N",
"name": "north"
},
"order_in_palace": 2,
"from_degree": 352.5,
"to_degree": 7.5
},
"san_sha": {
"id": "N",
"name": "north"
},
"months": [
{
"month": 1,
"center_star": 8,
"five_yellow": {
"id": "SW",
"name": "southwest"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 9
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 1
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 2
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 3
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 4
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 5
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 6
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 7
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 8
}
]
},
{
"month": 2,
"center_star": 7,
"five_yellow": {
"id": "E",
"name": "east"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 8
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 9
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 1
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 2
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 3
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 4
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 5
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 6
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 7
}
]
},
{
"month": 3,
"center_star": 6,
"five_yellow": {
"id": "SE",
"name": "southeast"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 7
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 8
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 9
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 1
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 2
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 3
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 4
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 5
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 6
}
]
},
{
"month": 4,
"center_star": 5,
"five_yellow": {
"id": "center",
"name": "center"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 6
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 7
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 8
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 9
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 1
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 2
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 3
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 4
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 5
}
]
},
{
"month": 5,
"center_star": 4,
"five_yellow": {
"id": "NW",
"name": "northwest"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 5
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 6
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 7
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 8
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 9
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 1
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 2
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 3
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 4
}
]
},
{
"month": 6,
"center_star": 3,
"five_yellow": {
"id": "W",
"name": "west"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 4
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 5
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 6
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 7
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 8
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 9
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 1
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 2
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 3
}
]
},
{
"month": 7,
"center_star": 2,
"five_yellow": {
"id": "NE",
"name": "northeast"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 3
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 4
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 5
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 6
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 7
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 8
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 9
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 1
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 2
}
]
},
{
"month": 8,
"center_star": 1,
"five_yellow": {
"id": "S",
"name": "south"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 2
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 3
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 4
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 5
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 6
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 7
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 8
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 9
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 1
}
]
},
{
"month": 9,
"center_star": 9,
"five_yellow": {
"id": "N",
"name": "north"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 1
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 2
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 3
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 4
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 5
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 6
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 7
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 8
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 9
}
]
},
{
"month": 10,
"center_star": 8,
"five_yellow": {
"id": "SW",
"name": "southwest"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 9
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 1
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 2
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 3
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 4
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 5
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 6
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 7
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 8
}
]
},
{
"month": 11,
"center_star": 7,
"five_yellow": {
"id": "E",
"name": "east"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 8
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 9
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 1
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 2
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 3
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 4
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 5
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 6
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 7
}
]
},
{
"month": 12,
"center_star": 6,
"five_yellow": {
"id": "SE",
"name": "southeast"
},
"stars": [
{
"palace": {
"id": "NW",
"name": "northwest"
},
"star": 7
},
{
"palace": {
"id": "W",
"name": "west"
},
"star": 8
},
{
"palace": {
"id": "NE",
"name": "northeast"
},
"star": 9
},
{
"palace": {
"id": "S",
"name": "south"
},
"star": 1
},
{
"palace": {
"id": "N",
"name": "north"
},
"star": 2
},
{
"palace": {
"id": "SW",
"name": "southwest"
},
"star": 3
},
{
"palace": {
"id": "E",
"name": "east"
},
"star": 4
},
{
"palace": {
"id": "SE",
"name": "southeast"
},
"star": 5
},
{
"palace": {
"id": "center",
"name": "center"
},
"star": 6
}
]
}
]
},
"meta": {
"request_id": "req_example",
"api_version": "v1",
"engine_version": "2026.10.10",
"mode": "live",
"credits_charged": 1
},
"warnings": []
}Try it
More in Feng Shui
- Kua Number API: A person's Kua number, East or West group and eight directions
- Feng Shui House Gua API: A building's gua from its facing, its eight mansions, and how it fits an occupant's Kua
- Flying Star Chart API: A Xuan Kong flying star chart: base, mountain and water stars in all nine palaces, and its structure
- Flying Star Grid SVG API: The flying star chart drawn as a nine-palace grid in SVG, south at the top