"""

AUTO-GENERATED by codegen.py from OpenAPI spec. Do not edit manually.

Regenerate with: python generate.py

"""

from __future__ import annotations

from typing import Any

import httpx

from roxy_sdk.version import VERSION

_BASE_URL = "https://roxyapi.com/api/v2"

class RoxyAPIError(Exception):

"""Error returned by the RoxyAPI."""

def __init__(self, error: str, code: str, status_code: int) -> None:

self.error = error

self.code = code

self.status_code = status_code

super().__init__(f"[{status_code}] {code}: {error}")

def __repr__(self) -> str:

return f"RoxyAPIError(error={self.error!r}, code={self.code!r}, status_code={self.status_code})"

def _default_headers(api_key: str) -> dict[str, str]:

return {

"X-API-Key": api_key,

"X-SDK-Client": f"roxy-sdk-python/{VERSION}",

"Accept": "application/json",

}

def _handle_response(resp: httpx.Response) -> Any:

"""Parse response, raising RoxyAPIError on 4xx/5xx."""

if resp.status_code >= 400:

try:

body = resp.json()

except Exception:

body = {}

raise RoxyAPIError(

error=body.get("error", resp.text or "Unknown error"),

code=body.get("code", "unknown"),

status_code=resp.status_code,

)

return resp.json()

class _BaseDomain:

"""Base class for all domain namespaces."""

def __init__(self, client: httpx.Client, async_client: httpx.AsyncClient) -> None:

self._client = client

self._async_client = async_client

def _get(self, path: str, params: dict[str, Any] | None = None) -> Any:

return _handle_response(self._client.get(path, params=params))

async def _get_async(self, path: str, params: dict[str, Any] | None = None) -> Any:

return _handle_response(await self._async_client.get(path, params=params))

def _post(self, path: str, body: dict[str, Any] | None = None, params: dict[str, Any] | None = None) -> Any:

return _handle_response(self._client.post(path, json=body, params=params))

async def _post_async(self, path: str, body: dict[str, Any] | None = None, params: dict[str, Any] | None = None) -> Any:

return _handle_response(await self._async_client.post(path, json=body, params=params))

class AstrologyDomain(_BaseDomain):

"""Western astrology API for natal birth charts, daily, weekly, monthly, and yearly horoscopes with unique content per s..."""

def calculate_arabic_lots(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Arabic lots calculator - seven Hermetic parts including Part of Fortune and Spirit"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/arabic-lots", body, params=params or None)

async def calculate_arabic_lots_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Arabic lots calculator - seven Hermetic parts including Part of Fortune and Spirit (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/arabic-lots", body, params=params or None)

def calculate_aspects(self, *, date: str, time: str, timezone: str, planets: list[str] | None = None, aspect_types: list[str] | None = None, lang: str | None = None) -> Any:

"""Calculate planetary aspects - Aspect finder for any date and time"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["timezone"] = timezone

if planets is not None:

body["planets"] = planets

if aspect_types is not None:

body["aspectTypes"] = aspect_types

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/aspects", body, params=params or None)

async def calculate_aspects_async(self, *, date: str, time: str, timezone: str, planets: list[str] | None = None, aspect_types: list[str] | None = None, lang: str | None = None) -> Any:

"""Calculate planetary aspects - Aspect finder for any date and time (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["timezone"] = timezone

if planets is not None:

body["planets"] = planets

if aspect_types is not None:

body["aspectTypes"] = aspect_types

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/aspects", body, params=params or None)

def calculate_compatibility(self, *, person1: dict[str, Any], person2: dict[str, Any], lang: str | None = None) -> Any:

"""Compatibility score - Relationship compatibility API"""

body: dict[str, Any] = {}

body["person1"] = person1

body["person2"] = person2

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/compatibility-score", body, params=params or None)

async def calculate_compatibility_async(self, *, person1: dict[str, Any], person2: dict[str, Any], lang: str | None = None) -> Any:

"""Compatibility score - Relationship compatibility API (async)"""

body: dict[str, Any] = {}

body["person1"] = person1

body["person2"] = person2

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/compatibility-score", body, params=params or None)

def calculate_houses(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Calculate house cusps - House system calculator with comparison"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/houses", body, params=params or None)

async def calculate_houses_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Calculate house cusps - House system calculator with comparison (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/houses", body, params=params or None)

def calculate_synastry(self, *, person1: dict[str, Any], person2: dict[str, Any], house_system: str | None = None, lang: str | None = None) -> Any:

"""Calculate synastry - Relationship compatibility analysis API"""

body: dict[str, Any] = {}

body["person1"] = person1

body["person2"] = person2

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/synastry", body, params=params or None)

async def calculate_synastry_async(self, *, person1: dict[str, Any], person2: dict[str, Any], house_system: str | None = None, lang: str | None = None) -> Any:

"""Calculate synastry - Relationship compatibility analysis API (async)"""

body: dict[str, Any] = {}

body["person1"] = person1

body["person2"] = person2

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/synastry", body, params=params or None)

def calculate_transit_aspects(self, *, natal_chart: dict[str, Any], transit_date: str | None = None, transit_time: str | None = None, planets: list[str] | None = None, aspect_types: list[str] | None = None, min_strength: float | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Transit Aspects - Detailed transit-to-natal aspect analysis with interpretations"""

body: dict[str, Any] = {}

body["natalChart"] = natal_chart

if transit_date is not None:

body["transitDate"] = transit_date

if transit_time is not None:

body["transitTime"] = transit_time

if planets is not None:

body["planets"] = planets

if aspect_types is not None:

body["aspectTypes"] = aspect_types

if min_strength is not None:

body["minStrength"] = min_strength

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/transit-aspects", body, params=params or None)

async def calculate_transit_aspects_async(self, *, natal_chart: dict[str, Any], transit_date: str | None = None, transit_time: str | None = None, planets: list[str] | None = None, aspect_types: list[str] | None = None, min_strength: float | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Transit Aspects - Detailed transit-to-natal aspect analysis with interpretations (async)"""

body: dict[str, Any] = {}

body["natalChart"] = natal_chart

if transit_date is not None:

body["transitDate"] = transit_date

if transit_time is not None:

body["transitTime"] = transit_time

if planets is not None:

body["planets"] = planets

if aspect_types is not None:

body["aspectTypes"] = aspect_types

if min_strength is not None:

body["minStrength"] = min_strength

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/transit-aspects", body, params=params or None)

def calculate_transits(self, *, date: str | None = None, time: str | None = None, timezone: str | None = None, node_type: str | None = None, natal_chart: dict[str, Any] | None = None, lang: str | None = None) -> Any:

"""Calculate planetary transits - Current transits with natal chart comparison"""

body: dict[str, Any] = {}

if date is not None:

body["date"] = date

if time is not None:

body["time"] = time

if timezone is not None:

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if natal_chart is not None:

body["natalChart"] = natal_chart

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/transits", body, params=params or None)

async def calculate_transits_async(self, *, date: str | None = None, time: str | None = None, timezone: str | None = None, node_type: str | None = None, natal_chart: dict[str, Any] | None = None, lang: str | None = None) -> Any:

"""Calculate planetary transits - Current transits with natal chart comparison (async)"""

body: dict[str, Any] = {}

if date is not None:

body["date"] = date

if time is not None:

body["time"] = time

if timezone is not None:

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if natal_chart is not None:

body["natalChart"] = natal_chart

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/transits", body, params=params or None)

def detect_aspect_patterns(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, strict_orbs: str | None = None, include: str | None = None, lang: str | None = None) -> Any:

"""Detect aspect patterns - Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/aspect-patterns", body, params=params or None)

async def detect_aspect_patterns_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, strict_orbs: str | None = None, include: str | None = None, lang: str | None = None) -> Any:

"""Detect aspect patterns - Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/aspect-patterns", body, params=params or None)

def generate_asteroids(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Asteroid goddesses calculator - Ceres, Pallas, Juno, and Vesta natal positions"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/asteroids", body, params=params or None)

async def generate_asteroids_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Asteroid goddesses calculator - Ceres, Pallas, Juno, and Vesta natal positions (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/asteroids", body, params=params or None)

def generate_astrocartography(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, include: str | None = None, lang: str | None = None) -> Any:

"""Astrocartography map - planetary lines and relocation calculator"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/astrocartography", body, params=params or None)

async def generate_astrocartography_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, include: str | None = None, lang: str | None = None) -> Any:

"""Astrocartography map - planetary lines and relocation calculator (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/astrocartography", body, params=params or None)

def generate_composite_chart(self, *, person1: dict[str, Any], person2: dict[str, Any], house_system: str | None = None, lang: str | None = None) -> Any:

"""Composite Chart - Midpoint relationship chart with interpretations"""

body: dict[str, Any] = {}

body["person1"] = person1

body["person2"] = person2

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/composite-chart", body, params=params or None)

async def generate_composite_chart_async(self, *, person1: dict[str, Any], person2: dict[str, Any], house_system: str | None = None, lang: str | None = None) -> Any:

"""Composite Chart - Midpoint relationship chart with interpretations (async)"""

body: dict[str, Any] = {}

body["person1"] = person1

body["person2"] = person2

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/composite-chart", body, params=params or None)

def generate_fixed_stars(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, orb: float | None = None, lang: str | None = None) -> Any:

"""Fixed stars and star conjunctions calculator - Regulus, Spica, Algol natal report"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/fixed-stars", body, params=params or None)

async def generate_fixed_stars_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, orb: float | None = None, lang: str | None = None) -> Any:

"""Fixed stars and star conjunctions calculator - Regulus, Spica, Algol natal report (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/fixed-stars", body, params=params or None)

def generate_lilith(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Black Moon Lilith calculator - mean and true lunar apogee in the natal chart"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/lilith", body, params=params or None)

async def generate_lilith_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Black Moon Lilith calculator - mean and true lunar apogee in the natal chart (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/lilith", body, params=params or None)

def generate_local_space(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, include: str | None = None, lang: str | None = None) -> Any:

"""Local space astrology map - Directional planetary compass lines"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/local-space", body, params=params or None)

async def generate_local_space_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, include: str | None = None, lang: str | None = None) -> Any:

"""Local space astrology map - Directional planetary compass lines (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/local-space", body, params=params or None)

def generate_lunar_return(self, *, birth_date: str, birth_time: str, return_date: str, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Lunar Return Chart - Monthly emotional forecast with Moon cycle chart"""

body: dict[str, Any] = {}

body["birthDate"] = birth_date

body["birthTime"] = birth_time

body["returnDate"] = return_date

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/lunar-return", body, params=params or None)

async def generate_lunar_return_async(self, *, birth_date: str, birth_time: str, return_date: str, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Lunar Return Chart - Monthly emotional forecast with Moon cycle chart (async)"""

body: dict[str, Any] = {}

body["birthDate"] = birth_date

body["birthTime"] = birth_time

body["returnDate"] = return_date

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/lunar-return", body, params=params or None)

def generate_natal_chart(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Generate natal chart - Birth chart calculator API with houses and aspects"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/natal-chart", body, params=params or None)

async def generate_natal_chart_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, house_system: str | None = None, lang: str | None = None) -> Any:

"""Generate natal chart - Birth chart calculator API with houses and aspects (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/natal-chart", body, params=params or None)

def generate_planetary_return(self, *, birth_date: str, birth_time: str, planet: str, approximate_date: str, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Planetary Return Chart - Saturn return, Jupiter return, and inner planet cycles"""

body: dict[str, Any] = {}

body["birthDate"] = birth_date

body["birthTime"] = birth_time

body["planet"] = planet

body["approximateDate"] = approximate_date

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/planetary-returns", body, params=params or None)

async def generate_planetary_return_async(self, *, birth_date: str, birth_time: str, planet: str, approximate_date: str, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Planetary Return Chart - Saturn return, Jupiter return, and inner planet cycles (async)"""

body: dict[str, Any] = {}

body["birthDate"] = birth_date

body["birthTime"] = birth_time

body["planet"] = planet

body["approximateDate"] = approximate_date

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/planetary-returns", body, params=params or None)

def generate_profections(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, target_date: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Annual profections calculator - lord of the year and yearly time lord by age"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

body["targetDate"] = target_date

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/profections", body, params=params or None)

async def generate_profections_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, target_date: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Annual profections calculator - lord of the year and yearly time lord by age (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

body["targetDate"] = target_date

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/profections", body, params=params or None)

def generate_progressions(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, target_date: str, lang: str | None = None) -> Any:

"""Secondary progressions calculator - progressed chart, progressed Sun and Moon"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

body["targetDate"] = target_date

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/progressions", body, params=params or None)

async def generate_progressions_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, target_date: str, lang: str | None = None) -> Any:

"""Secondary progressions calculator - progressed chart, progressed Sun and Moon (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

body["targetDate"] = target_date

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/progressions", body, params=params or None)

def generate_relocation_chart(self, *, date: str, time: str, timezone: str, birth_latitude: float, birth_longitude: float, relocation_latitude: float, relocation_longitude: float, house_system: str | None = None, lang: str | None = None) -> Any:

"""Generate relocation chart - Relocated birth chart calculator with shifted houses and angles"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["timezone"] = timezone

body["birthLatitude"] = birth_latitude

body["birthLongitude"] = birth_longitude

body["relocationLatitude"] = relocation_latitude

body["relocationLongitude"] = relocation_longitude

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/relocation-chart", body, params=params or None)

async def generate_relocation_chart_async(self, *, date: str, time: str, timezone: str, birth_latitude: float, birth_longitude: float, relocation_latitude: float, relocation_longitude: float, house_system: str | None = None, lang: str | None = None) -> Any:

"""Generate relocation chart - Relocated birth chart calculator with shifted houses and angles (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["timezone"] = timezone

body["birthLatitude"] = birth_latitude

body["birthLongitude"] = birth_longitude

body["relocationLatitude"] = relocation_latitude

body["relocationLongitude"] = relocation_longitude

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/relocation-chart", body, params=params or None)

def generate_solar_arc(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, target_date: str, lang: str | None = None) -> Any:

"""Solar arc directions calculator - directed chart at one degree per year"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

body["targetDate"] = target_date

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/solar-arc", body, params=params or None)

async def generate_solar_arc_async(self, *, date: str, time: str, latitude: float, longitude: float, timezone: str, node_type: str | None = None, target_date: str, lang: str | None = None) -> Any:

"""Solar arc directions calculator - directed chart at one degree per year (async)"""

body: dict[str, Any] = {}

body["date"] = date

body["time"] = time

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

body["targetDate"] = target_date

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/solar-arc", body, params=params or None)

def generate_solar_return(self, *, birth_date: str, birth_time: str, return_year: int, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Solar Return Chart - Annual birthday forecast with relocated chart"""

body: dict[str, Any] = {}

body["birthDate"] = birth_date

body["birthTime"] = birth_time

body["returnYear"] = return_year

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/solar-return", body, params=params or None)

async def generate_solar_return_async(self, *, birth_date: str, birth_time: str, return_year: int, latitude: float, longitude: float, timezone: str, house_system: str | None = None, lang: str | None = None) -> Any:

"""Solar Return Chart - Annual birthday forecast with relocated chart (async)"""

body: dict[str, Any] = {}

body["birthDate"] = birth_date

body["birthTime"] = birth_time

body["returnYear"] = return_year

body["latitude"] = latitude

body["longitude"] = longitude

body["timezone"] = timezone

if house_system is not None:

body["houseSystem"] = house_system

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/solar-return", body, params=params or None)

def get_current_moon_phase(self, *, date: str | None = None, time: str | None = None, timezone: str | None = None, lang: str | None = None) -> Any:

"""Get current moon phase - Lunar phase calculator with zodiac sign"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

if date is not None:

params["date"] = date

if time is not None:

params["time"] = time

if timezone is not None:

params["timezone"] = timezone

return self._get(f"/astrology/moon-phase/current", params=params or None)

async def get_current_moon_phase_async(self, *, date: str | None = None, time: str | None = None, timezone: str | None = None, lang: str | None = None) -> Any:

"""Get current moon phase - Lunar phase calculator with zodiac sign (async)"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

if date is not None:

params["date"] = date

if time is not None:

params["time"] = time

if timezone is not None:

params["timezone"] = timezone

return await self._get_async(f"/astrology/moon-phase/current", params=params or None)

def get_daily_horoscope(self, *, sign: str, date: str | None = None, timezone: str | None = None, lang: str | None = None) -> Any:

"""Daily horoscope by zodiac sign - Transit-based editorial columns"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

if date is not None:

params["date"] = date

if timezone is not None:

params["timezone"] = timezone

return self._get(f"/astrology/horoscope/{sign}/daily", params=params or None)

async def get_daily_horoscope_async(self, *, sign: str, date: str | None = None, timezone: str | None = None, lang: str | None = None) -> Any:

"""Daily horoscope by zodiac sign - Transit-based editorial columns (async)"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

if date is not None:

params["date"] = date

if timezone is not None:

params["timezone"] = timezone

return await self._get_async(f"/astrology/horoscope/{sign}/daily", params=params or None)

def get_monthly_declination_parallels(self, *, year: int | None = None, month: int | None = None, timezone: str | None = None, orb: float | None = None, node_type: str | None = None, lang: str | None = None) -> Any:

"""Monthly Parallels - Declination contacts for an entire month"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

if timezone is not None:

body["timezone"] = timezone

if orb is not None:

body["orb"] = orb

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/parallels/monthly", body, params=params or None)

async def get_monthly_declination_parallels_async(self, *, year: int | None = None, month: int | None = None, timezone: str | None = None, orb: float | None = None, node_type: str | None = None, lang: str | None = None) -> Any:

"""Monthly Parallels - Declination contacts for an entire month (async)"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

if timezone is not None:

body["timezone"] = timezone

if orb is not None:

body["orb"] = orb

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/parallels/monthly", body, params=params or None)

def get_monthly_horoscope(self, *, sign: str, date: str | None = None, timezone: str | None = None, lang: str | None = None) -> Any:

"""Monthly horoscope by zodiac sign - Editorial column with key dates"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

if date is not None:

params["date"] = date

if timezone is not None:

params["timezone"] = timezone

return self._get(f"/astrology/horoscope/{sign}/monthly", params=params or None)

async def get_monthly_horoscope_async(self, *, sign: str, date: str | None = None, timezone: str | None = None, lang: str | None = None) -> Any:

"""Monthly horoscope by zodiac sign - Editorial column with key dates (async)"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

if date is not None:

params["date"] = date

if timezone is not None:

params["timezone"] = timezone

return await self._get_async(f"/astrology/horoscope/{sign}/monthly", params=params or None)

def get_monthly_tropical_aspects(self, *, year: int | None = None, month: int | None = None, timezone: str | None = None, node_type: str | None = None, lang: str | None = None) -> Any:

"""Monthly Aspects - Tropical aspect calendar for an entire month"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

if timezone is not None:

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/aspects/monthly", body, params=params or None)

async def get_monthly_tropical_aspects_async(self, *, year: int | None = None, month: int | None = None, timezone: str | None = None, node_type: str | None = None, lang: str | None = None) -> Any:

"""Monthly Aspects - Tropical aspect calendar for an entire month (async)"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

if timezone is not None:

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/aspects/monthly", body, params=params or None)

def get_monthly_tropical_ephemeris(self, *, year: int | None = None, month: int | None = None, lang: str | None = None) -> Any:

"""Monthly Ephemeris - Daily tropical planetary positions for a month"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/planets/monthly", body, params=params or None)

async def get_monthly_tropical_ephemeris_async(self, *, year: int | None = None, month: int | None = None, lang: str | None = None) -> Any:

"""Monthly Ephemeris - Daily tropical planetary positions for a month (async)"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/planets/monthly", body, params=params or None)

def get_monthly_tropical_transits(self, *, year: int | None = None, month: int | None = None, timezone: str | None = None, node_type: str | None = None, lang: str | None = None) -> Any:

"""Monthly Transits - Tropical sign ingresses for an entire month"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

if timezone is not None:

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/transits/monthly", body, params=params or None)

async def get_monthly_tropical_transits_async(self, *, year: int | None = None, month: int | None = None, timezone: str | None = None, node_type: str | None = None, lang: str | None = None) -> Any:

"""Monthly Transits - Tropical sign ingresses for an entire month (async)"""

body: dict[str, Any] = {}

if year is not None:

body["year"] = year

if month is not None:

body["month"] = month

if timezone is not None:

body["timezone"] = timezone

if node_type is not None:

body["nodeType"] = node_type

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._post_async(f"/astrology/transits/monthly", body, params=params or None)

def get_moon_calendar(self, *, year: str, month: str, lang: str | None = None) -> Any:

"""Get lunar calendar - Moon phases for entire month"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._get(f"/astrology/moon-phase/calendar/{year}/{month}", params=params or None)

async def get_moon_calendar_async(self, *, year: str, month: str, lang: str | None = None) -> Any:

"""Get lunar calendar - Moon phases for entire month (async)"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._get_async(f"/astrology/moon-phase/calendar/{year}/{month}", params=params or None)

def get_planet_meaning(self, *, id: str, lang: str | None = None) -> Any:

"""Get planet meaning details - Complete astrology planet interpretation"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._get(f"/astrology/planet-meanings/{id}", params=params or None)

async def get_planet_meaning_async(self, *, id: str, lang: str | None = None) -> Any:

"""Get planet meaning details - Complete astrology planet interpretation (async)"""

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return await self._get_async(f"/astrology/planet-meanings/{id}", params=params or None)

def get_planetary_node_passages(self, *, year: int, timezone: str | None = None, lang: str | None = None) -> Any:

"""Ecliptic Crossings - Node passages for a whole year"""

body: dict[str, Any] = {}

body["year"] = year

if timezone is not None:

body["timezone"] = timezone

params: dict[str, Any] = {}

if lang is not None:

params["lang"] = lang

return self._post(f"/astrology/ecliptic-crossings", body, params=params or None)

async def get_planetary_node_passages_async(self, *, year: int, timezone: str | None = None, lang: str | None = None) -> Any:

"""Ecliptic Crossings - Node passages for a whole year (async)"""