RoxyAPI: Astrology, Vedic, Forecast, Human Design, Numerology

RoxyAPI adds Astrology, Vedic, Forecast, Human Design, Chinese Astrology and Feng Shui readings to any WordPress post, page or widget, as Gutenberg blocks and shortcodes. Drop one on a 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. 18+ domains. 258+ endpoints. Most astrology plugins cover one system. RoxyAPI covers the whole stack, so you build the entire experience without stitching services together:

• Western astrology: natal and birth charts, daily, weekly, monthly, and yearly horoscopes, synastry with a house overlay, compatibility, transits, and moon phases
• Vedic astrology: kundli, KP charts, panchang, Vimshottari dasha, divisional charts, nakshatras, yogas, gochara transits, and the Bhava Bala and Bhav Chalit house readings
• Forecast: cross-domain timelines, transit forecasts, solar returns, and significant dates
• Human Design: full bodygraph with type, authority, profile, centers, channels, gates, variables, and penta
• Chinese astrology: the BaZi Four Pillars chart, Day Master strength, ten year luck pillars, the Chinese zodiac sign with daily readings and compatibility, the 24 solar terms, and the Chinese almanac day (Tong Shu)
• Feng shui: the Kua number with Eight Mansions directions, the nine palace Flying Star chart, bagua sectors, and annual afflictions
• Mesoamerican astrology: the Tzolkin day sign, the Mayan chart with Haab and Long Count, a Long Count converter, daily and monthly readings, nawal compatibility, and the Aztec tonalpohualli
• Vastu: entrance pada, the Vastu Purusha Mandala, plot analysis, Ayadi, room compliance, and griha pravesh dates
• Numerology: Life Path, Expression, Soul Urge, and Personality numbers
• Kabbalah: gematria with every spelling shown, name and birth profiles, the 72 names, the Tree of Life, and the Hebrew letters
• Tarot: single card, three card, Celtic Cross, and custom spreads
• Plus: biorhythm, Ayurveda, I Ching, crystals, dream interpretation, and angel numbers

Every chart is calculated by Roxy Ephemeris and verified against NASA JPL Horizons, with readings in your site language. One key, one plan, no per-domain fees.

Frequently asked, answered up front

• Do I need an account to try it? No. Blocks and shortcodes render readings straight after activation on a free daily allowance.
• Do I need to know astrology to use it? No. Every reading arrives calculated and formatted, so you place a block and pick your options.
• Is the birth chart accurate? Charts come from Roxy Ephemeris and are verified against NASA JPL Horizons.
• Can visitors enter their own birth details? Yes. Leave the attributes off a reading that takes details and it renders a form; the submission is processed server side.
• Do I have to write shortcodes? No. RoxyAPI, Create a reading asks a few questions and writes the shortcode for you to paste.
• Does it work with my theme? Yes. Charts are SVG and follow your light or dark theme through CSS custom properties.
• Where does my API key live? On your server only. It is never sent to the browser.

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 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 18+ 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 English, German, Hindi, Spanish, Turkish, Portuguese, French, and Russian, following the site language or one setting
• Parent Astrology Section wrapper block that sets the zodiac sign for the Horoscope blocks placed inside it
• 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, and what you put inside the brackets decides what your visitors see.

Ask your visitor. Leave the details out and the reading shows a form. Visitors enter their own birth date, sign, name or year, and their reading appears on the same page.

[roxy_natal_chart] asks for a birth date, time and city
[roxy_calculate_luck_pillars] asks for a birth date, time, timezone and gender
[roxy_get_annual_flying_stars] asks for a year

Show a set reading. Put every detail in the shortcode and every visitor sees the same reading, with no form.

[roxy_calculate_luck_pillars date="1990-06-15" time="14:30" timezone="Asia/Shanghai" gender="male"]
[roxy_get_annual_flying_stars year="2026"]

Add mode="form" to keep the form even when details are set, or mode="static" so a placement never shows a form.

Readings that need nothing. Some readings take no details and show straight away, such as [roxy_moon_phase], [roxy_get_daily_hexagram] and [roxy_cast_celtic_cross].

Every shortcode, with the details it takes and a sample to copy, is listed in your dashboard under RoxyAPI, Shortcodes. Rather not type one? Open RoxyAPI, Create a reading, answer a few questions and copy the finished shortcode, or try the same builder online first: https://roxyapi.github.io/sdk-wordpress/

Hero shortcodes

[roxy_horoscope sign="aries"]
[roxy_horoscope sign="aries" period="yearly"]
[roxy_horoscope sign="aries" period="monthly" date="2026-10-01"]
[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_bodygraph birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York"]
[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"]

Four heroes take no attributes: the three two-person compatibility readings render a visitor form for both people, and the forecast timeline renders a visitor form for the birth details and an optional date window:

[roxy_synastry]
[roxy_gun_milan]
[roxy_compatibility]
[roxy_forecast]

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"], [roxy_get_weekly_horoscope sign="aries"] and [roxy_get_yearly_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"]
• Forecast: [roxy_generate_digest] (renders a visitor form, no attributes)
• 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
• Chinese astrology: [roxy_generate_bazi_chart date="1990-06-15" time="14:30:00" timezone="Asia/Shanghai"], [roxy_get_zodiac_animal id="dragon"] and [roxy_get_almanac_day date="2026-02-17"]
• Feng shui: [roxy_calculate_kua_number date="1985-07-15" gender="male"] and [roxy_get_annual_flying_stars year="2026"]
• Numerology: [roxy_calculate_expression full_name="Ada Lovelace"]
• Tarot: [roxy_cast_celtic_cross question="What should I know about this path"]
• 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"]

Readings follow your WordPress site language automatically. To pick a language yourself, open the RoxyAPI menu, Branding tab, and set the reading language. Some of the long tail shortcodes above also take a lang attribute, for example [roxy_get_crystal id="amethyst" lang="es"], but the headline readings take the site or Branding setting instead.

Want the chart on its own, without the written report? Open the RoxyAPI menu, Display tab, and turn on Written readings. Every reading on the site then shows its chart, tables, and values with the written text left out. To set it for one placement instead of the whole site, add hide_readings="1" to that shortcode, for example [roxy_natal_chart birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York" hide_readings="1"]. Passing hide_readings="0" keeps the written text on that placement even when the site setting is on.