XeroWP
RoxyAPI: Astrology, Vedic, Tarot, Numerology
RoxyAPI: Astrology, Vedic, Tarot, Numerology

RoxyAPI: Astrology, Vedic, Tarot, Numerology

0/5 (0 ratings) — active installs Updated Jun 23, 2026
astrologyhoroscopenumerologytarotvedic
Download v1.5.1 Plugin Website
Western natal chart wheel with planets, houses, aspect lines, and the chart angles. Rendered server-side, so your API key never reaches the browser.

Western natal chart wheel with planets, houses, aspect lines, and the chart angles. Rendered server-side, so your API key never reaches the browser.

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

Features:

  • Western birth charts, synastry, and compatibility scoring, plus transits and moon phases
  • Daily, weekly, and monthly horoscope blocks and shortcodes for all 12 zodiac signs
  • Vedic astrology: kundli, KP charts, panchang, Vimshottari dasha, divisional charts, nakshatras, and yoga detection
  • Human design: full bodygraph with type, authority, profile, centers, channels, and gates
  • Forecasts: cross-domain timelines, transit forecasts, solar returns, and significant dates
  • 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
  • Dream symbol dictionary with 2,000+ entries, plus angel number meanings and crystal reference data
  • Biorhythm cycles: physical, emotional, intellectual, and intuitive
  • Interactive SVG charts and cards that follow your light or dark theme automatically
  • Readings in 8 languages (English, German, Hindi, Spanish, Turkish, Portuguese, French, Russian) via one setting
  • 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.

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 small free daily allowance lets the plugin display readings without an account; a RoxyAPI API key is required for production use and removes the daily limit. 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.

Shortcode examples

Every reading is a shortcode. Pass attributes for a fixed reading the site owner controls, or drop the shortcode with no attributes to render an accessible visitor form. Heroes that take two charts or nested birth details are form mode only.

Hero shortcodes

[roxy_horoscope sign="aries"]
[roxy_natal_chart birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York"]
[roxy_kundli birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_panchang date="2026-04-28" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_mangal_dosha birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_kp_chart birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]
[roxy_moon_phase]
[roxy_tarot_card spread="three" question="What should I focus on this week"]
[roxy_tarot_yes_no question="Should I take the new job"]
[roxy_numerology name="Ada Lovelace" birth_date="1815-12-10"]
[roxy_life_path birth_date="1990-05-15"]
[roxy_biorhythm birth_date="1990-05-15" target_date="today"]
[roxy_angel_number number="1111"]
[roxy_crystals_by_zodiac sign="aries"]

The three two chart compatibility heroes render a visitor form for both people and take no attributes:

[roxy_synastry]
[roxy_gun_milan]
[roxy_compatibility]

Leave the attributes off any hero shortcode to render a form instead. For example [roxy_horoscope] shows a zodiac sign picker and [roxy_natal_chart] shows a birth date, time, and city picker.

Long-tail shortcodes

A matching shortcode exists for every endpoint in the spec. A sample across the domains:

  • Western astrology: [roxy_calculate_aspects date="1990-07-15" time="14:30:00" timezone="UTC"] and [roxy_get_weekly_horoscope sign="aries"]
  • Vedic astrology: [roxy_get_hora date="2026-02-03" latitude="17.385044" longitude="78.486671" timezone="UTC"] and [roxy_calculate_drishti date="2026-02-03" time="12:00:00" latitude="17.385044" longitude="78.486671" timezone="UTC"]
  • Tarot: [roxy_cast_celtic_cross question="What should I know about this path"]
  • Numerology: [roxy_calculate_expression full_name="Ada Lovelace"]
  • Human design: [roxy_generate_bodygraph date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"], [roxy_calculate_variables date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"], plus the two chart [roxy_calculate_connection] and [roxy_calculate_penta] which render visitor forms and take no attributes
  • Forecast: [roxy_generate_digest] (renders a visitor form, no attributes)
  • I Ching: [roxy_get_daily_hexagram]
  • Crystals: [roxy_get_crystal id="amethyst"]
  • Dreams: [roxy_search_dream_symbols q="water"]
  • Location: [roxy_search_cities q="berlin"]

Add lang to any shortcode to override the response language, for example [roxy_get_crystal id="amethyst" lang="es"].

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 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.