RoxyAPI/sdk-typescript

TypeScript SDK for astrology, Vedic astrology, numerology, tarot, and more.
One API key. Fully typed. Verified against NASA JPL Horizons.
The fastest way to add natal charts, daily horoscopes, synastry, Vedic kundli, tarot spreads, numerology, human design bodygraphs, and transit forecasts to Node.js apps, backends, and AI agents. 18+ domains behind a single Roxy subscription, interpretations in 10+ languages.
Install
Start with one call
Get real product value with a single typed call. No setup beyond your API key.
Then expand into charts, compatibility, numerology, tarot, and more.
Quick start
createRoxy sets the base URL (https://roxyapi.com/api/v2) and injects the auth header and SDK identification header on every request. Every method returns { data, error, response }; check error first, or pass throwOnError: true in the call options to have failures throw and data typed as always present (see Error handling).
Domains
| Namespace | What it covers |
|-----------|----------------|
| roxy.astrology | Western astrology API for natal birth charts, daily, weekly, monthly, and yearly horoscopes with unique content per s... |
| roxy.vedicAstrology | Vedic astrology (Jyotish) and KP API for kundli generation with the sixteen Shodasavarga divisional charts (D1 to D60... |
| roxy.forecast | Astrology forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons,... |
| roxy.humanDesign | Human Design API that generates the full bodygraph from a birth moment: type, strategy, inner authority, profile, def... |
| roxy.chineseAstrology | Chinese zodiac and BaZi astrology API: Four Pillars charts, Chinese zodiac signs and the Chinese lunisolar calendar f... |
| roxy.fengShui | Compute classical feng shui from one API: Xuan Kong flying star natal charts for any of the nine periods and 24 mount... |
| roxy.mesoamericanAstrology | Calculate Mayan astrology day signs, the Tzolkin sacred round, the Haab year, the full Long Count and the Aztec tonal... |
| roxy.vastu | Vastu Shastra API for directional home and plot analysis: entrance padas with the classical effect of each of the 32... |
| roxy.numerology | Numerology API for life path numbers, complete numerology charts and compatibility, in both Pythagorean and Chaldean... |
| roxy.kabbalah | Kabbalah API for gematria, the 72 names, the Tree of Life and the Hebrew birthday |
| roxy.tarot | Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and sp... |
| roxy.biorhythm | Biorhythm API for entertainment and reflection, with 10 model cycle types across 3 primary (physical, emotional, inte... |
| roxy.ayurveda | Ayurveda API for dosha profiles, the dinacharya daily routine and the ritucharya seasonal regimen, with a verse cited... |
| roxy.iching | I-Ching oracle API with all 64 hexagrams, 384 changing lines, 8 trigrams, and modern interpretations for love, career... |
| roxy.crystals | Crystal healing API covering the most popular and widely-searched healing crystals and gemstones, from Amethyst and R... |
| roxy.dreams | Dream interpretation API with a 2,200+ symbol dream dictionary and psychological meanings covering animals, objects,... |
| roxy.angelNumbers | Angel numbers API with meanings for 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, and 75+ sequences covering eve... |
| roxy.location | Timezone and location API with city search and geocoding across 235,000+ cities in 240+ countries, returning latitude... |
| roxy.usage | Monitor your API usage, check rate limits, and track request consumption |
| roxy.languages | List the response languages accepted by the lang query parameter on every i18n-aware endpoint |
Most-used endpoints
The highest-demand endpoints by domain, in the order you are most likely to ship them. Every example below reads the same birth through a different domain, and every coordinate comes from one location lookup at the top: one API key, one lookup, and eighteen domains that compose into a single product instead of eighteen separate ones. Full catalog in the API reference.