Description

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 8 languages. 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 hero shortcode and it renders a form; the submission is processed server side.
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, 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 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 8 languages (English, German, Hindi, Spanish, Turkish, Portuguese, French, Russian) via 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. 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_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_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"], [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.

Screenshots

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

The Shortcodes Library. Every reading across every domain in one searchable, copy-paste 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.

Blocks

This plugin provides 231 blocks.

Planetary Return Chart (Western Astrology) Saturn return, Jupiter return, and inner planet cycles
Birth Day Number (Numerology) Special talents from day of birth
Griha Pravesh Dates (Vastu) Vastu house warming muhurta
Chara Karakas (Vedic Astrology) Calculate the Chara Karakas of Jaimini astrology from birth details: the movable significators assigned by ranking each graha on how far it has advanced into its sign
Defined Human Design Channels Calculate the defined channels for a birth moment
Shadbala (Vedic Astrology) Calculate complete Shadbala (six-fold planetary strength) per Brihat Parashara Hora Shastra (BPHS) and BV Raman Graha and Bhava Balas
Search Crystals Search for healing crystals by keyword or name
Name Profile (Kabbalah) Kabbalah name numerology with the spelling shown
Angel Number Meaning and pattern analysis for any number sequence.
Hebrew Letter (Kabbalah) Return one Hebrew letter in full: its glyph and final form, its value under the standard and the finals reading, its Sefer Yetzirah class and what that class means, the element or planet or sign it carries under the requested reading, the tarot trump on its path, and the path number
Auspicious Days (Chinese Astrology) Chinese date selection for weddings and openings
Day Master Strength (Chinese Astrology) Assess how well the Day Master is supported by the rest of a BaZi chart, and which of the five elements help it
Direction (Vastu) Look up one Vastu direction: its dikpala, the mandala squares it covers with their devatas, what the chapter places there, and what standing water in that quarter brings
Dosha (Ayurveda) Vata pitta kapha profile
Planetary Aspects (Western Astrology) Aspect finder for any date and time
Gematria Ciphers (Kabbalah) gematria methods with provenance on every row
BaZi Annual Forecast (Chinese Astrology) Read one Gregorian year against a natal BaZi chart
Directions (Vastu) Vastu dikpala and direction
Mayan Day Signs (Mesoamerican Astrology) Retrieve all twenty Tzolkin day signs in sequence order from Imix to Ajaw
Asteroid Goddesses (Western Astrology) Ceres, Pallas, Juno, and Vesta natal positions
Solar Terms (Chinese Astrology) Jie Qi calendar with exact instants
Aztec Trecenas (Mesoamerican Astrology) Tonalpohualli thirteen day period
Flying Stars (Feng Shui) The reference catalogue of the nine flying stars: name, Chinese characters, five phase, home palace and trigram, the period each rules, what each means, and which element strengthens or drains it
Monthly Horoscope by Zodiac Sign (Western Astrology) Editorial column with key dates
Relocation Chart (Western Astrology) Relocated birth chart calculator with shifted houses and angles
Karmic Debt Numbers (Numerology) Past life challenges (13, 14, 16, 19)
Maturity Number (Numerology) Who you become in later life
Dual Numerology Pythagorean and Chaldean name numbers in one call
Draw Tarot Cards Draw 1-78 tarot cards from the complete Rider-Waite-Smith deck with seeded reproducibility for consistent personalized readings
Avastha States (Vedic Astrology) Planetary State Reference
Critical Days (Biorhythm) Zero crossing detection for any date range
Trigrams (I Ching) Retrieve all 8 I-Ching trigrams (bagua), the fundamental building blocks of hexagrams
Devata (Vastu) Look up one devata of the Vastu Purusha Mandala: the squares it holds, its ring and side, its pada count, the entrance pada it governs where it sits on the perimeter, and the verses that place it
House Cusps (Western Astrology) House system calculator with comparison
Ayadi Shadvarga (Vastu) Vastu proportion and yoni
Usage Statistics Returns the live quota position for the key on the request: plan name, billable requests used in the current UTC calendar month, the monthly allowance, and how many requests remain
Hora (Vedic Astrology) 24 Planetary Hours (12 day + 12 night)
KP Planets at Time Intervals (Vedic Astrology) Calculate positions of all 9 planets (Sun through Saturn, Rahu, Ketu) at regular time intervals with full KP hierarchy: sign lord, star lord, sublord, and sub-sublord
Soul Urge Number (Numerology) Inner motivations and desires
Symbol Counts by Letter (Dream Interpretation) Get the count of dream symbols available for each letter A-Z
Antardashas (Vedic Astrology) Returns the 9 Antardasha sub periods inside a chosen Mahadasha, each proportional to the Vimshottari years of its lord
Bagua Sectors (Feng Shui) The nine palaces of the compass Bagua map: the eight trigram sectors plus the centre, each with the life area it governs, its five phase, its colours, and both its Later Heaven and Earlier Heaven trigrams
Kua Number (Feng Shui) Look up the reference chart for one Kua number: its trigram, its east or west life group, and how it classifies all eight compass sectors
Doshas (Ayurveda) Return vata, pitta and kapha with the qualities, seats and five sub-doshas each carries, and the three states the seasonal cycle moves them through
Lunar Calendar (Western Astrology) Moon phases for entire month
Personal Month (Numerology) Monthly numerology forecast
Personal Year (Numerology) Annual cycle and forecast for current year
KP Ruling Planets with Optional Significators (Vedic Astrology) Calculate the 5 ruling planets at any moment using Krishnamurti Paddhati horary astrology
Arabic Lots (Western Astrology) seven Hermetic parts including Part of Fortune and Spirit
KP Placidus House Cusps (Vedic Astrology) Calculate unequal Placidus house cusps with ruling sign-lord, nakshatra-lord, and sub-lord for each cusp
Sookshma Dashas (Vedic Astrology) Returns the 9 Sookshma periods inside a chosen Pratyantardasha, the fourth and finest level of the Vimshottari dasha hierarchy
Ashtakavarga (Vedic Astrology) Calculate complete Ashtakavarga analysis per Brihat Parashara Hora Shastra (BPHS)
Sephirah of the Day (Kabbalah) Omer count with the sephirot pairing
Human Design Gate Activations Calculate the 26 gate activations for a birth moment, split into the 13 conscious Personality activations at birth and the 13 unconscious Design activations 88 degrees of solar arc earlier
Monthly Planetary Aspects (Vedic Astrology) Major and minor aspect events for a month
Monthly Declination Parallels (Vedic Astrology) Parallel and contraparallel events for a month
Of the 72 Names (Kabbalah) 72 names of God by index
Daily Ayurveda Reading Dosha clock and brahma muhurta by location
Names (Kabbalah) Shem HaMephorash derived from the verses
Yoga Details by ID (Vedic Astrology) Vedic Yoga Glossary Entry
Search Cities Worldwide (Location) Geocoding autocomplete with coordinates and timezone
Sadhesati (Vedic Astrology) Sade Sati (Saturn Transit)
Calculate Kua Number (Feng Shui) Feng shui personal direction
Birthstones by Month (Crystals) Get the traditional birthstone crystals for a given birth month
Horoscope Daily, weekly, monthly, or yearly horoscope for any zodiac sign.
Transit Analysis (Vedic Astrology) Compare current planets to natal chart (Gochar)
Twenty Qualities (Ayurveda) Return the twenty gunas, the qualities of Ayurveda, as the ten opposed pairs the commentaries spell out, each member with the single action word attached to it, and the half-verse that states the like-increases-like rule the whole domain runs on
Chinese Zodiac Animal (Chinese Astrology) Full sign profile with compatibility partners
Hexagram by Line Pattern (I Ching) Find an I-Ching hexagram by its binary line pattern
Daily Dream Symbol Receive a single dream symbol for daily reflection and subconscious exploration
Human Design Centers Calculate the state of all nine Human Design centers for a birth moment: whether each is defined or open, whether it is a motor or an awareness center, its theme, and the active gates it holds
Monthly Tzolkin Calendar Grid (Mesoamerican Astrology) Mayan calendar grid for a whole civil month: every day of the month with its Tzolkin day sign and coefficient, its trecena, its Haab date and its Long Count
Convert a Maya Long Count (Mesoamerican Astrology) Long Count calendar converter
Business Name Numerology Chaldean brand name analysis and lucky numbers
Human Design Variables The four arrows and Color, Tone, Base substructure
Cast Daily Reading (I Ching) Cast a complete daily I-Ching reading using the traditional three-coin method with seeded randomness
Tarot Card by ID Retrieve comprehensive details for a specific tarot card from the traditional Rider-Waite-Smith deck including complete upright meanings (card drawn normally) and reversed meanings (inverted/upside down interpretations for nuanced guidance)
KP-Newcomb Ayanamsa (Vedic Astrology) Dynamic daily calculation
Devatas (Vastu) Reference table of the 45 devatas of the Vastu Purusha Mandala: which squares of the 81 pada grid each one holds, which ring and which side, how many padas, and the verses that place it
Monthly Ephemeris (Western Astrology) Daily tropical planetary positions for a month
Divisional Chart (Varga) Calculate any Vedic divisional chart (Varga) from D2 Hora to D60 Shashtiamsa
Tarot Cards Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower) plus 56 Minor Arcana (4 suits × 14 cards each for daily situations and practical matters)
Expression Number (Numerology) Natural talents and life goals
Celtic Cross Spread, 10 Cards (Tarot) Perform the legendary Celtic Cross spread, the most comprehensive and detailed tarot reading available, used by professional tarot readers worldwide for over a century
Chaldean Numerology Name Reading Destiny, compound number, planetary ruler
Daily Numerology Number Number of the Day with interpretation
Birth Profile (Kabbalah) Hebrew birthday and birth angel
Dinacharya Daily Routine (Ayurveda) Brahma muhurta and dosha clock
Phase Info (Biorhythm) Lightweight cycle status for dashboards and widgets
Monthly Aspects (Western Astrology) Tropical aspect calendar for an entire month
Local Space Astrology Map (Western Astrology) Directional planetary compass lines
Tarot Card Single card, three card, or Celtic Cross spreads.
Planetary Positions (Vedic Astrology) Get simplified planetary positions (graha positions) for all 9 planets (Sun through Ketu) plus Ascendant (Lagna)
Solar Return Chart (Western Astrology) Annual birthday forecast with relocated chart
Aspect Patterns (Western Astrology) Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium
Crystals Crystal healing database
Daily Finance Score (Vedic Astrology) A Krishnamurti Paddhati daily finance reading for one native on one date
Monthly Parallels (Western Astrology) Declination contacts for an entire month
Personal Day (Numerology) Daily personalized numerology forecast
Current Mahadasha (Vedic Astrology) Calculate all five running Vimshottari Dasha levels (Mahadasha, Antardasha, Pratyantardasha, Sookshma, Prana) with remaining time in each
Ecliptic Crossings (Western Astrology) Node passages for a whole year
Numerology Life path, expression, and soul urge from a name and date.
Mayan Day Sign for a Date (Mesoamerican Astrology) Mayan astrology day sign calculator: returns the Tzolkin day sign, the coefficient 1 to 13 and the trecena for any Gregorian date, under the correlation living daykeepers use, with a composed nawal reading
Crystals by Element Elemental crystal lookup
Daily Reading (Vedic Astrology) Composed Gochara, Panchanga and Dasha for one native on one day
Aztec Day Sign (Mesoamerican Astrology) Tonalpohualli sign profile
Trigram by Number or Name (I Ching) Retrieve a specific I-Ching trigram by its number (1-8) or English name (Heaven, Earth, Thunder, Wind, Water, Fire, Mountain, Lake)
Hebrew Letters (Kabbalah) Hebrew alphabet with the Sefer Yetzirah attributions
Sephirah (Kabbalah) sefirot meaning with the paths that touch it
Astrology Section Wrapper block that shares a default zodiac sign and birth date with every RoxyAPI block inside it via block context.
Choghadiya (Vedic Astrology) 8 Muhurta divisions of day and night
Daily Aztec Energy Reading (Mesoamerican Astrology) Tonalpohualli day sign of the day
Human Design Type Calculate the core Human Design identity from a birth moment: the energy type, the aura strategy, the inner authority, the signature and not-self themes, and the profile
BaZi Chart (Chinese Astrology) Calculate a complete BaZi chart, the Four Pillars of Destiny, from a birth moment
Black Moon Lilith (Western Astrology) mean and true lunar apogee in the natal chart
Eight Mansions Map (Feng Shui) Build the full Eight Mansions (Ba Zhai) map for a person: all eight compass sectors classified into the four favourable stars, Sheng Chi, Tian Yi, Yan Nian and Fu Wei, and the four unfavourable ones, Huo Hai, Wu Gui, Liu Sha and Jue Ming
Zodiac Signs (Western Astrology) Complete zodiac signs list with dates and elements
Haab Period (Mesoamerican Astrology) Maya solar calendar month profile
Search Dream Symbols Browse and search our complete dream interpretation dictionary containing 2,000+ dream symbols with psychological meanings
KP Sublord Changes (Vedic Astrology) Track when planets cross KP sublord boundaries (1-249 divisions) for precise Krishnamurti Paddhati event timing
Declination Parallels (Vedic Astrology) Planets at same or opposite declination
Human Design Center by ID Look up the static reference data for one of the nine Human Design centers by its id: the display name, whether it is a motor or awareness center, and what it means both defined and undefined
Planetary Yogas (Vedic Astrology) 301 entry Vedic Yoga Glossary
Elements (Chinese Astrology) Wu Xing with generating and controlling cycles
Almanac for a Day (Chinese Astrology) Tong Shu with day officers and mansions
Planetary Aspects (Drishti) Mutual aspects between all planets
Biorhythm Forecast Multi-day cycle predictions with best and worst days
Secondary Progressions (Western Astrology) progressed chart, progressed Sun and Moon
Convert Lunar and Gregorian Dates (Chinese Astrology) Chinese lunisolar calendar
Crystal Colors List all unique crystal colors available in the database
Daily Hexagram (I Ching) Receive a daily I-Ching hexagram for guidance and reflection
Tastes (Ayurveda) Ayurveda rasa and dosha matrix
Cities in a Country (Location) Geocoding directory sorted by population
Supported Response Languages Returns the language codes accepted by the `lang` query parameter on every i18n-aware endpoint
Human Design Bodygraph Type, authority, profile, centers, channels, gates
Hexagram by Number (I Ching) Retrieve complete I-Ching hexagram details by King Wen sequence number (1-64)
Hexagrams (I Ching) I-Ching hexagram catalog
Luck Pillars (Chinese Astrology) BaZi Da Yun ten-year cycle
Chinese Zodiac Compatibility (Chinese Astrology) Trine, six harmony, clash and harm analysis
Aztec Day Sign for a Date (Mesoamerican Astrology) Aztec calendar day sign calculator: returns the tonalpohualli day sign, its coefficient 1 to 13 and its trecena for any Gregorian date, with a composed reading
Random Crystal Get a randomly selected healing crystal as a discovery teaser
Classical Vedic Yogas in a Birth Chart (Vedic Astrology) Chart-driven detection of 48 classical Vedic yogas
Solar Return Chart (Forecast) Annual birthday forecast chart for a single subject
Rashis (Vedic Astrology) Vedic Zodiac Signs Reference
Chinese Zodiac Animal for a Birth Date (Chinese Astrology) Resolve a birth date to its Chinese zodiac animal, the sexagenary year pillar behind it, and the Five Element phase of that year, so a 1990 birth returns Horse as a Metal Horse rather than merely a Horse
Chinese Zodiac Animals (Chinese Astrology) Sheng Xiao sign catalogue
Navamsa Chart (D9) Marriage Compatibility Calculator
Monthly Flying Stars (Feng Shui) Month by month feng shui overlay
Career Spread, 7 Cards (Tarot) Perform a comprehensive 7-card career tarot spread using SWOT analysis framework (Strengths, Weaknesses, Opportunities, Threats) for professional guidance, business decisions, and vocational clarity
Planet Meaning Details (Western Astrology) Complete astrology planet interpretation
Annual Flying Stars (Feng Shui) Yearly feng shui star chart
Angel Numbers Retrieve the complete database of angel numbers with summary information
Nakshatra by ID (Vedic Astrology) Get detailed information for a single nakshatra (lunar mansion) by its ID slug, one of the 27 nakshatras of Vedic astrology
Crystal Pairings Get crystals that pair well with a given crystal for enhanced healing combinations
Natal Chart Western birth chart with planets, houses, and aspects.
Karmic Lessons (Numerology) Life lessons from missing numbers
Mayan Day Sign (Mesoamerican Astrology) Retrieve the full profile of one Tzolkin day sign: both naming traditions, both published glosses, the world direction and colour under the requested scheme, a composed keynote, what the sign does well, where the same temperament costs it something, and one line of guidance
Love Spread, 5 Cards (Tarot) Relationship tarot reading
Monthly Lunar Aspects (Vedic Astrology) Moon aspect events with all planets for a month
Annual Afflictions (Feng Shui) Tai Sui, San Sha and Five Yellow
Crystal Planets List all unique planetary associations available in the database
Heliacal Rising and Setting (Vedic Astrology) Calculate heliacal rising (udaya) and setting (asta) of the six visible grahas for any date and place, by the Surya Siddhanta rule
Countries (Location) ISO codes and city coverage
Daily Chinese Zodiac Reading (Chinese Astrology) Day pillar forecast by animal sign
Upagraha (Sub-planet) Positions (Vedic Astrology) Calculate all 11 Vedic upagraha (sub-planet) positions per Brihat Parashara Hora Shastra (BPHS)
Daily Angel Number Get the angel number of the day with full meaning and interpretation
Aztec Trecena (Mesoamerican Astrology) Tonalpohualli period profile
KP Rasi Ingress Times (Vedic Astrology) Track when planets enter new zodiac signs (rasi) with precise ingress timestamps
Bhav Chalit (Vedic Astrology) Calculate the Bhav Chalit chart, also written Bhava Chalit or Chalit Kundli, placing every graha by unequal Sripati bhava cusps instead of by whole sign
Aztec Day Signs (Mesoamerican Astrology) Tonalpohualli sign catalogue
Human Design Gate by Number Look up the static reference data for a Human Design gate by its number from 1 to 64: the gate keynote name, the center it sits in, the matching I-Ching hexagram, and the gates that form a channel with it
Monthly Transit (Vedic Astrology) Planetary sign changes for an entire month
Haab Periods (Mesoamerican Astrology) Maya solar calendar month
Mayan Chart (Mesoamerican Astrology) Tzolkin, Haab and Long Count
Yearly Horoscope by Zodiac Sign (Western Astrology) Year ahead forecast with themes, key periods, eclipses and retrogrades
Three Card Spread (Tarot) Perform the classic three-card tarot spread revealing Past (what led to this situation), Present (current energy and circumstances), and Future (likely outcome if current path continues)
Pratyantardashas (Vedic Astrology) Pratyantardasha for Vedic astrology
Ayurvedic Constitution (Ayurveda) Read the Ayurvedic constitution from a sidereal birth chart and return the vata, pitta and kapha shares with a verse behind every factor
Mayan Trecena (Mesoamerican Astrology) Thirteen day period profile
Nakshatras (Vedic Astrology) Lunar Mansions Reference
Planet Meanings (Western Astrology) Complete astrology planet interpretations list
Dream Symbol by ID Get the complete dream interpretation for a specific symbol
Lunar Return Chart (Western Astrology) Monthly emotional forecast with Moon cycle chart
Ayurveda Seasonal Regimen Ritucharya and ritu resolution
Compare Two Names (Kabbalah) gematria name compatibility with every component published
Monthly Ephemeris (Vedic Astrology) Daily sidereal planetary positions for a month
Mayan Trecenas (Mesoamerican Astrology) Tzolkin thirteen day period
Flying Star Natal Chart (Feng Shui) Cast the Xuan Kong flying star natal chart for a building from its construction period and the direction it faces
Solar Arc Directions (Western Astrology) directed chart at one degree per year
Random Dream Symbols Discover random dream symbols and their interpretations for daily dream insights and exploration
Number Meaning (Numerology) Interpretation for any number 1-9, 11, 22, 33
Bridge Numbers (Numerology) Harmonize different aspects of personality
Field Labels for a Language Returns the display label for every request field name and every selectable option across the , in the requested language
Gematria (Kabbalah) Hebrew gematria with every spelling shown
Mahadasha Periods (Vedic Astrology) Returns the complete Vimshottari dasha cycle from birth, all 9 Mahadasha periods across the full 120 year span
Rashi by ID (Vedic Astrology) Vedic Zodiac Sign Detail
Human Design Profile and Line Keynotes Calculate the Human Design profile for a birth moment: the conscious Personality Sun line over the unconscious Design Sun line, with the keynote for each
Crystal by ID Crystal healing properties
Monthly Transits (Western Astrology) Tropical sign ingresses for an entire month
Bagua Sector (Feng Shui) Look up one palace of the compass Bagua map by its life area id, such as wealth, career or love
Daily Biorhythm Seeded reading for daily check-in features
Number Sequence (Angel Numbers) Smart angel number analysis that works for ANY number sequence, not just known angel numbers
Personality Number (Numerology) Calculate your Personality number from the consonants in your birth name using Pythagorean numerology
Daily Crystal Get the crystal of the day as a discovery teaser
Fixed Stars and Star Conjunctions (Western Astrology) Regulus, Spica, Algol natal report
Tree of Life (Kabbalah) sephirot and 22 paths with typed school variants
Periods (Feng Shui) The nine twenty year periods of the 180 year San Yuan cycle from 1864 to 2043, each with its ruling star, five phase, palace and the exact Li Chun date it opened, plus which period is in force on a given date
Zodiac Sign Details (Western Astrology) Complete astrology sign profile with personality traits
Astrocartography Map (Western Astrology) planetary lines and relocation calculator
Weekly Horoscope by Zodiac Sign (Western Astrology) Seven-day editorial column
Planetary Positions (Western Astrology) Ephemeris calculator for all planets
Bhava Bala (Vedic Astrology) Calculate Bhava Bala (house strength) for all twelve bhavas per Brihat Parashara Hora Shastra (BPHS) and BV Raman Graha and Bhava Balas
Ecliptic Crossings (Vedic Astrology) When planets cross the ecliptic plane
Month of Almanac Days (Chinese Astrology) Chinese calendar month view
Upcoming Moon Phases (Western Astrology) Next new moon, full moon, quarters
Avastha by ID (Vedic Astrology) Look up a single avastha state by its slug, which is the lowercased state name a Vedic birth chart returns in `awastha`, `jagradadi` or `deeptadi`
Basic Panchang (Vedic Astrology) Tithi Nakshatra Yoga Karana Calculator
Cast a KP Horary (Vedic Astrology) Cast a Krishnamurti Paddhati horary chart, also called Prashna, from a number between 1 and 249 given by the querent plus the moment and place the question is judged
KP Planetary Positions (Vedic Astrology) Get planetary positions with detailed KP star-lord and sub-lord calculations for precise event timing and significator analysis
KP Ruling Planets with Significators (Vedic Astrology) Calculate ruling planets and their KP significators at regular time intervals using Krishnamurti Paddhati prashna (horary) astrology
Prana Dashas (Vedic Astrology) Prana dasha for Vedic astrology
Biorhythm Physical, emotional, and intellectual cycle values.
Planetary Transits (Western Astrology) Current transits with natal chart comparison
Annual Profections (Western Astrology) lord of the year and yearly time lord by age
Crystals by Chakra Get healing crystals and gemstones that resonate with a specific chakra energy center
Kalsarpa Dosha (Vedic Astrology) Detect Kalsarpa dosha (Kalsarpa yoga) when all 7 planets are hemmed between Rahu-Ketu axis
Daily Mayan Energy Reading (Mesoamerican Astrology) Tzolkin day sign of the day
Cast an I-Ching Reading Generate an authentic I-Ching reading using the traditional three-coin casting method
Compound Number Meaning (Numerology) Cheiro Chaldean interpretation 10 to 52
Arudha Padas (Vedic Astrology) Calculate the Arudha Lagna (AL) and all twelve Arudha padas of Jaimini astrology from birth details
Random Hexagram (I Ching) Receive a random I-Ching hexagram with full interpretation

Installation

In your WordPress admin, go to Plugins, Add New, search for “RoxyAPI”, and click Install Now.
Activate the plugin.
Sign up for a RoxyAPI account at https://roxyapi.com and get your API key.
Open the RoxyAPI menu in the WordPress admin sidebar and paste your key.
Click Save Changes. Use the Test Connection button to verify.
Add a block from the inserter or use the matching shortcode.

Configure the API key via wp-config.php (recommended for production):

Add this line to your wp-config.php above the “stop editing” comment:

define('ROXYAPI_KEY', 'your_roxyapi_key_here');

When the constant is set, the settings field is disabled and the constant takes priority.

For production hosts that inject secrets via environment variables (Pantheon, WP Engine, Kinsta, Bedrock), also define the encryption key and salt:

define( 'ROXYAPI_ENCRYPTION_KEY', getenv( 'ROXYAPI_ENCRYPTION_KEY' ) );
define( 'ROXYAPI_ENCRYPTION_SALT', getenv( 'ROXYAPI_ENCRYPTION_SALT' ) );

Without these, the plugin falls back to your WordPress LOGGED_IN_KEY and LOGGED_IN_SALT, which is acceptable for most installs.

FAQ

Do I need a RoxyAPI account?

Not to get started. A limited number of free readings per day are allowed right after install, with no account, so you can try the plugin. The allowance is shared across your site and resets each day. For production use, add an API key from a RoxyAPI plan: one key covers every reading and removes the daily limit. Pick a plan at https://roxyapi.com/pricing.

What readings can I add to my site?

One key covers 18 domains. Western astrology: natal chart, daily / weekly / monthly / yearly horoscopes, synastry with a two way house overlay, compatibility, transits, aspect patterns, and moon phases. Vedic astrology: kundli, KP chart, panchang, Vimshottari dasha, divisional charts, nakshatras, doshas (Manglik, Kaal Sarpa, Sade Sati), and classical yogas. Numerology: Life Path, Expression, Soul Urge, Personality, personal year, and compatibility. Tarot: single card, three card, Celtic Cross, and the full 78 card catalog. Human Design: bodygraph, type, authority, profile, centers, channels, and gates. Forecasts: timelines, transit forecasts, solar returns, and significant dates. 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) with its day officer. Feng shui: the Kua number and Eight Mansions directions, the nine palace Flying Star chart for a building or a year, bagua sectors, and annual afflictions. Mesoamerican astrology: the Tzolkin day sign, the Mayan chart, 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. Kabbalah: gematria, name and birth profiles, the 72 names, the Tree of Life, and the Hebrew letters. Ayurveda: constitution from the birth chart, dinacharya, ritucharya, a daily reading, and the dosha, rasa, and guna catalogues. Plus biorhythm, I Ching hexagrams, crystal reference data, dream symbols, and angel numbers. Every reading is available as a shortcode. More than 180 of them also ship a matching Gutenberg block, each with sidebar controls for its inputs (a date picker for dates, a dropdown for fixed choices, text and number fields for the rest) and a live preview in the editor. The headline readings (horoscope, natal chart, tarot, numerology, biorhythm, angel number) are built the same way, and the horoscope block adds a variation picker. Interactive multi input readings such as two chart compatibility and nested birth forms stay shortcode and visitor form mode, because the block editor cannot collect their nested input. Browse the full list inside WordPress under RoxyAPI, Shortcodes.

Can I show readings in another language?

Yes. Readings follow your WordPress site language on their own, so a Spanish site returns Spanish readings with nothing to configure. To run your site in one language and your readings in another, open the RoxyAPI menu, Branding tab, and pick a reading language: English, German, Hindi, Spanish, Turkish, Portuguese, French, or Russian. Readings switch to that language, though a handful of specialized terms stay in English.

When does the plugin contact the RoxyAPI service?

The plugin contacts roxyapi.com only when you take a clear action that requires it:

You click the Test Connection button on the settings page.
A page on your site that contains a RoxyAPI block or shortcode is rendered (cached for one hour by default to keep your API quota low). Readings render with or without an API key, so these requests also happen before you connect one.

The plugin never contacts RoxyAPI on plugin activation, on plugin update, on any admin page that does not display a reading, or in the background. Placing a RoxyAPI block or shortcode on a page is the explicit action that authorizes the render-time calls described above.

What data is sent to RoxyAPI?

When the plugin contacts roxyapi.com, the request includes:

The reading parameters you supply via the block or shortcode (zodiac sign, birth date, name, location coordinates, question text).
Your site URL, so RoxyAPI can attribute requests to your site for support.
The plugin name and version, so RoxyAPI can spot compatibility problems with a particular release.
Your server outbound IP address (incidentally captured by the receiving server, like any HTTP request).

No site visitor data is collected by the plugin when a visitor only views a page; their IP, user agent, and any browser-side data are not sent to RoxyAPI in the passive case. When a visitor submits a form-mode shortcode (their birth date, name, or question), the plugin sends only the fields they typed, after they tick the consent checkbox. See https://roxyapi.com/policy/privacy for what RoxyAPI does with the data once received.

Can visitors fill in their own birth details?

Yes. Drop a hero shortcode with no attributes (for example [roxy_natal_chart]) and the plugin renders an accessible form with a city search that fills in coordinates automatically. On submit the plugin validates the input, applies a per-IP rate limit and a consent checkbox, calls the API server side, and renders the result on the same page. The API key never reaches the browser.

I am behind Cloudflare or a reverse proxy. Does the visitor rate limit still count each visitor?

Not until you tell the plugin which forwarded header to believe. The only address a WordPress site can verify is the one the connection arrives from, which behind a proxy is the proxy itself, so by default every visitor shares one bucket. Forwarded headers are ignored because anyone can send them, and a limit that resets whenever a header changes is no limit at all.

If your proxy overwrites a header on every request, opt that header in from your theme functions file or a small site plugin:

add_filter( 'roxyapi_trusted_proxy_headers', function () { return array( 'HTTP_CF_CONNECTING_IP' ); } );

Register it with 10, 2 instead and the callback also receives the connecting address, so you can trust the header only while the request really is arriving from your own edge. On a custom setup, return the visitor address yourself with the roxyapi_client_ip filter instead.

Can I sell readings or charts to my clients?

Yes, and you do not need a separate integration. Place any RoxyAPI shortcode or block on a page, then gate that page with a membership or paywall plugin such as Paid Memberships Pro, Restrict Content, or WP-Members, or sell access as a WooCommerce product through a memberships add-on. Members and buyers who reach the page see the reading; everyone else sees your paywall. Because the chart renders exactly where you place the shortcode, you decide what stays free, like a teaser daily horoscope, and what is paid, like a full natal chart, a compatibility score, or a Vedic kundli. RoxyAPI keeps no birth data, so your client list and their details stay entirely yours.

Is the API key safe?

Yes. The plugin makes API calls server side in PHP. The key is never sent to the browser. You can also store the key in wp-config.php with define(‘ROXYAPI_KEY’, ‘…’) if you do not want it in the database. Stored keys are encrypted at rest via AES-256-CTR.

Does this work with caching plugins?

Yes. The plugin uses WordPress transients, which automatically use Redis or Memcached if you have a persistent object cache.

Can I customize the styling?

Yes. Readings pick up your theme font, and the RoxyAPI menu under Branding gives you four ready-made palettes plus seven colors you can set yourself: accent, page background, card background, text, secondary text, borders and warnings. Each takes a light value and a dark value, so a dark brand color stays readable for a visitor in dark mode. Charts follow your light or dark mode automatically and read the –roxy-* CSS custom properties, so you can also override any token in your theme stylesheet. Every output element has a .roxyapi-* class you can target.

Can I hide part of a reading, such as the chart patterns?

Yes, at two levels. The RoxyAPI menu under Display has Written readings, which removes the interpretation from every reading and leaves the charts, tables and values in place. Below it, Hide sections takes a comma-separated list of section names and removes those blocks outright, so entering patterns removes the chart patterns block wherever it appears on your site.

Click the Hide sections field to see every name your version supports, and separate several with commas. The names are internal and stay the same whatever language your site runs in, so the title printed above a block is not one of them. If you enter a name that matches nothing, saving tells you which one, rather than leaving you with a setting that appears to have saved and quietly does nothing.

Those two are separate on purpose. A chart pattern such as a T-square reports the figure, its element and modality, how tight it is and which planets form it. Those are measurements rather than prose, so turning off written readings leaves them in place.

Both can be overridden on a single placement, so one page does not have to follow the whole site. Add hide_sections="patterns" to a shortcode and only that reading loses the block, or hide_sections="none" to keep a block on one page that the site setting hides everywhere else. hide_readings="1" and hide_readings="0" work the same way. A block placed in the editor follows the site setting.

You can also target any section yourself from Appearance, Customize, Additional CSS, or from your child theme stylesheet. Every block of a reading is exposed as a CSS part:

roxy-natal-chart::part(patterns) { display: none }

roxy-ephemeris-table::part(changes) { display: none }

Common section names are readings, patterns, aspects, changes, chart, legend, table and details. A name means the same block everywhere it appears, so one rule covers every reading that has that block: ::part(aspects) reaches the aspect grid on a natal chart and the aspect list on an aspects table alike. Open your browser inspector and read the part attribute off any block to find the name for it. The same selector restyles a section instead of hiding it, so you can give one block its own background or spacing without touching the rest.

Which calculation engine powers RoxyAPI?

RoxyAPI cross-checks its astronomy calculations against the NASA JPL Horizons ephemeris (a public NASA dataset; no affiliation with NASA or JPL). See https://roxyapi.com/methodology for the full breakdown.

How do I share the zodiac sign across several horoscopes on one page?

Add the Astrology Section wrapper block, set the sign in its Inspector, then drop Horoscope blocks inside. Each one picks the sign up from the wrapper, so you set it once. Other readings take their inputs from their own sidebar controls.

Can I try it for free before subscribing?

Yes. The plugin works the moment you activate it. Add a shortcode or block and it renders on a free daily allowance, no API key required. When you need more headroom, add a key from your RoxyAPI account; see https://roxyapi.com/pricing for current plans. You can also call every endpoint live in your browser at https://roxyapi.com/api-reference, no signup needed.

Does this work with Elementor, Divi, or other page builders?

Yes. All RoxyAPI shortcodes work inside any page builder that supports WordPress shortcodes. Use the shortcode in a text or HTML module. The Gutenberg blocks work in the default WordPress editor.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“RoxyAPI: Astrology, Vedic, Forecast, Human Design, Numerology” is open source software. The following people have contributed to this plugin.

roxyapi

Translate “RoxyAPI: Astrology, Vedic, Forecast, Human Design, Numerology” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.16.0

New: a KP daily finance reading, [roxy_get_kp_daily_finance], with a Daily Finance Score block. Four Krishnamurti Paddhati layers are scored against the money houses and weighed into one number for the day, every row printed, and the gain houses, loss houses and layer weights can be overridden. It draws as a card of its own: the band and score, the gain and loss significators with the evidence by house, the four layers as tables with their weights, and the best and worst Moon windows of the day, with every heading in your site language.
New: the gematria, name profile and name compatibility readings take a second letter map. Add transliteration=”letter-map-modern” for the modern Israeli transcription, which writes every Latin letter, or leave it off for the Hermetic map.
New: the finance section of the Vedic daily reading carries a combined score. One word for the day, the score beside it, and the three readings behind it with a score each, so a client can see what the verdict rests on.
New: the current dasha reading takes a datetime, so you can prepare a reading for a day ahead or read the running periods at a past moment. Add datetime=”2026-10-01T09:00:00″ to the shortcode, or fill the field in the block.
Fixed: the date attribute on [roxy_horoscope] now reaches the weekly, monthly and yearly periods, so period=”monthly” date=”2026-10-01″ publishes the October reading. It was silently ignored on every period but daily. The current week and month also turn over on your site clock rather than at midnight UTC, and one reading is fetched per week or month however many days a page is viewed on.
Fixed: the sign picker under [roxy_horoscope period=”monthly”] answers with the monthly reading. It answered with the daily whatever period was placed.
Fixed: a list attribute, such as planets, aspect_types, ciphers, gain_houses or loss_houses, is read as a comma list, and an object attribute such as weights as JSON. Each was posted as typed and refused by the API.
Improved: the I Ching daily cast now draws as a hexagram card, with any changing lines named, instead of a plain list of values.
Improved: the choghadiya grid and the hora table head their daylight column Daytime instead of Day, which reads correctly beside the night periods. Translated sites get that heading and the combined score in the site language.
Improved: a long reading keeps its paragraphs in the version search engines and readers without JavaScript receive. A monthly horoscope column ran as one block there.

1.15.0

New: four whole domains, Mesoamerican astrology, Vastu, Kabbalah and Ayurveda, as 48 readings with matching Gutenberg blocks. Mesoamerican astrology brings the Tzolkin day sign, the Mayan chart with Haab and Long Count, the Aztec tonalpohualli, nawal compatibility and a Long Count converter. Vastu brings the Vastu Purusha Mandala, the entrance pada, plot analysis, room compliance, Ayadi and griha pravesh dates. Kabbalah brings gematria with every spelling shown, name and birth profiles, the 72 names, the Tree of Life and the Hebrew letters. Ayurveda brings the constitution from a birth chart, a daily reading, dinacharya and ritucharya.
New: the day sign, the Vastu mandala, gematria and the dosha constitution now draw as dedicated charts and cards instead of a plain list of values. The day sign carries its coefficient and trecena, with the full Calendar Round on the chart. The mandala lays out the pada grid with a devata in every square and the brahmasthan marked, and lights the entrance pada with its effect. Gematria shows the value by cipher beside every candidate Hebrew spelling with its letter by letter breakdown, plus equal value words. The constitution renders vata, pitta and kapha as one bar with the dominant humour and the birth chart factors behind it.
Improved: the BaZi four pillars, the luck pillars strip, the Kua number map, the flying star plate, the Chinese zodiac animal and pair score cards, and the Tong Shu almanac day now draw their headings and labels in your site language instead of English.
Improved: the Kua number map and the flying star plate resize to fit their container and stay legible on a phone screen, with compass and palace labels that no longer break in the middle of a word.
Improved: the label column beside a reading, including on the Kua map, the flying star plate, the dosha constitution and the daily horoscope key dates, never grows past a quarter of the card width, so the reading text keeps the room it needs on a narrow screen.

Older entries are in changelog.txt.

Description

Shortcode examples

Screenshots

Blocks

Installation

FAQ

Do I need a RoxyAPI account?

What readings can I add to my site?

Can I show readings in another language?

When does the plugin contact the RoxyAPI service?

What data is sent to RoxyAPI?

Can visitors fill in their own birth details?

I am behind Cloudflare or a reverse proxy. Does the visitor rate limit still count each visitor?

Can I sell readings or charts to my clients?

Is the API key safe?

Does this work with caching plugins?

Can I customize the styling?

Can I hide part of a reading, such as the chart patterns?

Which calculation engine powers RoxyAPI?

How do I share the zodiac sign across several horoscopes on one page?

Can I try it for free before subscribing?

Does this work with Elementor, Divi, or other page builders?

Reviews

Contributors & Developers

Interested in development?

Changelog

1.16.0

1.15.0

Meta

Ratings

Contributors

Support