RoxyAPI: Astrology, Vedic, Tarot, Numerology
Launch a complete astrology, horoscope, or tarot experience on WordPress this weekend, not this quarter. Drop a block or shortcode on any page and it renders a real reading, server-side, the moment you activate the plugin. No account, no setup, no calculation code to write. Start free, then add an API key when you go live.
One API key. 12+ domains. 160+ endpoints. Most astrology plugins do one thing. RoxyAPI covers the whole stack, so you build the entire experience without stitching services together:
- Western astrology: natal and birth charts, daily, weekly, and monthly horoscopes, synastry, compatibility, transits, and moon phases
- Vedic astrology: kundli, KP charts, panchang, Vimshottari dasha, divisional charts, nakshatras, and yogas
- Numerology: Life Path, Expression, Soul Urge, and Personality numbers
- Tarot: single card, three card, Celtic Cross, and custom spreads
- Human design: full bodygraph with type, authority, profile, centers, channels, and gates
- Forecasts: cross-domain timelines, transit forecasts, solar returns, and significant dates
- Plus: biorhythm, I Ching, crystals, dream interpretation, and angel numbers
Every chart is calculated by Roxy Ephemeris and verified against NASA JPL Horizons, with readings in 8 languages. One key, one plan, no per-domain fees.
Free to start. Add a key when you go live.
Every reading works the moment you activate the plugin, with no account. A free daily allowance, shared across your site, covers casual traffic so you can build and preview complete pages at no cost. When you are ready for production, add a RoxyAPI API key and the daily limit is removed. There is no separate paid plugin and no locked reading types: the same blocks and shortcodes cover every domain whether or not a key is set. A key simply lifts the daily cap, covers production traffic, and keeps all 12+ domains live under one key. Pick a plan at https://roxyapi.com/pricing.
Also built in:
- Gutenberg blocks and shortcodes for every reading, plus a visitor form mode for interactive inputs like birth details
- Pythagorean numerology, full 78 card tarot, and a 2,000+ entry dream symbol dictionary
- 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. 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.