RoxyAPI
Quick StartAGENTS.mdSDKMCP SetupFree StartersAPI Playground
  1. Docs
  3. Agent Reference
  5. Agent Task Cheatsheet

Agent Task Cheatsheet

One-line semantics for the most-reached-for endpoints, grouped by API domain. Read this first when an agent needs a starting point. Full request and response schemas live in each per-product OpenAPI spec at /api/v2/{slug}/openapi.json.

Astrology

  • POST /astrology/natal-chart — Western birth chart with planets, houses, aspects, ascendant, midheaven.
  • GET /astrology/horoscope/{sign}/daily — Daily horoscope. Also /weekly and /monthly variants.
  • POST /astrology/synastry — Inter-chart aspect analysis between two people.
  • POST /astrology/compatibility-score — Percent plus category breakdowns and archetype.
  • POST /astrology/transits — Current sky. Pass optional natalChart for personalized aspects.
  • GET /astrology/moon-phase/current — Current moon phase, illumination, sign.

TypeScript SDK example

roxy.astrology.generateNatalChart({ body: { date: '1990-06-15', time: '14:30:00', latitude: 40.7128, longitude: -74.006, timezone: -5 } })

Python SDK example

roxy.astrology.generate_natal_chart(date="1990-06-15", time="14:30:00", latitude=40.7128, longitude=-74.006, timezone=-5)

Vedic

  • POST /vedic-astrology/birth-chart — Kundli with twelve rashi houses, planet placements, interpretations.
  • POST /vedic-astrology/panchang/detailed — Daily panchang with rahu kaal, muhurtas, gulika, chandrabalam, tarabalam.
  • POST /vedic-astrology/panchang/basic — Tithi, nakshatra, yoga, karana.
  • POST /vedic-astrology/panchang/choghadiya — Eight day and eight night electional periods.
  • POST /vedic-astrology/dasha/current — Current Mahadasha, Antardasha, Pratyantardasha.
  • POST /vedic-astrology/dasha/major — Full 120-year Vimshottari timeline.
  • POST /vedic-astrology/dosha/manglik — Mangal Dosha check.
  • POST /vedic-astrology/dosha/kalsarpa — Kaal Sarp Dosha check.
  • POST /vedic-astrology/dosha/sadhesati — Sade Sati (Saturn transit) check.
  • POST /vedic-astrology/compatibility — Guna Milan (36-point Ashtakoota matching).
  • POST /vedic-astrology/navamsa — D9 chart.
  • POST /vedic-astrology/kp/chart — KP chart with cusps, planets, sub-lords.
  • POST /vedic-astrology/kp/planets — KP planets with sub-lord and sub-sub-lord.
  • POST /vedic-astrology/kp/ruling-planets — KP ruling planets for horary.
  • GET /vedic-astrology/nakshatras/{id} — Single nakshatra detail (e.g. ashwini, pushya).

TypeScript SDK example

roxy.vedicAstrology.computeBirthChart({ body: { date: '1990-06-15', time: '14:30:00', latitude: 28.6139, longitude: 77.2090, timezone: 'Asia/Kolkata' } })

Python SDK example

roxy.vedic_astrology.compute_birth_chart(date="1990-06-15", time="14:30:00", latitude=28.6139, longitude=77.209, timezone="Asia/Kolkata")

Numerology

  • POST /numerology/life-path — Pythagorean life path with master-number (11, 22, 33) and karmic-debt detection.
  • POST /numerology/chart — Full profile: life path, expression, soul urge, personality, birth day, maturity.
  • POST /numerology/compatibility — Couple matching by life-path / expression / soul urge. No birth time needed.
  • POST /numerology/personal-year — Annual forecast from birthdate plus target year.
  • POST /numerology/expression — Name-based destiny number.

TypeScript SDK example

roxy.numerology.computeLifePath({ body: { year: 1990, month: 6, day: 15 } })

Python SDK example

roxy.numerology.compute_life_path(year=1990, month=6, day=15)

Tarot

  • POST /tarot/daily — Seeded daily card.
  • POST /tarot/draw — Custom draw of N cards (1-78).
  • POST /tarot/spreads/three-card — Past / present / future.
  • POST /tarot/spreads/celtic-cross — Ten-position spread.
  • POST /tarot/yes-no — One-question, one-card reading.
  • POST /tarot/spreads/love — Five-position relationship spread.
  • GET /tarot/cards — 78-card catalog.
  • GET /tarot/cards/{id} — Card detail with upright, reversed, and life-area meanings.

TypeScript SDK example

roxy.tarot.drawCards({ body: { count: 3 } })

Python SDK example

roxy.tarot.draw_cards(count=3)

Biorhythm

  • POST /biorhythm/daily — Seeded daily biorhythm reading.
  • POST /biorhythm/forecast — Multi-day range (30 to 90 days) with best, worst, and critical days.
  • POST /biorhythm/compatibility — Cycle alignment between two people.
  • POST /biorhythm/critical-days — Zero-crossing days in a 90 to 180 day window.

TypeScript SDK example

roxy.biorhythm.dailyReading({ body: { birthDate: '1990-06-15' } })

Python SDK example

roxy.biorhythm.daily_reading(birth_date="1990-06-15")

I-Ching

  • POST /iching/daily — Seeded daily hexagram.
  • POST /iching/daily/cast — Seeded three-coin daily variant.
  • GET /iching/cast — Random three-coin cast (optional seed for determinism).
  • GET /iching/hexagrams/{number} — Hexagram 1 to 64 detail.

TypeScript SDK example

roxy.iching.castReading({})

Python SDK example

roxy.iching.cast_reading()

Crystals

  • GET /crystals/zodiac/{sign} — Crystals paired with a zodiac sign.
  • GET /crystals/chakra/{chakra} — Chakra stones (root, heart, third-eye, etc.).
  • GET /crystals/birthstone/{month} — Birthstones by month (1 to 12).
  • GET /crystals/search?q= — Free-text crystal search.

TypeScript SDK example

roxy.crystals.byZodiac({ path: { sign: 'aries' } })

Python SDK example

roxy.crystals.by_zodiac(sign="aries")

Dreams

  • GET /dreams/symbols/{id} — Dream symbol detail (e.g. flying, teeth-falling-out).
  • GET /dreams/symbols — Browse catalog.
  • POST /dreams/daily — Daily dream symbol prompt.

TypeScript SDK example

roxy.dreams.lookupSymbol({ path: { id: 'flying' } })

Python SDK example

roxy.dreams.lookup_symbol(id="flying")

Angel Numbers

  • GET /angel-numbers/numbers/{number} — Canonical number meaning (string param, e.g. 1111, 777).
  • GET /angel-numbers/lookup?number= — Universal lookup for any positive integer with digit-root fallback.
  • POST /angel-numbers/daily — Daily-message endpoint.

TypeScript SDK example

roxy.angelNumbers.lookup({ query: { number: 1111 } })

Python SDK example

roxy.angel_numbers.lookup(number=1111)

Location

  • GET /location/search?q={city} — City search. Paginated envelope: { total, limit, offset, cities: [...] }. Each city has city, province, country, iso2, latitude, longitude, timezone (IANA string, e.g. "Asia/Kolkata"), utcOffset (decimal hours, DST-adjusted for today), population. Chart endpoints accept timezone as either the IANA string or utcOffset decimal — both work, IANA is preferred because it resolves to the DST-correct offset for the request's date. Call first for any coordinate-dependent endpoint.

TypeScript SDK example

roxy.location.search({ query: { q: 'Mumbai' } })

Python SDK example

roxy.location.search(q="Mumbai")