Simple Signs

POST/api/v1/western/signs/[point]

Lightweight specialized endpoints for calculating specific chart points (Sun, Moon, Rising, Midheaven) with targeted professional interpretations. Perfect for focused widgets and rapid analysis.

Available Endpoints

Sun Sign/western/signs/sun

Moon Sign/western/signs/moon

Rising Sign (ASC)/western/signs/rising

Midheaven (MC)/western/signs/midheaven

Request Parameters

Parameter	Type	Req	Description
year	integer	Yes	Birth year (e.g., 1990)
month	integer	Yes	Birth month (1-12)
day	integer	Yes	Birth day (1-31)
hour	integer	Yes	Birth hour (0-23)
minute	integer	Yes	Birth minute (0-59)
city	string	Yes	City name for coordinate resolution
lat	float	No	Manual latitude override
lng	float	No	Manual longitude override
tz_str	string	No	Timezone string or 'AUTO' (default)
house_system	string	No	placidus (default), whole_sign, etc. affects 'house' field
zodiac_type	string	No	tropical (default) or sidereal
interpretation	object	No	{enable: bool, style: 'improved'\|'poetic'}

Targeted Interpretations

Unlike the full natal endpoint, these endpoints return only the atomic interpretation block matching the specific point. This significantly reduces response size and delivery time.

Classical Improved

"Professional, neutral tone with concrete psychological insights. Best for modern apps."

Poetic

"Narrative, soulful style focusing on internal resonance and growth."

Execution Examples

curl -X POST "https://api.freeastroapi.com/api/v1/western/signs/sun" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "city": "New York",
    "interpretation": {
        "enable": true,
        "style": "improved"
    }
}'

JSON Response

{
  "point": "Sun",
  "sign": "Tau",
  "sign_id": "taurus",
  "degree": 24.72,
  "abs_pos": 54.72,
  "house": 9,
  "interpretation": {
    "id": "b3770758...",
    "key": "planet.sun.sign.taurus",
    "title": "Sun in Taurus",
    "body": "Your core identity is expressed through stability, patience, and a deep appreciation for the material world...",
    "tone": "improved"
  }
}