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

RoxyAPI adds Astrology, Vedic, Forecast, Human Design and Numerology 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. 12+ domains. 171+ 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
• 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 12+ domains live under one key. Pick a plan at https://roxyapi.com/pricing.

Also built in:

• Gutenberg blocks and shortcodes for every reading, plus a visitor form mode for interactive inputs like birth details
• Pythagorean numerology, full 78 card tarot, and a 2,000+ entry dream symbol dictionary
• Interactive SVG charts and cards that follow your light or dark theme automatically
• Readings in 8 languages (English, German, Hindi, Spanish, Turkish, Portuguese, French, Russian) via one setting
• Parent Astrology Section wrapper block that shares the zodiac sign across all child blocks via block context
• Server side caching with per endpoint TTL to keep your API quota low
• API key stays server side. Never exposed to the browser.

About the service this plugin connects to

This plugin is a thin WordPress interface to RoxyAPI, a third-party paid service operated at https://roxyapi.com. The astrology, tarot, numerology, and other calculations all run on RoxyAPI servers. A small free daily allowance lets the plugin display readings without an account; a RoxyAPI API key is required for production use and removes the daily limit. Pricing and plan tiers are listed at https://roxyapi.com/pricing. Terms of Service: https://roxyapi.com/policy/terms. Privacy Policy: https://roxyapi.com/policy/privacy.

The plugin itself is GPLv2 or later and the source is available at https://github.com/RoxyAPI/sdk-wordpress.

Shortcode examples

Every reading is a shortcode. Pass attributes for a fixed reading the site owner controls, or drop the shortcode with no attributes to render an accessible visitor form. Heroes that take two charts or nested birth details are form mode only.

Hero shortcodes

The three two chart compatibility heroes render a visitor form for both people and take no attributes:

Leave the attributes off any hero shortcode to render a form instead. For example [roxy_horoscope] shows a zodiac sign picker and [roxy_natal_chart] shows a birth date, time, and city picker.

Long-tail shortcodes

A matching shortcode exists for every endpoint in the spec. A sample across the domains:

• Western astrology: [roxy_calculate_aspects date="1990-07-15" time="14:30:00" timezone="UTC"] and [roxy_get_weekly_horoscope sign="aries"]
• Vedic astrology: [roxy_get_hora date="2026-02-03" latitude="17.385044" longitude="78.486671" timezone="UTC"] and [roxy_calculate_drishti date="2026-02-03" time="12:00:00" latitude="17.385044" longitude="78.486671" timezone="UTC"]
• Tarot: [roxy_cast_celtic_cross question="What should I know about this path"]
• Numerology: [roxy_calculate_expression full_name="Ada Lovelace"]
• Human Design: [roxy_generate_bodygraph date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"], [roxy_calculate_variables date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"], plus the two chart [roxy_calculate_connection] and [roxy_calculate_penta] which render visitor forms and take no attributes
• Forecast: [roxy_generate_digest] (renders a visitor form, no attributes)
• I Ching: [roxy_get_daily_hexagram]
• Crystals: [roxy_get_crystal id="amethyst"]
• Dreams: [roxy_search_dream_symbols q="water"]
• Location: [roxy_search_cities q="berlin"]

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.

External Services

This plugin connects to a third-party service (RoxyAPI) to calculate every reading it displays. Without it the plugin has nothing to show, so this is not optional.

• Service: RoxyAPI (https://roxyapi.com)
• Service operator: RoxyAPI
• Terms of Service: https://roxyapi.com/policy/terms
• Privacy Policy: https://roxyapi.com/policy/privacy
• Pricing: https://roxyapi.com/pricing

When does the plugin contact RoxyAPI? A request is sent when, and only when, a RoxyAPI reading is rendered or you explicitly ask for one:

• A page, post or widget containing a RoxyAPI block or shortcode is rendered, on the front end or in the editor preview. Readings render with or without an API key, so these requests also happen before you connect one.
• A visitor submits a RoxyAPI reading form.
• You click Test Connection on the settings screen, or type in the city search field.

Installing and activating the plugin, and then placing a reading on your site, is the consent for these calls. The plugin does NOT contact RoxyAPI on activation, on deactivation, on update, on a schedule, or on admin screens that do not render a reading. A reading that has not been configured yet sends nothing at all, and responses are cached so a repeat view of the same reading does not repeat the request.

What data is sent? The reading parameters you supply via the block or shortcode (zodiac sign, birth date, name, location coordinates, question text), your site URL, and a plugin name and version identifier. Your server outbound IP is incidentally captured by RoxyAPI, like any HTTP request. No site visitor data is collected by the plugin itself.

Where is the API key stored? Either as the ROXYAPI_KEY constant in your wp-config.php (recommended) or AES-256-CTR encrypted in the wp_options table under roxyapi_settings. The plain key is never sent to the browser at any time.

What does RoxyAPI do with the data? See https://roxyapi.com/policy/privacy.