Endpoint
Daily horoscope
Calculator output: transits, themes, and transit-to-natal aspects. This is not the product AI report at /horoscope.
POST
/api/v1/horoscope/daily
Request
{
"date": "2026-01-15",
"natal": {
"day": 15,
"hour": 14,
"latitude": 40.7128,
"longitude": -74.006,
"minute": 30,
"month": 5,
"year": 1990
}
}
Response (truncated)
{
"calculated_at": "2026-01-15T12:00:00Z",
"date": "2026-01-15",
"request_id": "a1b2c3d4e5f6",
"result": {
"moon_phase": {
"illumination_percent": 18.4,
"phase": "Waxing Crescent"
},
"summary": "A focused day for priorities and one decisive conversation.",
"themes": {
"career": 7,
"love": 5,
"overall": 6
},
"transit_to_natal_aspects": [],
"transits": {
"planets": [
{
"degree": 25.1,
"name": "Sun",
"sign": "Capricorn"
}
]
}
},
"usage": {
"daily_limit": 500,
"requests_this_day": 12,
"scope": "account_plan"
}
}
Parameters
| Field | Required | Notes |
|---|---|---|
| natal | yes | Nested birth packet; flat year/month/day is 400 |
| natal.location | alt | Or latitude/longitude |
| date | no | YYYY-MM-DD, default today |