WordPress.org

Қазақша

Get WordPress
WordPress.org

Plugin Directory

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

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

By roxyapi
Download

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. 14+ domains. 209+ 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, and monthly horoscopes, synastry, 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: BaZi four pillars, Day Master strength, luck pillars, zodiac signs and compatibility, the 24 solar terms, and the lunisolar almanac
  • Feng shui: Kua numbers, Eight Mansions directions, flying star charts, and annual afflictions
  • Numerology: Life Path, Expression, Soul Urge, and Personality numbers
  • Tarot: single card, three card, Celtic Cross, and custom spreads
  • 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.

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 14+ 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_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"]
  • 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.
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.
The Shortcodes Library. Every reading across every domain in one searchable, copy-paste browser.
Vedic kundli rendered as an interactive chart in North, South, and East Indian styles.
Vedic kundli rendered as an interactive chart in North, South, and East Indian styles.
Detailed panchang: tithi, nakshatra, yoga, karana, planetary hours, and the auspicious muhurtas for any date and place.
Detailed panchang: tithi, nakshatra, yoga, karana, planetary hours, and the auspicious muhurtas for any date and place.
Human Design bodygraph with type, strategy, authority, profile, the nine centers, channels, and gates.
Human Design bodygraph with type, strategy, authority, profile, the nine centers, channels, and gates.
Astrocartography map. Every planetary line plotted across the world for relocation and travel planning.
Astrocartography map. Every planetary line plotted across the world for relocation and travel planning.
Daily horoscope card for any zodiac sign, with love, career, health, finance, and lucky details.
Daily horoscope card for any zodiac sign, with love, career, health, finance, and lucky details.
Connect in seconds. Free to start, with copy-paste shortcodes and a guided quick start.
Connect in seconds. Free to start, with copy-paste shortcodes and a guided quick start.

Blocks

This plugin provides 186 blocks.

  • Planet Meanings (Western Astrology) Complete astrology planet interpretations list
  • Birth Day Number (Numerology) Special talents from day of birth
  • Divisional Chart (Varga) Calculate any Vedic divisional chart (Varga) from D2 Hora to D60 Shashtiamsa
  • Astrology Section Wrapper block that shares a default zodiac sign and birth date with every RoxyAPI block inside it via block context.
  • 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
  • Upcoming Moon Phases (Western Astrology) Next new moon, full moon, quarters
  • Search Dream Symbols Browse and search our complete dream interpretation dictionary containing 2,000+ dream symbols with psychological meanings
  • Convert Lunar and Gregorian Dates (Chinese Astrology) Chinese lunisolar calendar
  • Biorhythm Physical, emotional, and intellectual cycle values.
  • Sadhesati (Vedic Astrology) Sade Sati (Saturn Transit)
  • KP-Newcomb Ayanamsa (Vedic Astrology) Dynamic daily calculation
  • Solar Arc Directions (Western Astrology) directed chart at one degree per year
  • Defined Human Design Channels Calculate the defined channels for a birth moment
  • KP Rasi Ingress Times (Vedic Astrology) Track when planets enter new zodiac signs (rasi) with precise ingress timestamps
  • Soul Urge Number (Numerology) Inner motivations and desires
  • Phase Info (Biorhythm) Lightweight cycle status for dashboards and widgets
  • Field Labels for a Language Returns the display label for every request field name and every selectable option across the , in the requested language
  • 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)
  • Current Mahadasha (Vedic Astrology) Calculate all five running Vimshottari Dasha levels (Mahadasha, Antardasha, Pratyantardasha, Sookshma, Prana) with remaining time in each
  • Classical Vedic Yogas in a Birth Chart (Vedic Astrology) Chart-driven detection of 48 classical Vedic yogas
  • Daily Chinese Zodiac Reading (Chinese Astrology) Day pillar forecast by animal sign
  • Choghadiya (Vedic Astrology) 8 Muhurta divisions of day and night
  • 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
  • Monthly Transit (Vedic Astrology) Planetary sign changes for an entire month
  • 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
  • Crystal Healing Properties Get complete healing properties and metaphysical data for a specific crystal or gemstone
  • Elements (Chinese Astrology) Wu Xing with generating and controlling cycles
  • Weekly Horoscope by Zodiac Sign (Western Astrology) Get weekly horoscope for any zodiac sign
  • Personality Number (Numerology) Calculate your Personality number from the consonants in your birth name using Pythagorean numerology
  • Hora (Vedic Astrology) 24 Planetary Hours (12 day + 12 night)
  • Solar Return Chart (Western Astrology) Annual birthday forecast with relocated chart
  • House Cusps (Western Astrology) House system calculator with comparison
  • Asteroid Goddesses (Western Astrology) Ceres, Pallas, Juno, and Vesta natal positions
  • Detailed Tarot Card Information 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)
  • Annual Afflictions (Feng Shui) Tai Sui, San Sha and Five Yellow
  • Daily I-Ching Hexagram Receive a daily I-Ching hexagram for guidance and reflection
  • KP Sublord Changes (Vedic Astrology) Track when planets cross KP sublord boundaries (1-249 divisions) for precise Krishnamurti Paddhati event timing
  • Yoga Details by ID (Vedic Astrology) Vedic Yoga Glossary Entry
  • Bridge Numbers (Numerology) Harmonize different aspects of personality
  • 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
  • Monthly Flying Stars (Feng Shui) Month by month feng shui overlay
  • Personal Day (Numerology) Daily personalized numerology forecast
  • Monthly Transits (Western Astrology) Tropical sign ingresses for an entire month
  • Sookshma Dashas (Vedic Astrology) Returns the 9 Sookshma periods inside a chosen Pratyantardasha, the fourth and finest level of the Vimshottari dasha hierarchy
  • Daily Numerology Number Number of the Day with interpretation
  • Daily Dream Symbol Receive a single dream symbol for daily reflection and subconscious exploration
  • Human Design Variables The four arrows and Color, Tone, Base substructure
  • KP Ruling Planets with Optional Significators (Vedic Astrology) Calculate the 5 ruling planets at any moment using Krishnamurti Paddhati horary astrology
  • 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
  • Planetary Positions (Vedic Astrology) Get simplified planetary positions (graha positions) for all 9 planets (Sun through Ketu) plus Ascendant (Lagna)
  • Auspicious Days (Chinese Astrology) Chinese date selection for weddings and openings
  • Planetary Transits (Western Astrology) Current transits with natal chart comparison
  • Random Dream Symbols Discover random dream symbols and their interpretations for daily dream insights and exploration
  • Hexagrams (I Ching) Browse all 64 I-Ching hexagrams from the Book of Changes with their Chinese names, English translations, and trigram compositions
  • Zodiac Sign Details (Western Astrology) Complete astrology sign profile with personality traits
  • Rashis (Vedic Astrology) Vedic Zodiac Signs Reference
  • Love Spread (5 Cards) Perform a specialized 5-card relationship tarot spread analyzing romantic connections, emotional dynamics, and partnership potential
  • Avastha States (Vedic Astrology) Planetary State Reference
  • 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
  • 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
  • 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 Parallels (Western Astrology) Declination contacts for an entire month
  • Expression Number (Numerology) Natural talents and life goals
  • Dual Numerology Pythagorean and Chaldean name numbers in one call
  • 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)
  • 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
  • Crystal Colors List all unique crystal colors available in the database
  • Random Crystal Get a randomly selected healing crystal as a discovery teaser
  • Zodiac Signs (Western Astrology) Complete zodiac signs list with dates and elements
  • Relocation Chart (Western Astrology) Relocated birth chart calculator with shifted houses and angles
  • Celtic Cross Spread (10 Cards) Perform the legendary Celtic Cross spread — the most comprehensive and detailed tarot reading available, used by professional tarot readers worldwide for over a century
  • Solar Terms (Chinese Astrology) Jie Qi calendar with exact instants
  • Rashi by ID (Vedic Astrology) Vedic Zodiac Sign Detail
  • 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
  • Kalsarpa Dosha (Vedic Astrology) Detect Kalsarpa dosha (Kalsarpa yoga) when all 7 planets are hemmed between Rahu-Ketu axis
  • Annual Profections (Western Astrology) lord of the year and yearly time lord by age
  • Monthly Horoscope by Zodiac Sign (Western Astrology) 30-day transit forecast with key dates
  • Supported Response Languages Returns the language codes accepted by the `lang` query parameter on every i18n-aware endpoint
  • BaZi Annual Forecast (Chinese Astrology) Read one Gregorian year against a natal BaZi chart
  • Lunar Calendar (Western Astrology) Moon phases for entire month
  • Monthly Aspects (Western Astrology) Tropical aspect calendar for an entire month
  • Basic Panchang (Vedic Astrology) Tithi Nakshatra Yoga Karana Calculator
  • Planetary Aspects (Western Astrology) Aspect finder for any date and time
  • Angel Numbers Retrieve the complete database of angel numbers with summary information
  • 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
  • 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
  • Astrocartography Map (Western Astrology) planetary lines and relocation calculator
  • Monthly Planetary Aspects (Vedic Astrology) Major and minor aspect events for a month
  • Month of Almanac Days (Chinese Astrology) Chinese calendar month view
  • Prana Dashas (Vedic Astrology) Returns the 9 Prana periods inside a chosen Sookshma dasha, the fifth and finest level of the Vimshottari dasha hierarchy
  • Maturity Number (Numerology) Who you become in later life
  • 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
  • Planetary Yogas (Vedic Astrology) 301 entry Vedic Yoga Glossary
  • Local Space Astrology Map (Western Astrology) Directional planetary compass lines
  • Cast an I-Ching Reading Generate an authentic I-Ching reading using the traditional three-coin casting method
  • Monthly Ephemeris (Vedic Astrology) Daily sidereal planetary positions for a month
  • Luck Pillars (Chinese Astrology) BaZi Da Yun ten-year cycle
  • KP Placidus House Cusps (Vedic Astrology) Calculate unequal Placidus house cusps with ruling sign-lord, nakshatra-lord, and sub-lord for each cusp
  • Transit Analysis (Vedic Astrology) Compare current planets to natal chart (Gochar)
  • Bagua Sector (Feng Shui) Look up one palace of the compass Bagua map by its life area id, such as wealth, career or love
  • Ecliptic Crossings (Vedic Astrology) When planets cross the ecliptic plane
  • Crystals by Element Get healing crystals and gemstones associated with a specific natural element
  • Navamsa Chart (D9) Marriage Compatibility Calculator
  • Random Hexagram (I Ching) Receive a random I-Ching hexagram with full interpretation
  • Nakshatras (Vedic Astrology) Lunar Mansions Reference
  • KP Ruling Planets with Significators (Vedic Astrology) Calculate ruling planets and their KP significators at regular time intervals using Krishnamurti Paddhati prashna (horary) astrology
  • Arudha Padas (Vedic Astrology) Calculate the Arudha Lagna (AL) and all twelve Arudha padas of Jaimini astrology from birth details
  • Planetary Positions (Western Astrology) Ephemeris calculator for all planets
  • Daily Crystal Get the crystal of the day as a discovery teaser
  • Planet Meaning Details (Western Astrology) Complete astrology planet interpretation
  • Search Cities Worldwide (Location) Geocoding autocomplete with coordinates and timezone
  • Annual Flying Stars (Feng Shui) Yearly feng shui star chart
  • Almanac for a Day (Chinese Astrology) Tong Shu with day officers and mansions
  • 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
  • KP Planetary Positions (Vedic Astrology) Get planetary positions with detailed KP star-lord and sub-lord calculations for precise event timing and significator analysis
  • 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
  • Horoscope Daily, weekly, or monthly horoscope for any zodiac sign.
  • Critical Days (Biorhythm) Zero crossing detection for any date range
  • Hexagram by Line Pattern (I Ching) Find an I-Ching hexagram by its binary line pattern
  • Crystal Planets List all unique planetary associations available in the database
  • Shadbala (Vedic Astrology) Calculate complete Shadbala (six-fold planetary strength) per Brihat Parashara Hora Shastra (BPHS) and BV Raman Graha and Bhava Balas
  • Arabic Lots (Western Astrology) seven Hermetic parts including Part of Fortune and Spirit
  • Black Moon Lilith (Western Astrology) mean and true lunar apogee in the natal chart
  • Birthstone Crystals by Month Get the traditional birthstone crystals for a given birth month
  • Compound Number Meaning (Numerology) Cheiro Chaldean interpretation 10 to 52
  • Angel Number Meaning and pattern analysis for any number sequence.
  • Daily Reading (Vedic Astrology) Composed Gochara, Panchanga and Dasha for one native on one day
  • Crystals Retrieve healing crystals and gemstones with pagination
  • Pratyantardashas (Vedic Astrology) Returns the 9 Pratyantardasha (antara) periods inside a chosen Antardasha, the third level of the Vimshottari dasha hierarchy
  • Upagraha (Sub-planet) Positions (Vedic Astrology) Calculate all 11 Vedic upagraha (sub-planet) positions per Brihat Parashara Hora Shastra (BPHS)
  • Avastha by ID (Vedic Astrology) Look up a single avastha state by its slug, which is the lowercased state name a birth chart returns in `awastha`, `jagradadi` or `deeptadi`
  • Number Sequence (Angel Numbers) Smart angel number analysis that works for ANY number sequence, not just known angel numbers
  • Career Spread (7 Cards) Perform a comprehensive 7-card career tarot spread using SWOT analysis framework (Strengths, Weaknesses, Opportunities, Threats) for professional guidance, business decisions, and vocational clarity
  • Monthly Declination Parallels (Vedic Astrology) Parallel and contraparallel events for a month
  • Secondary Progressions (Western Astrology) progressed chart, progressed Sun and Moon
  • Chinese Zodiac Animals (Chinese Astrology) Sheng Xiao sign catalogue
  • Symbol Counts by Letter (Dream Interpretation) Get the count of dream symbols available for each letter A-Z
  • Countries (Location) ISO codes and city coverage
  • Karmic Lessons (Numerology) Life lessons from missing numbers
  • 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
  • Crystal Pairings Get crystals that pair well with a given crystal for enhanced healing combinations
  • 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
  • Solar Return Chart (Forecast) Annual birthday forecast chart for a single subject
  • Fixed Stars and Star Conjunctions (Western Astrology) Regulus, Spica, Algol natal report
  • Search Crystals Search for healing crystals by keyword or name
  • Karmic Debt Numbers (Numerology) Past life challenges (13, 14, 16, 19)
  • Trigrams (I Ching) Retrieve all 8 I-Ching trigrams (bagua) — the fundamental building blocks of hexagrams
  • Cities in a Country (Location) Geocoding directory sorted by population
  • Number Meaning (Numerology) Interpretation for any number 1-9, 11, 22, 33
  • Personal Month (Numerology) Monthly numerology forecast
  • Chinese Zodiac Animal (Chinese Astrology) Full sign profile with compatibility partners
  • Usage Statistics Returns current usage and plan limits for your subscription.
  • 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)
  • BaZi Chart (Chinese Astrology) Calculate a complete BaZi chart, the Four Pillars of Destiny, from a birth moment
  • Ashtakavarga (Vedic Astrology) Calculate complete Ashtakavarga analysis per Brihat Parashara Hora Shastra (BPHS)
  • Daily Angel Number Get the angel number of the day with full meaning and interpretation
  • Natal Chart Western birth chart with planets, houses, and aspects.
  • Planetary Aspects (Drishti) Mutual aspects between all planets
  • Declination Parallels (Vedic Astrology) Planets at same or opposite declination
  • Nakshatra by ID (Vedic Astrology) Get detailed information for a single nakshatra (lunar mansion) by its ID slug
  • Numerology Life path, expression, and soul urge from a name and date.
  • 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
  • Lunar Return Chart (Western Astrology) Monthly emotional forecast with Moon cycle chart
  • Personal Year (Numerology) Annual cycle and forecast for current year
  • Mahadasha Periods (Vedic Astrology) Returns complete Vimshottari Dasha cycle starting from birth
  • 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
  • Chinese Zodiac Compatibility (Chinese Astrology) Trine, six harmony, clash and harm analysis
  • Crystals by Chakra Get healing crystals and gemstones that resonate with a specific chakra energy center
  • Daily Biorhythm Seeded reading for daily check-in features
  • Calculate Kua Number (Feng Shui) Feng shui personal direction
  • Business Name Numerology Chaldean brand name analysis and lucky numbers
  • 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)
  • Planetary Return Chart (Western Astrology) Saturn return, Jupiter return, and inner planet cycles
  • Cast Daily I-Ching Reading Cast a complete daily I-Ching reading using the traditional three-coin method with seeded randomness
  • Aspect Patterns (Western Astrology) Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium
  • Antardashas (Vedic Astrology) Returns 9 Antardasha sub-periods within a Mahadasha
  • Monthly Ephemeris (Western Astrology) Daily tropical planetary positions for a month
  • Tarot Card Single card, three card, or Celtic Cross spreads.
  • Biorhythm Forecast Multi-day cycle predictions with best and worst days
  • Monthly Lunar Aspects (Vedic Astrology) Moon aspect events with all planets for a month
  • Dream Symbol Details Get the complete dream interpretation for a specific symbol
  • Draw Random Tarot Cards Draw 1-78 tarot cards from the complete Rider-Waite-Smith deck with seeded reproducibility for consistent personalized readings
  • 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
  • Ecliptic Crossings (Western Astrology) Node passages for a whole year
  • Chaldean Numerology Name Reading Destiny, compound number, planetary ruler

Installation

  1. In your WordPress admin, go to Plugins, Add New, search for “RoxyAPI”, and click Install Now.
  2. Activate the plugin.
  3. Sign up for a RoxyAPI account at https://roxyapi.com and get your API key.
  4. Open the RoxyAPI menu in the WordPress admin sidebar and paste your key.
  5. Click Save Changes. Use the Test Connection button to verify.
  6. 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 14 domains. Western astrology: natal chart, daily / weekly / monthly horoscopes, synastry, 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: BaZi four pillars, Day Master strength, luck pillars, zodiac signs and compatibility, the 24 solar terms, and the lunisolar almanac. Feng shui: Kua numbers, Eight Mansions directions, flying star charts, and annual afflictions. Plus biorhythm, I Ching hexagrams, crystal reference data, dream symbols, and angel numbers. Every reading is available as a shortcode. More than 150 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:

  1. You click the Test Connection button on the settings page.
  2. 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.

Contributors

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

  • New: two whole domains, Chinese astrology and feng shui, as 27 readings with matching Gutenberg blocks. BaZi four pillars, Day Master strength, luck pillars, BaZi compatibility and the annual forecast, the twelve zodiac animals with daily readings and compatibility, lunar date conversion, the Tong Shu almanac, the 24 solar terms and date selection for weddings and openings. On the feng shui side, Kua numbers, Eight Mansions directions, flying star natal, annual and monthly charts, the bagua sectors, the nine periods and the annual afflictions.
  • New: readings that turn on a school rule report which one they used, so a chart can be reconciled against the one a practitioner already draws. The day boundary, the year boundary and the hour clock come back on every BaZi response.
  • Improved: tested against WordPress 7.1.
  • Improved: the plugin listing leads with the domains people ask for most, and names the two new ones.

1.12.0

  • New: the daily Vedic reading renders as a full reading instead of a plain list of values. Panchang, the grahas of the day with their state, tara and chandrabala, the finance read and the running dasha, each in its own block.
  • Improved: chart labels read in your site language across the whole reading library. Headings, column names and vocabulary were still drawing in English on a long list of readings whatever the reading language, among them panchang, dasha, biorhythm, numerology, crystal, dream, hora, kundli, dosha, angel number, yoga, synastry, transit and the strength tables.
  • Improved: kundli and Western position tables mark a combust graha and a planetary war, and carry the nakshatra lord and essential dignity.
  • Improved: aspect lines on every chart are weighted by how exact the contact is, so a close aspect no longer reads the same as a wide one.
  • Fixed: Gochara reads from the natal Moon, and a chart with no ascendant falls back to a sign-fixed layout instead of coming out blank.
  • Fixed: synastry names each sign sector, shows each planet house in its own chart, and translates the score label.

1.11.4

  • New: four Western timing readings, each as a shortcode and a block. [roxy_get_monthly_tropical_aspects] for a month of aspects, [roxy_get_monthly_tropical_transits] for a month of sign ingresses, [roxy_get_monthly_declination_parallels] for a month of declination contacts, and [roxy_get_planetary_node_passages] for a year of ecliptic crossings.
  • Fixed: a reading stays readable inside a section that has a background of its own. The month controls under the ephemeris, the reading card, the visitor form and the error and notice lines now carry their own background and text colour together, instead of taking one from the page and the other from your theme.
  • Fixed: reading titles, badges, links and the submit button now meet the WCAG AA contrast minimum, in both light and dark.
  • Fixed: the sign picker on [roxy_horoscope] now looks like every other RoxyAPI form. It was the one form carrying its own set of class names, so none of the shared field, button and spacing styles ever reached it.

1.11.3

  • New: the RoxyAPI settings screens now read in your site language. Every tab, field label, help text, button and notice on them is translated, in all eight languages, as is the plugin description on your Plugins page. Until now the whole admin stayed English however your site was set, so a Spanish site was configured through an English screen. The domain names in the Shortcodes library, such as Human Design, stay as they are, the same way shortcode names do.
  • Fixed: the notice a visitor reads when a reading cannot be loaded, and the status messages under the city box on a birth details form, now read in your site language too. Fourteen more lines were coming out English on fully translated sites.

Older entries are in changelog.txt.

Meta

Ratings

No reviews have been submitted yet.

Your review

See all reviews

Contributors

Support

Got something to say? Need help?

View support forum