roxy-sdk

from roxy_sdk import create_roxy

roxy = create_roxy("your-api-key")

horoscope = roxy.astrology.get_daily_horoscope(sign="aries")
print(horoscope["overview"], horoscope["love"], horoscope["luckyNumber"])

from roxy_sdk import create_roxy

roxy = create_roxy("your-api-key")

# Step 1: geocode the birth city (required for any chart endpoint)
result = roxy.location.search_cities(q="London, UK")
city = result["cities"][0]
lat, lng, tz = city["latitude"], city["longitude"], city["timezone"]

# Step 2: Western natal chart. `timezone` can be the IANA string ("Europe/London").
# The server resolves it to the DST-correct offset for the date of the chart.
natal = roxy.astrology.generate_natal_chart(
    date="1990-01-15",
    time="14:30:00",
    latitude=lat,
    longitude=lng,
    timezone=tz,
)

# Vedic kundli takes the same inputs (timezone optional, defaults to 5.5 IST).
kundli = roxy.vedic_astrology.generate_birth_chart(
    date="1990-01-15",
    time="14:30:00",
    latitude=lat,
    longitude=lng,
    timezone=tz,
)

# One lookup feeds every chart below. `timezone` is the IANA name from the city
# record; the server resolves it to the DST-correct offset for the date of each chart.
place = roxy.location.search_cities(q="New York")
city = place["cities"][0]
latitude, longitude, timezone = city["latitude"], city["longitude"], city["timezone"]
birth = {"date": "1990-01-15", "time": "14:30:00", "latitude": latitude, "longitude": longitude, "timezone": timezone}

# A second person for the two-chart calls (synastry, Guna Milan, Human Design connection).
london = roxy.location.search_cities(q="London")
london_city = london["cities"][0]
lat2, lon2, tz2 = london_city["latitude"], london_city["longitude"], london_city["timezone"]
partner = {"date": "1992-07-22", "time": "09:00:00", "latitude": lat2, "longitude": lon2, "timezone": tz2}

# Natal chart. The most requested Western call, run once at onboarding.
# `birth` carries the latitude, longitude and timezone from the location lookup above.
natal = roxy.astrology.generate_natal_chart(**birth)
# natal["planets"][n]["name"], ["sign"], ["house"], ["interpretation"]["summary"]; natal["ascendant"]["sign"]; natal["aspects"]

# Daily horoscope. The highest per-user call frequency in the catalog: daily content, streaks, push.
horoscope = roxy.astrology.get_daily_horoscope(sign="aries")
# horoscope["overview"], horoscope["love"], horoscope["career"], horoscope["column"], horoscope["events"], horoscope["luckyNumber"]

# Synastry. Full inter-aspect analysis between two charts, the relationship feature of dating apps.
synastry = roxy.astrology.calculate_synastry(person1=birth, person2=partner)
# synastry["compatibilityScore"], synastry["interAspects"], synastry["analysis"]["strengths"]

# Moon phase. A zero-setup call for wellness, cycle-tracking and meditation apps.
moon = roxy.astrology.get_current_moon_phase()
# moon["phase"], moon["illumination"], moon["sign"], moon["meaning"]["description"]

# Vedic kundli. The same birth read sidereally: `birth` reuses the location lookup above.
kundli = roxy.vedic_astrology.generate_birth_chart(**birth)
# kundli["meta"]["Moon"]["rashi"], kundli["meta"]["Moon"]["nakshatra"], kundli["houses"], kundli["combustion"]

# Detailed panchang. Tithi, nakshatra, yoga, karana, rahu kaal and the muhurtas for a date and place.
panchang = roxy.vedic_astrology.get_detailed_panchang(date="2026-10-01", latitude=latitude, longitude=longitude, timezone=timezone)
# panchang["tithi"], panchang["nakshatra"], panchang["rahuKaal"], panchang["abhijitMuhurta"]

# Vimshottari dasha. The mahadasha, antardasha and pratyantardasha running right now.
dasha = roxy.vedic_astrology.get_current_dasha(**birth)
# dasha["mahadasha"], dasha["antardasha"], dasha["remainingInMahadasha"]

# Mangal Dosha. The most asked matrimonial check.
dosha = roxy.vedic_astrology.check_manglik_dosha(**birth)
# dosha["present"]; dosha["severity"] and dosha["remedies"] are set only when present is true

# Guna Milan. The 36-point Ashtakoota score behind kundli matching, both people from the lookups above.
milan = roxy.vedic_astrology.calculate_gun_milan(person1=birth, person2=partner)
# milan["total"], milan["percentage"], milan["isCompatible"], milan["breakdown"]

# KP ruling planets. Horary answers at the moment of the question, for the place looked up above.
kp = roxy.vedic_astrology.get_kp_ruling_planets(latitude=latitude, longitude=longitude, timezone=timezone)
# kp["dayLord"], kp["moonSublord"], kp["rulingPlanets"]

# Transit forecast. Transit-to-natal aspects, sign ingresses and retrograde stations over a window.
# `birth_data` is the same `birth` object: date, time, latitude, longitude, timezone.
transits = roxy.forecast.forecast_transits(birth_data=birth, start_date="2026-10-01", end_date="2026-10-31")
# transits["count"], transits["events"][n]["date"], ["type"], ["body"], ["target"], ["aspect"], ["significance"]

# Cross-domain timeline. The same window with Vedic dasha boundaries and biorhythm critical days merged in.
timeline = roxy.forecast.generate_timeline(birth_data=birth, start_date="2026-10-01", end_date="2026-10-31")
# timeline["events"][n]["domain"] ("western" | "vedic" | "biorhythm"), ["description"], ["significance"]

# Bodygraph. Type, strategy, authority, profile, definition, centers, channels and all 26 gates in one call.
# Human Design needs only the birth instant, so it takes the date, time and timezone from the lookup above.
hd = roxy.human_design.generate_bodygraph(date=birth["date"], time=birth["time"], timezone=birth["timezone"])
# hd["type"], hd["strategy"], hd["authority"], hd["profile"], hd["definition"], hd["incarnationCross"]["name"], hd["centers"], hd["channels"], hd["gates"]

# Connection. Two bodygraphs combined, each of the 36 channels classified by how the pair forms it.
connection = roxy.human_design.calculate_connection(
    person_a={"date": birth["date"], "time": birth["time"], "timezone": birth["timezone"]},
    person_b={"date": partner["date"], "time": partner["time"], "timezone": partner["timezone"]},
)
# connection["totalChannels"], connection["summary"]["electromagnetic"], connection["combinedDefinition"]

# BaZi Four Pillars. The anchor call of the domain, from the same birth instant as every chart above.
# Each response echoes the `conventions` it was computed under, so a chart can be reproduced, not guessed.
bazi = roxy.chinese_astrology.generate_bazi_chart(date=birth["date"], time=birth["time"], timezone=birth["timezone"])
# bazi["pillars"][n]["position"] ("year" | "month" | "day" | "hour"), ["stem"]["element"], ["branch"]["animal"], ["tenGod"]["name"]
# bazi["dayMaster"]["element"], bazi["zodiacAnimal"], bazi["fiveElements"], bazi["conventions"]

# Chinese zodiac animal. Defaults `year_boundary` to the Lunar New Year, the folk rule people mean
# when they ask which animal they are. Pass "li-chun" for the classical BaZi boundary.
animal = roxy.chinese_astrology.calculate_zodiac_animal(date=birth["date"])
# animal["animal"]["name"], animal["animal"]["element"], animal["element"] (the year stem element), animal["interpretation"]

# Almanac day. The Tong Shu view of a date: day officer, mansion, clash animal, favours and avoids.
almanac = roxy.chinese_astrology.get_almanac_day(date="2026-10-01")
# almanac["dayPillar"], almanac["dayOfficer"], almanac["clashAnimal"], almanac["favours"], almanac["avoids"]

# Kua number. One birth date and a gender give the personal directions everything else reads off.
kua = roxy.feng_shui.calculate_kua_number(date=birth["date"], gender="female")
# kua["kua"], kua["group"] ("east" | "west"), kua["trigram"]["english"], kua["sectors"][n]["direction"], ["nature"], ["rank"]

# Flying star natal chart. Period plus facing gives the nine palaces with base, mountain and water stars.
# Send `facing` (a mountain id like "bing" or a compass label like "S2") or `facing_degrees`, not neither.
stars = roxy.feng_shui.generate_flying_star_chart(period=9, facing="S2")
# stars["facing"]["label"], stars["sitting"]["label"], stars["structure"]["name"], stars["palaces"][n]["palace"], ["base"], ["mountain"], ["water"], ["reading"]

# Tzolkin day sign. The most asked Maya question, answered from a date alone.
tzolkin = roxy.mesoamerican_astrology.calculate_tzolkin(date=birth["date"])
# tzolkin["daySign"], tzolkin["daySignName"], tzolkin["number"], tzolkin["trecena"], tzolkin["reading"]

# Full Maya chart. Tzolkin, Haab, Long Count, Calendar Round, Lord of the Night, Year Bearer and the Cruz Maya.
maya = roxy.mesoamerican_astrology.generate_mayan_chart(date=birth["date"])
# maya["tzolkin"], maya["haab"], maya["longCount"], maya["calendarRound"], maya["yearBearer"], maya["cross"], maya["conventions"]["correlation"]

# Entrance analysis. Plot, facing and door in; the pada, its devata, the classical effect and the recommended padas out.
entrance = roxy.vastu.calculate_entrance_pada(
    plot={"width": 30, "depth": 40, "unit": "feet"}, facing="North", door_position=0.4,
)
# entrance["pada"], entrance["devata"], entrance["effect"], entrance["auspiciousness"], entrance["recommendedPadas"], entrance["source"]

# Room compliance. A verdict per room with the verse or the convention it rests on, and a scored composite.
rooms = roxy.vastu.calculate_room_compliance(
    plot={"width": 30, "depth": 40, "unit": "feet"},
    facing="North",
    rooms=[
        {"type": "kitchen", "direction": "Southeast"},
        {"type": "master-bedroom", "direction": "Southwest"},
        {"type": "puja", "direction": "Northeast"},
    ],
)
# rooms["score"], rooms["rooms"][n]["type"], ["verdict"], ["idealDirections"], ["source"]

# Life Path. The most searched numerology number, from the birth date alone.
life_path = roxy.numerology.calculate_life_path(year=1990, month=1, day=15)
# life_path["number"], life_path["type"] ("single" | "master"), life_path["meaning"]

# Full numerology chart. All six core numbers plus karmic lessons, pinnacles and the personal year in one call.
numerology = roxy.numerology.generate_numerology_chart(full_name="Jane Smith", year=1990, month=1, day=15)
# numerology["coreNumbers"]["lifePath"], ["expression"], ["soulUrge"], numerology["additionalInsights"]["personalYear"]

# Personal Year. The annual theme, the January feature of every numerology app.
personal_year = roxy.numerology.calculate_personal_year(month=1, day=15, year=2026)
# personal_year["personalYear"], personal_year["theme"], personal_year["advice"]

# Gematria. A Latin name transliterated under a declared convention, ten ciphers, each with its tradition and source.
gematria = roxy.kabbalah.calculate_gematria(text="Sarah")
# gematria["chosen"]["hebrew"], gematria["values"][n]["id"], ["name"], ["value"], ["tradition"]; gematria["matches"], gematria["conventions"]

# Birth profile. The Hebrew date and birthday, the three birth angels and the birth sephirah from the instant above.
kabbalah = roxy.kabbalah.generate_birth_profile(date=birth["date"], time=birth["time"], timezone=birth["timezone"])
# kabbalah["hebrewDate"], kabbalah["hebrewBirthday"], kabbalah["angels"], kabbalah["sephirah"]

# Daily card. Deterministic per (seed, date), so one user sees one card per day.
card = roxy.tarot.get_daily_card(seed="user-42")
# card["card"]["name"], card["card"]["reversed"], card["card"]["imageUrl"], card["dailyMessage"]

# Three-card spread. Past, present, future: the most drawn spread on every tarot platform.
three = roxy.tarot.cast_three_card(question="My next quarter", seed="user-42")
# three["positions"][n]["name"], ["card"]["name"], ["interpretation"]; three["summary"]

# Celtic Cross. The ten-position professional reading.
celtic = roxy.tarot.cast_celtic_cross(question="What should I focus on?", seed="user-42")
# celtic["positions"][n]["name"], ["card"]["name"], ["interpretation"]; celtic["summary"]

# Yes or no. One card, one answer, with its strength.
answer = roxy.tarot.cast_yes_no(question="Should I take the offer?")
# answer["answer"] ("Yes" | "No" | "Maybe"), answer["strength"], answer["card"]["name"]

# Biorhythm reading. All ten cycles for a date, from the same birth date as every chart above.
bio = roxy.biorhythm.get_reading(birth_date=birth["date"], target_date="2026-10-01")
# bio["cycles"]["physical"]["value"], ["phase"]; bio["energyRating"], bio["overallPhase"], bio["criticalAlerts"], bio["interpretation"]

# Forecast. Every cycle for every day of a window, with the best and worst days named.
bio_forecast = roxy.biorhythm.get_forecast(birth_date=birth["date"], start_date="2026-10-01", end_date="2026-10-31")
# bio_forecast["summary"]["bestDay"], ["worstDay"], ["averageEnergy"]; bio_forecast["days"][n]["date"], ["physical"], ["emotional"], ["intellectual"], ["isCritical"]

# Constitution. The dosha profile read from the sidereal chart of the same birth, each factor with its verse.
constitution = roxy.ayurveda.calculate_ayurvedic_constitution(**birth)
# constitution["composite"], constitution["factors"][n]["id"], ["doshas"], ["source"], constitution["meta"]["disclaimer"]

# Dinacharya. Brahma muhurta, the dosha periods and the routine for a date at the place looked up above.
dinacharya = roxy.ayurveda.get_dinacharya_schedule(date="2026-10-01", latitude=latitude, longitude=longitude, timezone=timezone)
# dinacharya["brahmaMuhurta"], dinacharya["doshaPeriods"], dinacharya["routine"]

# Cast a reading. Three coins six times: the primary hexagram, the changing lines and the resulting hexagram.
reading = roxy.iching.cast_reading(seed="user-42")
# reading["hexagram"]["number"], ["english"], reading["lines"], reading["changingLinePositions"], reading["resultingHexagram"]

# Hexagram catalog. Paginated, 20 per page by default; ask for all 64 once and cache them.
hexagrams = roxy.iching.list_hexagrams(limit=64)
# hexagrams["total"], hexagrams["hexagrams"][n]["number"], ["english"], ["pinyin"]; roxy.iching.get_hexagram(number=n) for the judgment and lines

# By zodiac. The most searched crystal query pattern.
by_sign = roxy.crystals.get_crystals_by_zodiac(sign="scorpio")
# by_sign["crystals"][n]["id"], ["name"], ["imageUrl"], ["colors"]; roxy.crystals.get_crystal(id=id) for full properties

# By chakra. Wellness and yoga content pages.
by_chakra = roxy.crystals.get_crystals_by_chakra(chakra="Heart")
# by_chakra["crystals"][n]["name"], ["colors"]

# Birthstone. Evergreen gift and jewelry pages.
birthstone = roxy.crystals.get_birthstones(month="1")

# Symbol detail. Every "what does it mean to dream about X" page lands here.
symbol = roxy.dreams.get_dream_symbol(id="flying")
# symbol["id"], symbol["name"], symbol["meaning"]

# Symbol search. Chatbots fetch the dictionary once and keep it locally.
symbols = roxy.dreams.search_dream_symbols(q="water")
# symbols["symbols"][n]["id"], ["name"]

# By number. Every "meaning of 1111" page is backed by this. The path param is a string.
angel = roxy.angel_numbers.get_angel_number(number="1111")
# angel["title"], angel["coreMessage"], angel["meaning"]["spiritual"], angel["meaning"]["love"], angel["affirmation"]

# Universal lookup. Any positive integer, with the digit root carrying the answer when no curated entry exists.
sequence = roxy.angel_numbers.analyze_number_sequence(number="4242")
# sequence["digitRoot"], sequence["isRepeating"], sequence["knownMeaning"] (None when not curated), sequence["digitRootMeaning"]["title"]

import asyncio
from roxy_sdk import create_roxy

async def main():
    roxy = create_roxy("your-api-key")
    horoscope = await roxy.astrology.get_daily_horoscope_async(sign="aries")
    card = await roxy.tarot.get_daily_card_async()
    print(horoscope, card)

asyncio.run(main())

card = roxy.tarot.get_daily_card(date="2026-04-22", lang="es")
life_path = roxy.numerology.calculate_life_path(year=1990, month=1, day=15, lang="hi")

from fastapi import FastAPI
from roxy_sdk import create_roxy

app = FastAPI()
roxy = create_roxy("your-api-key")

@app.get("/horoscope/{sign}")
async def horoscope(sign: str):
    return await roxy.astrology.get_daily_horoscope_async(sign=sign)

from flask import Flask, jsonify
from roxy_sdk import create_roxy

app = Flask(__name__)
roxy = create_roxy("your-api-key")

@app.route("/horoscope/<sign>")
def horoscope(sign):
    return jsonify(roxy.astrology.get_daily_horoscope(sign=sign))

from django.http import JsonResponse
from roxy_sdk import create_roxy

roxy = create_roxy("your-api-key")

def horoscope(request, sign):
    return JsonResponse(roxy.astrology.get_daily_horoscope(sign=sign))

from roxy_sdk import create_roxy, RoxyAPIError

roxy = create_roxy("your-api-key")

try:
    result = roxy.astrology.get_daily_horoscope(sign="invalid")
except RoxyAPIError as e:
    print(f"Code: {e.code}")
    print(f"Error: {e.error}")
    print(f"Status: {e.status_code}")

import os
from roxy_sdk import create_roxy

roxy = create_roxy(os.environ["ROXY_API_KEY"])

roxy = create_roxy(
    api_key="your-api-key",
    base_url="https://roxyapi.com/api/v2",  # default
    timeout=30.0,                            # request timeout in seconds
)

with create_roxy("your-api-key") as roxy:
    horoscope = roxy.astrology.get_daily_horoscope(sign="aries")
# connections closed automatically