Descripción
RoxyAPI adds Astrology, Vedic, Forecast, Human Design, Chinese Astrology and Feng Shui readings to any WordPress post, page or widget, as Gutenberg blocks and shortcodes. Drop one on a page and it renders a real reading, server side, the moment you activate the plugin. No account, no setup, no calculation code to write. Start free, then add an API key when you go live.
One API key. 18+ domains. 258+ endpoints. Most astrology plugins cover one system. RoxyAPI covers the whole stack, so you build the entire experience without stitching services together:
- Western astrology: natal and birth charts, daily, weekly, monthly, and yearly horoscopes, synastry with a house overlay, compatibility, transits, and moon phases
- Vedic astrology: kundli, KP charts, panchang, Vimshottari dasha, divisional charts, nakshatras, yogas, gochara transits, and the Bhava Bala and Bhav Chalit house readings
- Forecast: cross-domain timelines, transit forecasts, solar returns, and significant dates
- Human Design: full bodygraph with type, authority, profile, centers, channels, gates, variables, and penta
- Chinese astrology: the BaZi Four Pillars chart, Day Master strength, ten year luck pillars, the Chinese zodiac sign with daily readings and compatibility, the 24 solar terms, and the Chinese almanac day (Tong Shu)
- Feng shui: the Kua number with Eight Mansions directions, the nine palace Flying Star chart, bagua sectors, and annual afflictions
- Mesoamerican astrology: the Tzolkin day sign, the Mayan chart with Haab and Long Count, a Long Count converter, daily and monthly readings, nawal compatibility, and the Aztec tonalpohualli
- Vastu: entrance pada, the Vastu Purusha Mandala, plot analysis, Ayadi, room compliance, and griha pravesh dates
- Numerology: Life Path, Expression, Soul Urge, and Personality numbers
- Kabbalah: gematria with every spelling shown, name and birth profiles, the 72 names, the Tree of Life, and the Hebrew letters
- Tarot: single card, three card, Celtic Cross, and custom spreads
- Plus: biorhythm, Ayurveda, I Ching, crystals, dream interpretation, and angel numbers
Every chart is calculated by Roxy Ephemeris and verified against NASA JPL Horizons, with readings in your site language. One key, one plan, no per-domain fees.
Frequently asked, answered up front
- Do I need an account to try it? No. Blocks and shortcodes render readings straight after activation on a free daily allowance.
- Do I need to know astrology to use it? No. Every reading arrives calculated and formatted, so you place a block and pick your options.
- Is the birth chart accurate? Charts come from Roxy Ephemeris and are verified against NASA JPL Horizons.
- Can visitors enter their own birth details? Yes. Leave the attributes off a 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 English, German, Hindi, Spanish, Turkish, Portuguese, French, and Russian, following the site language or one setting
- Parent Astrology Section wrapper block that sets the zodiac sign for the Horoscope blocks placed inside it
- Server side caching with per endpoint TTL to keep your API quota low
- API key stays server side. Never exposed to the browser.
About the service this plugin connects to
This plugin is a thin WordPress interface to RoxyAPI, a third-party paid service operated at https://roxyapi.com. The astrology, tarot, numerology, and other calculations all run on RoxyAPI servers. A small free daily allowance lets the plugin display readings without an account; a RoxyAPI API key is required for production use and removes the daily limit. Pricing and plan tiers are listed at https://roxyapi.com/pricing. Terms of Service: https://roxyapi.com/policy/terms. Privacy Policy: https://roxyapi.com/policy/privacy.
The plugin itself is GPLv2 or later and the source is available at https://github.com/RoxyAPI/sdk-wordpress.
Shortcode examples
Every reading is a shortcode. 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_bodygraph birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York"]
[roxy_tarot_card spread="three" question="What should I focus on this week"]
[roxy_tarot_yes_no question="Should I take the new job"]
[roxy_numerology name="Ada Lovelace" birth_date="1815-12-10"]
[roxy_life_path birth_date="1990-05-15"]
[roxy_biorhythm birth_date="1990-05-15" target_date="today"]
[roxy_angel_number number="1111"]
[roxy_crystals_by_zodiac sign="aries"]
Four heroes take no attributes: the three two-person compatibility readings render a visitor form for both people, and the forecast timeline renders a visitor form for the birth details and an optional date window:
[roxy_synastry]
[roxy_gun_milan]
[roxy_compatibility]
[roxy_forecast]
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.
Capturas








Bloques
Este plugin proporciona 240 bloques.
- Expression Number (Numerology) Natural talents and life goals
- Daily Ayurveda Reading Dosha clock and brahma muhurta by location
- Mayan Trecenas (Mesoamerican Astrology) Tzolkin thirteen day period
- Daily Finance Score (Vedic Astrology) A Krishnamurti Paddhati daily finance reading for one native on one date
- Monthly Declination Parallels (Vedic Astrology) Parallel and contraparallel events for a month
- Mayan Day Signs (Mesoamerican Astrology) Retrieve all twenty Tzolkin day signs in sequence order from Imix to Ajaw
- Mangal Dosha Check Mangal Dosha (manglik) status for matrimonial compatibility, with severity, remedies, and exception conditions.
- Griha Pravesh Dates (Vastu) Vastu house warming muhurta
- Ecliptic Crossings (Vedic Astrology) When planets cross the ecliptic plane
- Field Labels for a Language Returns the display label for every request field name and every selectable option across the , in the requested language
- Solar Terms (Chinese Astrology) Jie Qi calendar with exact instants
- Biorhythm Physical, emotional, and intellectual cycle values.
- Directions (Vastu) Vastu dikpala and direction
- 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
- Birth Day Number (Numerology) Special talents from day of birth
- BaZi Annual Forecast (Chinese Astrology) Read one Gregorian year against a natal BaZi chart
- Daily Biorhythm Seeded reading for daily check-in features
- Bridge Numbers (Numerology) Harmonize different aspects of personality
- Zodiac Signs (Western Astrology) Complete zodiac signs list with dates and elements
- Daily Chinese Zodiac Reading (Chinese Astrology) Day pillar forecast by animal sign
- Lunar Calendar (Western Astrology) Moon phases for entire month
- 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)
- Number Sequence (Angel Numbers) Smart angel number analysis that works for ANY number sequence, not just known angel numbers
- Crystal by ID Crystal healing properties
- Personal Year (Numerology) Annual cycle and forecast for current year
- Aztec Day Sign (Mesoamerican Astrology) Tonalpohualli sign profile
- 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
- Numerology Life path, expression, and soul urge from a name and date.
- Daily Hexagram (I Ching) Receive a daily I-Ching hexagram for guidance and reflection
- Secondary Progressions (Western Astrology) progressed chart, progressed Sun and Moon
- Sookshma Dashas (Vedic Astrology) Returns the 9 Sookshma periods inside a chosen Pratyantardasha, the fourth and finest level of the Vimshottari dasha hierarchy
- Panchang Detailed Hindu calendar for any date and location: tithi, nakshatra, yoga, karana, rahu kaal, abhijit muhurta, brahma muhurta, and more.
- 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
- Angel Numbers Retrieve the complete database of angel numbers with summary information
- KP Planetary Positions (Vedic Astrology) Get planetary positions with detailed KP star-lord and sub-lord calculations for precise event timing and significator analysis
- Crystal Pairings Get crystals that pair well with a given crystal for enhanced healing combinations
- Random Crystal Get a randomly selected healing crystal as a discovery teaser
- Haab Periods (Mesoamerican Astrology) Maya solar calendar month
- Personal Month (Numerology) Monthly numerology forecast
- Daily Numerology Number Number of the Day with interpretation
- Solar Return Chart (Western Astrology) Annual birthday forecast with relocated chart
- Prana Dashas (Vedic Astrology) Prana dasha for Vedic astrology
- Monthly Parallels (Western Astrology) Declination contacts for an entire month
- Sephirah of the Day (Kabbalah) Omer count with the sephirot pairing
- Choghadiya (Vedic Astrology) 8 Muhurta divisions of day and night
- Monthly Transit (Vedic Astrology) Planetary sign changes for an entire month
- Symbol Counts by Letter (Dream Interpretation) Get the count of dream symbols available for each letter A-Z
- Aztec Trecena (Mesoamerican Astrology) Tonalpohualli period profile
- Zodiac Sign Details (Western Astrology) Complete astrology sign profile with personality traits
- Hora (Vedic Astrology) 24 Planetary Hours (12 day + 12 night)
- Life Path Life path number and core meaning from a birth date.
- Rashi by ID (Vedic Astrology) Vedic Zodiac Sign Detail
- Annual Profections (Western Astrology) lord of the year and yearly time lord by age
- Personality Number (Numerology) Calculate your Personality number from the consonants in your birth name using Pythagorean numerology
- Yearly Horoscope by Zodiac Sign (Western Astrology) Year ahead forecast with themes, key periods, eclipses and retrogrades
- Aztec Trecenas (Mesoamerican Astrology) Tonalpohualli thirteen day period
- Draw Tarot Cards Draw 1-78 tarot cards from the complete Rider-Waite-Smith deck with seeded reproducibility for consistent personalized readings
- Monthly Horoscope by Zodiac Sign (Western Astrology) Editorial column with key dates
- Weekly Horoscope by Zodiac Sign (Western Astrology) Seven-day editorial column
- Business Name Numerology Chaldean brand name analysis and lucky numbers
- 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
- Names (Kabbalah) Shem HaMephorash derived from the verses
- Natal Chart Western birth chart with planets, houses, and aspects.
- Planetary Positions (Western Astrology) Ephemeris calculator for all planets
- Monthly Lunar Aspects (Vedic Astrology) Moon aspect events with all planets for a month
- Compound Number Meaning (Numerology) Cheiro Chaldean interpretation 10 to 52
- Hexagram by Line Pattern (I Ching) Find an I-Ching hexagram by its binary line pattern
- Search Crystals Search for healing crystals by keyword or name
- Bagua Sector (Feng Shui) Look up one palace of the compass Bagua map by its life area id, such as wealth, career or love
- Basic Panchang (Vedic Astrology) Tithi Nakshatra Yoga Karana Calculator
- 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
- 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
- Planetary Yogas (Vedic Astrology) 301 entry Vedic Yoga Glossary
- Human Design Variables The four arrows and Color, Tone, Base substructure
- 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
- Sadhesati (Vedic Astrology) Sade Sati (Saturn Transit)
- 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
- Daily Dream Symbol Receive a single dream symbol for daily reflection and subconscious exploration
- Elements (Chinese Astrology) Wu Xing with generating and controlling cycles
- Crystals by Zodiac Crystals and stones associated with any zodiac sign, with properties, color, and chakra.
- Ashtakavarga (Vedic Astrology) Calculate complete Ashtakavarga analysis per Brihat Parashara Hora Shastra (BPHS)
- Arabic Lots (Western Astrology) seven Hermetic parts including Part of Fortune and Spirit
- 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`
- 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
- Dosha (Ayurveda) Vata pitta kapha profile
- KP Rasi Ingress Times (Vedic Astrology) Track when planets enter new zodiac signs (rasi) with precise ingress timestamps
- Dream Symbol by ID Get the complete dream interpretation for a specific symbol
- Monthly Ephemeris (Western Astrology) Daily tropical planetary positions for a month
- KP Chart Krishnamurti Paddhati chart with cusps, planets, sub-lords, and significators.
- 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
- KP-Newcomb Ayanamsa (Vedic Astrology) Dynamic daily calculation
- Planet Meaning Details (Western Astrology) Complete astrology planet interpretation
- Of the 72 Names (Kabbalah) 72 names of God by index
- Calculate Kua Number (Feng Shui) Feng shui personal direction
- Cast Daily Reading (I Ching) Cast a complete daily I-Ching reading using the traditional three-coin method with seeded randomness
- Birth Profile (Kabbalah) Hebrew birthday and birth angel
- Tree of Life (Kabbalah) sephirot and 22 paths with typed school variants
- Horoscope Daily, weekly, monthly, or yearly horoscope for any zodiac sign.
- Arudha Padas (Vedic Astrology) Calculate the Arudha Lagna (AL) and all twelve Arudha padas of Jaimini astrology from birth details
- 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
- Angel Number Meaning and pattern analysis for any number sequence.
- 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
- Search Dream Symbols Browse and search our complete dream interpretation dictionary containing 2,000+ dream symbols with psychological meanings
- Tarot Card Single card, three card, or Celtic Cross spreads.
- Divisional Chart (Varga) Calculate any Vedic divisional chart (Varga) from D2 Hora to D60 Shashtiamsa
- Annual Afflictions (Feng Shui) Tai Sui, San Sha and Five Yellow
- Search Cities Worldwide (Location) Geocoding autocomplete with coordinates and timezone
- Tarot Yes or No Single-card Yes / No / Maybe answer with strength rating and interpretation.
- Rashis (Vedic Astrology) Vedic Zodiac Signs Reference
- Karmic Lessons (Numerology) Life lessons from missing numbers
- Planetary Transits (Western Astrology) Current transits with natal chart comparison
- 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
- Crystal Colors List all unique crystal colors available in the database
- Crystals by Element Elemental crystal lookup
- Declination Parallels (Vedic Astrology) Planets at same or opposite declination
- Crystals Crystal healing database
- Daily Reading (Vedic Astrology) Composed Gochara, Panchanga and Dasha for one native on one day
- Relocation Chart (Western Astrology) Relocated birth chart calculator with shifted houses and angles
- 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
- Mayan Trecena (Mesoamerican Astrology) Thirteen day period profile
- 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
- House Cusps (Western Astrology) House system calculator with comparison
- Haab Period (Mesoamerican Astrology) Maya solar calendar month profile
- Personal Day (Numerology) Daily personalized numerology forecast
- Asteroid Goddesses (Western Astrology) Ceres, Pallas, Juno, and Vesta natal positions
- 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
- Auspicious Days (Chinese Astrology) Chinese date selection for weddings and openings
- Astrology Section Wrapper block that shares a default zodiac sign and birth date with every RoxyAPI block inside it via block context.
- Hebrew Letters (Kabbalah) Hebrew alphabet with the Sefer Yetzirah attributions
- Chinese Zodiac Animals (Chinese Astrology) Sheng Xiao sign catalogue
- KP Ruling Planets with Optional Significators (Vedic Astrology) Calculate the 5 ruling planets at any moment using Krishnamurti Paddhati horary astrology
- Hexagrams (I Ching) I-Ching hexagram catalog
- Current Mahadasha (Vedic Astrology) Calculate all five running Vimshottari Dasha levels with remaining time in each
- KP Placidus House Cusps (Vedic Astrology) Calculate unequal Placidus house cusps with ruling sign-lord, nakshatra-lord, and sub-lord for each cusp
- Tarot Cards Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards
- Chinese Zodiac Animal (Chinese Astrology) Full sign profile with compatibility partners
- Luck Pillars (Chinese Astrology) BaZi Da Yun ten-year cycle
- Local Space Astrology Map (Western Astrology) Directional planetary compass lines
- Soul Urge Number (Numerology) Inner motivations and desires
- Name Profile (Kabbalah) Kabbalah name numerology with the spelling shown
- Phase Info (Biorhythm) Lightweight cycle status for dashboards and widgets
- Ayurveda Seasonal Regimen Ritucharya and ritu resolution
- KP Ruling Planets with Significators (Vedic Astrology) Calculate ruling planets and their KP significators at regular time intervals using Krishnamurti Paddhati prashna (horary) astrology
- 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
- Astrocartography Map (Western Astrology) planetary lines and relocation calculator
- Lunar Return Chart (Western Astrology) Monthly emotional forecast with Moon cycle chart
- Gematria (Kabbalah) Hebrew gematria with every spelling shown
- Planet Meanings (Western Astrology) Complete astrology planet interpretations list
- Tastes (Ayurveda) Ayurveda rasa and dosha matrix
- Navamsa Chart (D9) Marriage Compatibility Calculator
- Monthly Transits (Western Astrology) Tropical sign ingresses for an entire month
- 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
- Daily Mayan Energy Reading (Mesoamerican Astrology) Tzolkin day sign of the day
- 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
- Sephirah (Kabbalah) sefirot meaning with the paths that touch it
- 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
- Three Card Spread (Tarot) Perform the classic three-card tarot spread revealing Past, Present, and Future
- 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
- Planetary Positions (Vedic Astrology) Get simplified planetary positions (graha positions) for all 9 planets (Sun through Ketu) plus Ascendant (Lagna)
- Countries (Location) ISO codes and city coverage
- 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
- 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
- Solar Arc Directions (Western Astrology) directed chart at one degree per year
- Daily Aztec Energy Reading (Mesoamerican Astrology) Tonalpohualli day sign of the day
- Random Dream Symbols Discover random dream symbols and their interpretations for daily dream insights and exploration
- Upagraha (Sub-planet) Positions (Vedic Astrology) Calculate all 11 Vedic upagraha (sub-planet) positions per Brihat Parashara Hora Shastra (BPHS)
- 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
- 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
- Cities in a Country (Location) Geocoding directory sorted by population
- Month of Almanac Days (Chinese Astrology) Chinese calendar month view
- Classical Vedic Yogas in a Birth Chart (Vedic Astrology) Chart-driven detection of 48 classical Vedic yogas
- Antardashas (Vedic Astrology) Returns the 9 Antardasha sub periods inside a chosen Mahadasha, each proportional to the Vimshottari years of its lord
- Dual Numerology Pythagorean and Chaldean name numbers in one call
- Love Spread, 5 Cards (Tarot) Relationship tarot reading
- Convert Lunar and Gregorian Dates (Chinese Astrology) Chinese lunisolar calendar
- Crystal Planets List all unique planetary associations available in the database
- Avastha States (Vedic Astrology) Planetary State Reference
- BaZi Chart (Chinese Astrology) Calculate a complete BaZi chart, the Four Pillars of Destiny, from a birth moment
- Planetary Return Chart (Western Astrology) Saturn return, Jupiter return, and inner planet cycles
- 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
- Mahadasha Periods (Vedic Astrology) Returns the complete Vimshottari dasha cycle from birth, all 9 Mahadasha periods across the full 120 year span
- Monthly Planetary Aspects (Vedic Astrology) Major and minor aspect events for a month
- KP Sublord Changes (Vedic Astrology) Track when planets cross KP sublord boundaries (1-249 divisions) for precise Krishnamurti Paddhati event timing
- 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
- Crystals by Chakra Get healing crystals and gemstones that resonate with a specific chakra energy center
- 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
- Random Hexagram (I Ching) Receive a random I-Ching hexagram with full interpretation
- Supported Response Languages Returns the language codes accepted by the `lang` query parameter on every i18n-aware endpoint
- Yoga Details by ID (Vedic Astrology) Vedic Yoga Glossary Entry
- Aztec Day Signs (Mesoamerican Astrology) Tonalpohualli sign catalogue
- 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
- Maturity Number (Numerology) Who you become in later life
- Daily Angel Number Get the angel number of the day with full meaning and interpretation
- Annual Flying Stars (Feng Shui) Yearly feng shui star chart
- Ecliptic Crossings (Western Astrology) Node passages for a whole year
- Bodygraph Human Design bodygraph with type, strategy, authority, profile, the nine centers, channels, and gates.
- Aspect Patterns (Western Astrology) Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium
- Vedic Kundli Vedic birth chart with twelve rashis, planetary positions, nakshatra, and per-house interpretations.
- Monthly Ephemeris (Vedic Astrology) Daily sidereal planetary positions for a month
- Transit Analysis (Vedic Astrology) Compare current planets to natal chart (Gochar)
- Daily Crystal Get the crystal of the day as a discovery teaser
- Planetary Aspects (Drishti) Mutual aspects between all planets
- Biorhythm Forecast Multi-day cycle predictions with best and worst days
- Kalsarpa Dosha (Vedic Astrology) Detect Kalsarpa dosha (Kalsarpa yoga) when all 7 planets are hemmed between Rahu-Ketu axis
- Fixed Stars and Star Conjunctions (Western Astrology) Regulus, Spica, Algol natal report
- 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
- Compare Two Names (Kabbalah) gematria name compatibility with every component published
- Ayadi Shadvarga (Vastu) Vastu proportion and yoni
- Chinese Zodiac Compatibility (Chinese Astrology) Trine, six harmony, clash and harm analysis
- Shadbala (Vedic Astrology) Calculate complete Shadbala (six-fold planetary strength) per Brihat Parashara Hora Shastra (BPHS) and BV Raman Graha and Bhava Balas
- Monthly Aspects (Western Astrology) Tropical aspect calendar for an entire month
- Dinacharya Daily Routine (Ayurveda) Brahma muhurta and dosha clock
- 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)
- Birthstones by Month (Crystals) Get the traditional birthstone crystals for a given birth month
- Nakshatras (Vedic Astrology) Lunar Mansions Reference
- Gematria Ciphers (Kabbalah) gematria methods with provenance on every row
- 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
- Trigrams (I Ching) Retrieve all 8 I-Ching trigrams (bagua), the fundamental building blocks of hexagrams
- 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
- Defined Human Design Channels Calculate the defined channels for a birth moment
- Moon Phase Current moon phase, illumination, sign, degree, and meaning.
- 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)
- Cast an I-Ching Reading Generate an authentic I-Ching reading using the traditional three-coin casting method
- Black Moon Lilith (Western Astrology) mean and true lunar apogee in the natal chart
- Chaldean Numerology Name Reading Destiny, compound number, planetary ruler
- Critical Days (Biorhythm) Zero crossing detection for any date range
- Karmic Debt Numbers (Numerology) Past life challenges (13, 14, 16, 19)
- Mayan Chart (Mesoamerican Astrology) Tzolkin, Haab and Long Count
- 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
- Monthly Flying Stars (Feng Shui) Month by month feng shui overlay
- Pratyantardashas (Vedic Astrology) Pratyantardasha for Vedic astrology
- Convert a Maya Long Count (Mesoamerican Astrology) Long Count calendar converter
- Planetary Aspects (Western Astrology) Aspect finder for any date and time
- Almanac for a Day (Chinese Astrology) Tong Shu with day officers and mansions
- Number Meaning (Numerology) Interpretation for any number 1-9, 11, 22, 33
- Upcoming Moon Phases (Western Astrology) Next new moon, full moon, quarters
- 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
- 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
Instalación
- 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, 2instead 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 theroxyapi_client_ipfilter 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
patternsremoves 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, orhide_sections="none"to keep a block on one page that the site setting hides everywhere else.hide_readings="1"andhide_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.
-
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.
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«RoxyAPI: Astrology, Vedic, Forecast, Human Design, Numerology» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
ColaboradoresTraduce «RoxyAPI: Astrology, Vedic, Forecast, Human Design, Numerology» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.17.0
- New: [roxy_forecast], a featured forecast timeline. Visitors enter their birth details and an optional date window, and the reading merges transits, sign ingresses, retrograde stations, eclipses, moon phases, Vimshottari dasha changes and biorhythm critical days into one timeline of up to 90 days.
- New: [roxy_bodygraph], a featured Human Design reading. Pass birth_date, birth_time, lat, lon and tz for a fixed bodygraph, or leave them off for a visitor form with city search. Type, strategy, authority, profile, centers, channels and gates on one chart, with the Design moment printed under the title.
- New: nine more featured readings as Gutenberg blocks: Vedic Kundli, Panchang, Mangal Dosha, KP Chart, Moon Phase, Bodygraph, Tarot Yes or No, Life Path and Crystals by Zodiac, each with sidebar inputs and a live preview in the editor.
- New: two Vedic matching readings. [roxy_calculate_dashakoot] scores the ten porutham South Indian match and [roxy_calculate_papasamyam] compares malefic affliction between two charts. Both render a two person visitor form.
- Improved: every wheel, map and compass spaces its labels by their measured width, so long sign and planet names no longer overlap on a phone screen.
- Improved: the bodygraph captions its side centers outside the triangles, tables and charts share one degree notation, and the biorhythm chart draws its bars above and below the axis.
- Improved: the KP planets table prints the pada beside each node, and a reading the dedicated card cannot draw falls back to the generic table instead of an empty card.
- Improved: three chart labels corrected on German, French and Portuguese sites.
- Improved: a sample copied from the Shortcodes library no longer carries a language attribute, so a pasted reading follows the site language. Featured readings in the library keep their catalogue order instead of sorting by name, and the Connect tab fits a phone screen.
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.
Older entries are in changelog.txt: https://github.com/RoxyAPI/sdk-wordpress/blob/main/changelog.txt
