Skip to main content
Log in Get Started
Browse the API

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