RoxyAPI — Astrology, Vedic, Tarot, Numerology

Add astrology, daily horoscopes, tarot card pulls, numerology readings, and Vedic birth charts to any WordPress site. One plugin covers ten spiritual data domains: Western and Vedic astrology, daily / weekly / monthly horoscopes, tarot, numerology, I Ching, dream interpretation, biorhythm, angel numbers, and crystals. Astronomy is cross-checked against the NASA JPL Horizons ephemeris. One API key unlocks 130+ endpoints.

About the service this plugin connects to

This plugin is a thin WordPress interface to RoxyAPI, a third-party paid service operated at https://roxyapi.com. The astrology, tarot, numerology, and other calculations all run on RoxyAPI servers. A RoxyAPI account and API key are required for the plugin to display any data. Pricing and plan tiers are listed at https://roxyapi.com/pricing in your local currency. Terms of Service: https://roxyapi.com/policy/terms. Privacy Policy: https://roxyapi.com/policy/privacy.

The plugin itself is GPLv2 or later and the source is available at https://github.com/RoxyAPI/sdk-wordpress.

Features:

• Daily, weekly, and monthly horoscope blocks and shortcodes for all 12 zodiac signs
• Single card and three card tarot pulls, plus Celtic Cross and custom spreads
• Pythagorean numerology with Life Path, Expression, Soul Urge, and Personality numbers
• I Ching hexagram casting with full interpretation
• Natal chart calculation with houses, aspects, and planet positions
• Dream symbol dictionary with 2,000+ entries
• Biorhythm, angel number, and crystal reference data
• Parent Astrology Section wrapper block that shares the zodiac sign across all child blocks via block context
• Server side caching with per endpoint TTL to keep your API quota low
• API key stays server side. Never exposed to the browser.

Known Limitations

Version 1.0.0 ships all 131 RoxyAPI endpoints. 17 hero shortcodes covering the highest demand readings across Western astrology, Vedic astrology (kundli, panchang, mangal dosha, KP chart), tarot (daily, three card, Celtic Cross, yes or no), numerology (life path, full chart), biorhythm, angel numbers, crystals by zodiac, current moon phase, plus two-chart compatibility (synastry, gun milan, Western compatibility). 117 auto generated shortcodes for the long tail.

I Ching, dream symbol, and single crystal lookups are reachable via the auto-generated long-tail shortcodes (browse the full catalog at RoxyAPI then Shortcodes in the WordPress admin sidebar).

Hero block editor sidebars are intentionally minimal in this release. Live previews and richer inspector controls land in a future release.

Privacy

This plugin connects to a third-party paid service (RoxyAPI).

• Service: RoxyAPI (https://roxyapi.com)
• Service operator: RoxyAPI
• Terms of Service: https://roxyapi.com/policy/terms
• Privacy Policy: https://roxyapi.com/policy/privacy
• Pricing: https://roxyapi.com/pricing

When does the plugin contact RoxyAPI? Only after you save an API key on the settings page and either click Test Connection or render a RoxyAPI block or shortcode on a page. Saving your API key is the explicit consent for these calls. The plugin does NOT contact RoxyAPI on activation, on update, in the background, or on admin pages that do not display a reading.

What data is sent? The reading parameters you supply via the block or shortcode (zodiac sign, birth date, name, location coordinates, question text), your site URL (in an X-Site-URL header), and a plugin identifier (in an X-SDK-Client header). Your server’s outbound IP is incidentally captured by RoxyAPI, like any HTTP request. No site visitor data is collected by the plugin itself.

Where is the API key stored? Either as the ROXYAPI_KEY constant in your wp-config.php (recommended) or AES-256-CTR encrypted in the wp_options table under roxyapi_settings. The plain key is never sent to the browser at any time.

What does RoxyAPI do with the data? See https://roxyapi.com/policy/privacy.