Skip to content
RoxyAPI
Get API Key

The Spiritual OS layer for agentic AI.

One astrology API key for all 18+ insight domains, from Western and Vedic astrology to forecast and human design: verified data your app and your agents build on, over REST or Remote MCP.

AstrologyVedicForecastHuman DesignChinese AstrologyFeng ShuiMesoamericanVastuNumerologyKabbalahTarotBiorhythmAyurvedaI-ChingCrystalsDreamsAngel NumbersLocation
Get API KeyExplore all domains

18+ insight domains, each one deep. One flat price per request.

RoxyAPI is the data infrastructure for insight products. Every domain is built to the depth of a specialist API, and one request is one unit on every endpoint, never a weighted credit table that prices each call differently.

Western Astrology API

Birth charts checked cusp by cusp, and horoscopes that name the dated sky events behind each reading.

Natal Chart · Horoscope · Synastry and 24 more

Popular
Explore

Vedic Astrology API

Kundli, panchang and KP charts that state the ayanamsa they used and the classical rule behind each verdict.

Kundli · Panchang · Choghadiya and 31 more

Advanced
Explore

Forecast API

An astrology forecast that merges transits, dasha changes and biorhythm critical days into one timeline ranked by significance.

Astrology Transit Forecast · Transit Timeline · Significant Astrology Dates and 2 more

Explore

Human Design API

A Human Design bodygraph, type and authority from a Design moment solved on the true 88 degree solar arc and printed with the chart.

Bodygraph · Human Design Type · Human Design Authority and 8 more

Explore

Chinese Astrology API

A BaZi Four Pillars chart and Chinese zodiac sign that tell you which school they came from.

BaZi · Four Pillars · Luck Pillars and 11 more

Explore

Feng Shui API

Flying star charts and Kua numbers that are actually checkable.

Kua Number · Eight Mansions · Flying Star and 5 more

Explore

Mesoamerican Astrology API

A Mayan Tzolkin day sign that tells you which correlation it came from.

Tzolkin · Mayan Astrology · Long Count Calendar and 4 more

Explore

Vastu Shastra API

Vastu Shastra entrance, plot and room verdicts that cite their verse, or say plainly they are convention.

Vastu Entrance · Vastu Purusha Mandala · Vastu Plot Analysis and 4 more

Explore

Numerology API

Life Path, Destiny and Chaldean numerology that shows every step, checked against the authors who defined it.

Life Path · Numerology Chart · Numerology Compatibility and 14 more

Explore

Kabbalah API

Gematria for any name, with the Hebrew spelling behind the number shown.

Gematria · Hebrew Birthday · Kabbalah Birth Angel and 6 more

Explore

Tarot Reading API

Tarot readings a user can share and reopen unchanged, every card read upright and reversed for love, career and health.

Daily Tarot Card · Tarot Card Draw · Three Card Spread and 6 more

Popular
Explore

Biorhythm API

Biorhythm cycles past the classic three, with critical days graded by how many cycles cross at once.

Biorhythm Cycles · Daily Biorhythm · Biorhythm Forecast and 3 more

Explore

Ayurveda API

Ayurvedic dosha type, dinacharya and ritucharya with a verse cited on every value, not another dosha quiz.

Ayurvedic Constitution · Dosha Type · Dinacharya and 5 more

Explore

I-Ching Oracle API

An I Ching reading that interprets every changing line, not just the hexagram it lands on.

Daily Hexagram · I Ching Reading · Hexagram and 1 more

Exclusive
Explore

Crystals and Healing Stones API

Healing crystals and birthstones you can filter by zodiac sign, chakra and element, each with the stones it pairs with.

Crystals by Zodiac · Crystals by Chakra · Birthstone and 5 more

Exclusive
Explore

Dream Interpretation API

Dream interpretation from a dictionary of psychological meanings, searchable by symbol or by what happened in the dream.

Dream Symbol · Dream Dictionary · Daily Dream Symbol

Exclusive
Explore

Angel Numbers API

Angel number meanings for love, money, career and twin flames, and any other number still gets a reading.

Angel Number Meaning · Angel Number Lookup · Daily Angel Number

Exclusive
Explore

Location and Timezone API

City search that resolves a birthplace to coordinates and its timezone, even a small town or a city under its former name.

City Search · Geocoding · Timezone and 1 more

Explore
Explore All Domains

Depth

261+ endpoints

Vedic to KP and shadbala, Western to progressions, returns and astrocartography.

Verified

3,620+ gold-standard tests

Read from the NASA JPL DE440 ephemeris, checked against NASA JPL Horizons.

Built in

10+ languages

Remote MCP, typed SDKs, UI components, widgets and templates on one key.

More than astrology. The insight data layer.

RoxyAPI covers Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location. 18+ genuinely distinct domains, not sub-features or output formats, under one API key and one flat plan, with a complete result in one call. It is the data layer behind spiritual wellness and self-discovery apps, from a daily horoscope feature to a full reading experience.

The suite is more than endpoints: per-domain Remote MCP servers, typed SDKs, drop-in UI components, free MIT licensed templates, and a WordPress plugin ship with every plan. Your AI grounds each reading in calculations verified against NASA JPL Horizons and answers in your product voice.

Remote MCPTyped SDKsDrop-in UIEmbed WidgetsMIT TemplatesWordPress PluginNASA JPL verified
18+

domains
one key

One call. Real data.

Every endpoint returns structured JSON with documented fields, not hallucinated text. Verified calculations you can trust in production.

  • Open MIT-licensed benchmark, validated against NASA JPL Horizons

  • Complete results. Numerology charts, tarot readings, and dream interpretations arrive as structured JSON.

  • 261+ endpoints. Every field has descriptions and examples.

  • Editorial interpretations in 10+ languages. Ship readings without writing them, or layer on your own voice.

Explore API Reference
POST /api/v2/astrology/natal-chart
{
  "birthDetails": {
    "date": "1990-07-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -4,
    "nodeType": "true"
  },
  "planets": [
    {
      "name": "Sun",
      "longitude": 113.00452053215861,
      "latitude": 0.0001759667946626438,
      "sign": "Cancer",
      "degree": 23.004520532158608,
      "speed": 0.9539943976308223,
      "isRetrograde": false,
      "house": 9,
      "dignity": "peregrine",
      "interpretation": {
        "summary": "Your Sun in Cancer in The Ninth House reveals how you express self-awareness and ego with intuitive and nurturing energy in the realm of exploration.",
        "detailed": "Sun represents self-awareness and ego. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Ninth House, you direct this Cancer Sun energy toward exploration and religious beliefs and personal philosophy. This creates a unique expression where your self-awareness and ego naturally manifests through intuitive, nurturing, protective approaches in matters related to the ninth house.",
        "keywords": [
          "active",
          "awareness"
        ]
      }
    },
    {
      "name": "Moon",
      "longitude": 27.068938674158613,
      "latitude": 5.181805332627993,
      "sign": "Aries",
      "degree": 27.068938674158613,
      "speed": 14.10478254438371,
      "isRetrograde": false,
      "house": 6,
      "dignity": "peregrine",
      "interpretation": {
        "summary": "Your Moon in Aries in The Sixth House reveals how you express inner emotional life with ambitious and independent energy in the realm of work and job.",
        "detailed": "Moon represents inner emotional life. In Aries (Ram), this energy becomes ambitious, independent, impatient. Located in The Sixth House, you direct this Aries Moon energy toward work and job and techniques and methods. This creates a unique expression where your inner emotional life naturally manifests through ambitious, independent, impatient approaches in matters related to the sixth house.",
        "keywords": [
          "caretaker",
          "comfort"
        ]
      }
    }
  ],
  "houses": [
    {
      "number": 1,
      "longitude": 216.9473683504864,
      "sign": "Scorpio",
      "degree": 6.947368350486414
    },
    {
      "number": 2,
      "longitude": 245.7049079943925,
      "sign": "Sagittarius",
      "degree": 5.704907994392499
    }
  ],
  "houseSystem": "placidus",
  "aspects": [
    {
      "planet1": "North Node",
      "planet2": "South Node",
      "type": "OPPOSITION",
      "angle": 180,
      "orb": 0,
      "isApplying": false,
      "strength": 100,
      "interpretation": "challenging",
      "aspectInterpretation": {
        "summary": "Your North Node forms a very strong opposition (180) with South Node, currently separating (weakening). This challenging aspect highlights themes of accept, accepting, and balance.",
        "keywords": [
          "accept",
          "accepting"
        ]
      }
    },
    {
      "planet1": "Mercury",
      "planet2": "North Node",
      "type": "OPPOSITION",
      "angle": 180,
      "orb": 0.07826851524703216,
      "isApplying": true,
      "strength": 99.0216435594121,
      "interpretation": "challenging",
      "aspectInterpretation": {
        "summary": "Your Mercury forms a very strong opposition (180) with North Node, currently applying (strengthening). This challenging aspect highlights themes of accept, accepting, and balance.",
        "keywords": [
          "accept",
          "accepting"
        ]
      }
    }
  ],
  "ascendant": {
    "longitude": 216.9473683504864,
    "sign": "Scorpio",
    "degree": 6.947368350486414
  },
  "midheaven": {
    "longitude": 134.3754606676387,
    "sign": "Leo",
    "degree": 14.375460667638691
  },
  "partOfFortune": {
    "sign": "Leo",
    "degree": 11.011786492486408,
    "longitude": 131.0117864924864,
    "sect": "day",
    "house": 9
  },
  "vertex": {
    "longitude": 77.23544691076316,
    "sign": "Gemini",
    "degree": 17.23544691076316,
    "house": 8
  },
  "patterns": [
    {
      "kind": "T_SQUARE",
      "name": "T-Square",
      "planets": [
        "Moon",
        "Sun"
      ],
      "apex": "Moon",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 62,
      "interpretationKey": "aspectPattern.tSquare",
      "interpretationVars": {
        "apex": "Moon",
        "apexSign": "Aries",
        "end1": "Sun",
        "end2": "Saturn"
      },
      "interpretation": "T-Square focused on Moon in Aries, tension between Sun and Saturn demands resolution at the apex, the primary growth engine of the chart."
    },
    {
      "kind": "T_SQUARE",
      "name": "T-Square",
      "planets": [
        "Moon",
        "Jupiter"
      ],
      "apex": "Moon",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 62,
      "interpretationKey": "aspectPattern.tSquare",
      "interpretationVars": {
        "apex": "Moon",
        "apexSign": "Aries",
        "end1": "Jupiter",
        "end2": "Saturn"
      },
      "interpretation": "T-Square focused on Moon in Aries, tension between Jupiter and Saturn demands resolution at the apex, the primary growth engine of the chart."
    }
  ],
  "aspectsInterpretation": {
    "summary": "Your chart contains 33 aspects: 7 harmonious, 17 challenging, and 9 neutral. The balanced mix of aspects suggests a well-rounded chart with both natural talents and growth opportunities.",
    "dominant": "balanced",
    "harmonious": 7,
    "challenging": 17,
    "neutral": 9
  },
  "summary": {
    "dominantElement": "Earth",
    "dominantModality": "Cardinal",
    "retrogradePlanets": [
      "Saturn",
      "Uranus"
    ],
    "elementDistribution": {
      "Fire": 2,
      "Earth": 4,
      "Air": 1,
      "Water": 3
    },
    "modalityDistribution": {
      "Cardinal": 6,
      "Fixed": 3,
      "Mutable": 1
    }
  }
}
Western Astrology API

Production-ready. Clone a template or build with AI prompts.

Drop in the UI. Ship the whole screen.

The complete UI layer for the spiritual stack, not astrology alone: natal wheels, kundli and dasha timelines, human design bodygraphs, tarot spreads, numerology grids, biorhythm curves, I Ching hexagrams, every one drawn straight from the API response. Install the npm package and drop them into Next.js, React, Vue, Svelte, or Angular, or embed any of them on Squarespace, Wix, or WordPress with a single snippet and no backend. MIT licensed, themeable with CSS variables, and included in every plan at no extra cost. The calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key: end to end for spiritual products and AI companions alike.

MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Natal chart widget snippet
Natal chart: Natal chart wheel with planet glyphs and aspect linesNatal chart: Natal chart wheel with planet glyphs and aspect lines
Vedic kundli widget snippet
Vedic kundli: South, North, or East Indian kundli with degree detail and optional Chandra Lagna viewVedic kundli: South, North, or East Indian kundli with degree detail and optional Chandra Lagna view
KP chart widget snippet
KP chart: Ascendant, cusps, planets and nodes with KP stellar hierarchy and house meaningsKP chart: Ascendant, cusps, planets and nodes with KP stellar hierarchy and house meanings
Forecast timeline widget snippet
Forecast timeline: Date-grouped events across Western, Vedic, and biorhythm domains, weighted by significanceForecast timeline: Date-grouped events across Western, Vedic, and biorhythm domains, weighted by significance
Bodygraph widget snippet
Bodygraph: Nine-center chart with defined and open centers, active channels, and gates, plus the type, strategy, authority, profile, and definition readings, the channels by circuit, the centers, and every activation with its gate and line meaningBodygraph: Nine-center chart with defined and open centers, active channels, and gates, plus the type, strategy, authority, profile, and definition readings, the channels by circuit, the centers, and every activation with its gate and line meaning
Bazi chart widget snippet
Bazi chart: Year, month, day and hour pillars in hanzi with hidden stems, Ten Gods, Na Yin, element balance and interactionsBazi chart: Year, month, day and hour pillars in hanzi with hidden stems, Ten Gods, Na Yin, element balance and interactions
Flying star chart widget snippet
Flying star chart: Nine-palace flying star plate with the mountain, period and water star per palace, the facing and sitting mountains and the structureFlying star chart: Nine-palace flying star plate with the mountain, period and water star per palace, the facing and sitting mountains and the structure
Mayan day sign widget snippet
Mayan day sign: Day sign and coefficient with the trecena, the reading, and the Calendar Round on the fuller responseMayan day sign: Day sign and coefficient with the trecena, the reading, and the Calendar Round on the fuller response
Vastu mandala widget snippet
Vastu mandala: Pada grid with a devata per square, the brahmasthan, and the entrance pada lit with its effectVastu mandala: Pada grid with a devata per square, the brahmasthan, and the entrance pada lit with its effect
Numerology card widget snippet
Numerology card: Life path, expression, soul urge, personality, personal year, full chartNumerology card: Life path, expression, soul urge, personality, personal year, full chart
Gematria widget snippet
Gematria: Values by cipher, every candidate Hebrew spelling with its per letter breakdown, and equal-value wordsGematria: Values by cipher, every candidate Hebrew spelling with its per letter breakdown, and equal-value words
Tarot card widget snippet
Tarot card: Single card with upright and reversed flipTarot card: Single card with upright and reversed flip
Biorhythm chart widget snippet
Biorhythm chart: Daily bars, forecast cycle lines, critical daysBiorhythm chart: Daily bars, forecast cycle lines, critical days
Dosha constitution widget snippet
Dosha constitution: Vata, pitta and kapha shares as one bar with the dominant humour and the cited factors behind itDosha constitution: Vata, pitta and kapha shares as one bar with the dominant humour and the cited factors behind it
Hexagram widget snippet
Hexagram: Hexagram figure with trigrams, judgment, image, and a reading per line (statement plus meaning); a cast highlights the moving lines and the resulting hexagramHexagram: Hexagram figure with trigrams, judgment, image, and a reading per line (statement plus meaning); a cast highlights the moving lines and the resulting hexagram
Crystal card widget snippet
Crystal card: Photo, meaning sections, chakra, zodiac, element, hardness, keywords, and pairingsCrystal card: Photo, meaning sections, chakra, zodiac, element, hardness, keywords, and pairings
Dream card widget snippet
Dream card: Symbol name, interpretation body, and letter chipDream card: Symbol name, interpretation body, and letter chip
Angel number card widget snippet
Angel number card: Number meaning with spiritual, love, career, money, twin flame, biblical, and shadow sectionsAngel number card: Number meaning with spiritual, love, career, money, twin flame, biblical, and shadow sections
Show all UI componentsShow fewer UI components
ElementRenders
<roxy-natal-chart>Natal chart wheel with planet glyphs and aspect lines
<roxy-vedic-kundli>South, North, or East Indian kundli with degree detail and optional Chandra Lagna view
<roxy-kp-chart>Ascendant, cusps, planets and nodes with KP stellar hierarchy and house meanings
<roxy-forecast-timeline>Date-grouped events across Western, Vedic, and biorhythm domains, weighted by significance
<roxy-bodygraph>Nine-center chart with defined and open centers, active channels, and gates, plus the type, strategy, authority, profile, and definition readings, the channels by circuit, the centers, and every activation with its gate and line meaning
<roxy-bazi-chart>Year, month, day and hour pillars in hanzi with hidden stems, Ten Gods, Na Yin, element balance and interactions
<roxy-flying-star-chart>Nine-palace flying star plate with the mountain, period and water star per palace, the facing and sitting mountains and the structure
<roxy-mayan-day-sign>Day sign and coefficient with the trecena, the reading, and the Calendar Round on the fuller response
<roxy-vastu-mandala>Pada grid with a devata per square, the brahmasthan, and the entrance pada lit with its effect
<roxy-numerology-card>Life path, expression, soul urge, personality, personal year, full chart
<roxy-gematria>Values by cipher, every candidate Hebrew spelling with its per letter breakdown, and equal-value words
<roxy-tarot-card>Single card with upright and reversed flip
<roxy-biorhythm-chart>Daily bars, forecast cycle lines, critical days
<roxy-dosha-constitution>Vata, pitta and kapha shares as one bar with the dominant humour and the cited factors behind it
<roxy-hexagram>Hexagram figure with trigrams, judgment, image, and a reading per line (statement plus meaning); a cast highlights the moving lines and the resulting hexagram
<roxy-crystal-card>Photo, meaning sections, chakra, zodiac, element, hardness, keywords, and pairings
<roxy-dream-card>Symbol name, interpretation body, and letter chip
<roxy-angel-number-card>Number meaning with spiritual, love, career, money, twin flame, biblical, and shadow sections
Explore Roxy UICopy-paste widgetsSetup guide

Component preview

The real component, running on sample data.

Loading the component...

One platform or many vendors. What makes Roxy different.

RoxyAPI is the data layer for insight products: 18+ domains, one key, 3,620 public gold-standard tests, and a remote MCP server per product your AI agent finds on its own. Here is the full picture against legacy astrology APIs and building it yourself.

CapabilityRoxyAPILegacy astrology APIsDIY open source libraries
Platform
Count domains as distinct systems, not as features of one. Horoscopes, natal charts, synastry and compatibility are all astrology and count once here, so an honest total can read smaller than a padded one, and a high endpoint count usually means one result split across separately billed calls.
One key, 18 domainsAstrology, vedic astrology, forecast, human design, numerology, tarot, and more behind a single subscription and a single API key.
Yes
Per product
One library each
Flat request pricing1 request equals 1 unit, REST or MCP, with no credit weighting and no premium endpoint surcharges. Credit-metered providers bill a different unit: on one such published table a single birth chart draws 50 credits, so divide their allowance by the per call weight before comparing it with a RoxyAPI request quota.
Yes
Credit tables
Self hosted
One call, complete resultA natal chart or kundli returns whole in one response instead of splitting into many separately billed calls.
Yes
Split calls
Assembly required
New domains at no extra costEvery new domain lands inside the existing plan automatically.
Yes
New invoice
New build
Simple surface, advanced core
One request returns a complete result, so the advanced layer lives inside the engine instead of inside your integration. RoxyAPI is built by a small, independent team of senior engineers, each with over 20 years building consumer and lifestyle products at scale, including at some of the biggest names in the industry.
Western astrology past the natal chartFixed stars, asteroid goddesses, Arabic lots, Black Moon Lilith, aspect pattern detection, secondary progressions, solar arc directions, annual profections, astrocartography, relocation charts, local space, and the solar, lunar and planetary return charts.
Advanced layer
Natal and transits
Raw positions
Classical Vedic with the reasoning attachedA yoga verdict carries the classical evidence that triggered it and the precedence rule that silenced it, so an agent can explain a judgement instead of restating a label. Shadbala, bhava bala, ashtakavarga, Arudha padas, Chara Karakas, three avastha systems, and KP sub-lords ship alongside it.
48 verdicts, with evidence
Yoga names
Positions only
Human Design past type and authorityVariables with Color, Tone and Base, the advanced Primary Health System layer, plus Penta for small groups, two-person connection charts, and transit overlays on a natal bodygraph.
Variables and Penta
Type and profile
No engine to fork
Domains that compose, not just coexistHuman Design is computed FROM the western ephemeris and the I Ching hexagrams rather than bolted on as a separate product line, so every gate activation carries its hexagram, and one forecast request merges western transit events with Vimshottari dasha boundaries and biorhythm critical days into a single time ordered feed. The sidereal and tropical engines are tested to return the same sky at zero tolerance.
One shared engine
Separate products
You merge it
AI agent readiness
Remote MCP server per domainHosted Streamable HTTP servers your agent connects to directly, no local processes, no Docker, no self hosting.
Yes
Varies
Build your own
Token-optimized responsesOpt-in compact mode cuts LLM tokens per response by 40 to 52 percent on detailed charts. Same data, lower agent inference cost, one request.
Yes
Not offered
Not offered
Agents integrate on their ownPoint an AI agent at roxyapi.com and it discovers every capability, the auth model, and the docs without a human in the loop.
Yes
Human setup
Human setup
Bring your own LLMGrounded calculations for any model you run, with no per-token markup in the middle. The MIT licensed Templates, including the AI astrology chatbot, are yours to white label and build on, so the model, the system prompt, and the product stay yours.
Your voice
Markups, locked prompt
Yes
Verification
Every claim in this section is checkable by you rather than asserted by us: the benchmark is MIT licensed and runnable against any provider, the methodology publishes the reference source for every domain and its tolerances, the playground returns real production responses with no signup, and uptime is reported by a third party we cannot edit.
Edge cases found by simulation, not by your usersBoundary births run as tests on every deploy, domain by domain, among them the hour a daylight saving change skips, midnight on a solar clock for a BaZi day pillar, a Human Design node under two arcseconds past a gate line, a birth at the South Pole in the first second of 2000, and both ends of the 1550 to 2650 ephemeris span.
Pinned in tests
Found in production
Yours to find
Maturity you can check, not years you take on trustEngine work since 2020 and production since 2024, shown as tests that pass on every deploy and a benchmark you rerun rather than as years in business or self-reported traffic.
Rerunnable proof
Years, self-reported
Upstream history
13,405 automated tests per deploy3,620 of them are gold-standard tests pinned to a named external reference in every calculated domain, from NASA JPL Horizons for positions to the printed classical texts for rule-based systems.
Published
Not published
Varies
Open MIT benchmark17 domains re-checked against named authorities in runnable Python, planets within 0.32 arcseconds (0.00009 degrees) of NASA JPL Horizons. Point it at any provider.
Runnable
No public artifact
Run it yourself
Published methodologyTest corpus, tolerances, and reference sources documented in public.
Yes
Asserted only
Varies
Proof before you payThe live playground returns real production responses, not fake sandbox data locked behind a signup. Audit accuracy and response shape first.
No signup
Signup or sandbox
Install first
Independent uptime pageUptime is monitored by UptimeRobot, an independently run third party we cannot edit, showing 100% RoxyAPI uptime over the last six months; the SLA still promises 99.95% for the rare cases.
100% last six months
Self reported
Yours to run
Developer experience
Live typed OpenAPI specEvery operation ships typed request and response schemas, drift-guarded in CI. Try real production responses before paying.
Yes
Docs or exports
Read the source
Typed SDKs in 5 languagesTypeScript, Python, PHP, C#, and Go, each bundling AGENTS.md so coding agents stop hallucinating endpoint names.
Yes
Fewer languages
No
Drop-in UI components@roxyapi/ui renders natal wheels, kundli, dasha timelines, tarot spreads, and more straight from the JSON, or straight from an MCP tool result inside your own AI chat (generative UI). MIT licensed, framework agnostic.
Yes
No
No
Embeddable widgetsCopy-paste snippets with browser-safe pk_ publishable keys and origin allowlists. Works on Squarespace, Wix, Shopify, or any HTML block.
Yes
No
No
White-label MIT TemplatesOpen source apps you can clone, brand, and ship as your own product.
Yes
No
Varies
Editorial-grade interpretations in 10+ languagesComplete interpretation text ready to publish on blogs, brand sites, and publisher homepages, localized from one lang query parameter and included in every plan. RoxyAPI localizes the whole reading, where others translate only field labels or a daily horoscope.
Publish ready
Horoscopes mostly
Numbers only
Usage dashboard and quota alertsThe account dashboard shows requests, quota used, average response time, and REST against MCP by domain, with a filterable request log. Email alerts fire automatically at 80 and 100 percent of the monthly quota, on every plan.
Yes
Varies
You build it
Licensing and privacy
The AGPL exposure most teams carry was never a decision: a package manager hands you the free path, so a team installs a Swiss Ephemeris wrapper, ships a network service, and inherits copyleft without reading it. That licence is a private contract with no public registry, so ask any provider for their position in writing.
Own engine, not a Swiss Ephemeris wrapperRoxy Ephemeris is built in house and reads the NASA JPL DE440 ephemeris directly, verified against NASA JPL Horizons. Legacy engines wrap Swiss Ephemeris, a desktop-era calculation library under the AGPL copyleft unless commercially licensed, and a buyer cannot verify from outside which version or licence a provider runs, so ask for the position in writing.
Roxy Ephemeris
Swiss based, licence unverifiable
Swiss based, AGPL unless licensed
No AGPL exposureThe AGPL on Swiss Ephemeris reaches network services, so products built on unlicensed wrappers inherit the obligation whether they know it or not. Google bans AGPL dependencies outright.
None
Inherited from Swiss
AGPL common
Commercial license on every planBuild and sell closed source apps, keep your code private, ship to any app store, white label for clients, and pass the license audits that funding rounds and acquisitions run. No source disclosure.
Yes
Varies
Copyleft terms
Stateless calculations, your own user profilesAPI request bodies are never persisted. Responses derived from submitted data may be cached for up to 24 hours; Cache-Control: no-store bypasses the cache. Usage metadata retention is in /policy/privacy. Your application keeps user profiles and memory.
Yes
Accounts and logs
Self hosted
EU data residency with an Article 28 DPA on every planStored data stays in Germany, inside the EU, on every plan and for every customer, so an EU buyer gets EU residency by default instead of paying for a regional tier. The processor contract, EU Standard Contractual Clauses, security measures, dated subprocessor register, and breach notification terms are all published, so procurement can review them without contacting us.
Germany, all plans
Enterprise or on request
Yours to write

Honest footnote: if you need exactly one domain, run your own servers, and are comfortable with copyleft licensing, a free open source library is the cheaper choice. Everything else on this table is where RoxyAPI earns its keep.

Your product on top. One verified layer underneath.

A vendor that runs the model inside its own endpoint keeps your system prompt, your model choice, your user memory and your margin. RoxyAPI takes none of them: it is the calculation layer your product and agents build on.

Yours, and stays yours

Your product and agents

Apps, AI agents, model choice, user memory, personalization, and margin.

RoxyAPI is stateless by design and stores no end user data, so the layer that compounds stays in your stack.

One key, one flat plan

RoxyAPI, the Spiritual OS layer for agentic AI
  • Typed API
  • Remote MCP
  • Typed SDKs
  • UI components
  • Embed widgets
  • Templates
  • Multilingual i18n

Every surface included, across all 18+ insight domains, under one flat subscription.

The verified foundation

Roxy Ephemeris

Verified against NASA JPL Horizons. No AGPL restrictions.

13,405 automated tests on every deploy, 3,620 of them gold standard against named external references.

RoxyAPI is the Spiritual OS layer for agentic AI: your product and agents build on 18+ verified insight domains behind one API key, while user data, memory, personalization and margin stay in your stack. The free MIT AI Spiritual Companion template ships that memory layer ready to white label.

Everything you need to build and ship.

Production APIs, hosted agent surfaces, typed SDKs, drop-in UI, embeddable widgets, and white label Templates. Every entry below links to the real thing, not a promise.

Engineered since 2020. In production since 2024.

RoxyAPI is not a weekend wrapper. The engine predates the platform by 4 years, and every scale figure below is dated, rounded down, and published on the transparency report.

  1. 2020

    Roxy Ephemeris groundwork begins

    4 years of in-house engine work before launch, built for APIs and agents from the start.

  2. 2024

    Platform launch

    RoxyAPI opens to the public.

  3. March 2025

    1 million API requests served

    Cumulative production requests cross the 1M milestone.

  4. March 2026

    10M+ API requests per quarter

    Production traffic reaches a ten million request per quarter run rate.

  5. July 2026

    Accuracy re-verified against NASA JPL

    Engine update takes the median deviation from NASA JPL Horizons to 0.05 arcseconds (0.00001 degrees), measured by the open benchmark anyone can re-run.

  6. September 2026

    4.5M+ API requests per month

    Production traffic reaches a monthly run rate of 4.5M+ requests, 1.5M+ of them from AI agents.

  7. Today

    13,405 tests on every deploy

    261 endpoints across 18 domains. Planetary positions are verified against NASA JPL Horizons; derived calculations are checked against the reference named for each domain.

Transparency reportPublic changelogIndependent status pageRun the benchmark

Built for AI agents

Your agent decides which domain each question needs (a transit, a tarot pull, a life path number) and calls it mid-conversation. Every domain sits behind one key and one Remote MCP surface, so 261+ tools auto-discover with zero configuration and adding a domain means no new vendor, auth, or bill.

Your AI agent

your model, your voice

Remote MCP

auto-discovered, no local setup

Token-optimized

Roxy Ephemeris

13,405 tests, 3620 gold standard

Verified result

18 domains, one flat rate

Your agent uses calculated charts and readings in its replies, with your model and your own voice. Planetary positions are verified against NASA JPL Horizons. No local setup, no AGPL, no hosted-AI markup.

Token-optimized responses

Roxy MCP can hand your agent the same complete data in a compact, lossless shape that sends each field name once instead of once per row, cutting the tokens it spends reading a result by roughly 40 to 52 percent. Lower inference cost, and your quota is unchanged: one tool call is still one request.

Remote MCP servers

AI agents auto-discover all endpoints as callable tools. No manual tool definitions. No endpoint wiring.

Claude DesktopCursorWindsurfVS CodeOpenAI AgentsGemini

Real calculations, not AI slop

Your chatbot answers with computed planetary positions, not hallucinated readings. Every number is calculated by Roxy Ephemeris and verified against NASA JPL Horizons, with a public MIT-licensed benchmark anyone can re-run.

Docs your AI tools can read

Machine-readable API documentation at /llms.txt. Give it to your coding agent or chatbot and it knows every RoxyAPI capability without a manual.

AGENTS.md execution playbook

Tight imperative playbook at /AGENTS.md read by Cursor, Codex, Windsurf, Aider, Claude Code, and Gemini CLI. Bundled inside the SDK so coding agents stop hallucinating endpoint names.

MCP DocumentationBuild with AI prompts

Do not take our word for it. Ask the agents.

The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.

Ask ChatGPTAsk PerplexityAsk Claude

Opens a live web search in a new tab.

What people build

AI astrology companions and chatbots grounded in verified calculations, dating and compatibility features, daily horoscopes, tarot, kundli matching and dream journals, all on one key across 18+ domains. From weekend side projects to revenue-generating apps serving millions of users.

AI astrology companions

A spiritual companion that remembers each user: natal chart stored once, readings recalled by meaning, every answer grounded in live calculations

Tutorial
AI astrology chatbots

Conversational readings that call 258+ verified calculation tools over Remote MCP instead of inventing placements

Tutorial
Astrology dating apps

Zodiac matching, synastry scores, relationship compatibility

Tutorial
Daily horoscope features

Embed transit-based forecasts in wellness and lifestyle apps

Tutorial
Tarot and oracle apps

Digital readings, Celtic Cross spreads, daily card pulls

Tutorial
Kundli and matchmaking

Gun Milan, Dasha, doshas for the Indian matrimonial market

Vedic API
Dream journals

2,200+ symbol search, AI interpretation, pattern tracking

Dreams API
Sell readings

Subscriptions, one-off readings, consultations and shop products on top of the calculations and interpretation text

Guide

Three steps. Thirty minutes.

From zero to a working app in one sitting.

  1. Get your API key

    Pick a plan, pay with any currency, get your key instantly. No account required. All 18 domains included.

    View plans from $39/mo

  2. Embed, clone, or build

    Paste a widget with no code, clone a template, drop in UI components, or call the REST API from a typed SDK. Pick your path.

    Embed WidgetsTemplatesUI ComponentsSDKsAI PromptsAPI ReferenceMCP SetupAGENTS.md

  3. Ship

    Deploy to Vercel, Netlify, or your own server. Every reading backed by verified calculations. Scale from prototype to production.

Try before you build

20+ free interactive tools. No signup, no API key. See exactly what the API returns.

Life Path Calculator

Pythagorean numerology from birth date

Try free
Tarot Reading

Three-card past, present, future spread

Try free
I-Ching Oracle

64 hexagrams from the Book of Changes

Try free
Dream Lookup

Search 2,200+ dream symbols and meanings

Try free
Birth Chart

Western natal chart with planets and houses

Try free
Vedic Panchang

Tithi, nakshatra, yoga, karana, Rahu Kaal

Try free
Browse all free tools

One key. Every surface unlocked.

One API key

One flat plan, all inclusive

  • Typed API: a complete result in one call, from a live typed OpenAPI spec

  • Remote MCP: hosted agent tools over Streamable HTTP, no local setup

  • Typed SDKs: TypeScript, Python, PHP, C#, and Go, generated from the spec

  • UI components: natal wheels, kundli, bodygraphs, and spreads rendered from the response

  • Embed widgets: paste one snippet on any site with a browser safe publishable key

  • Templates: MIT licensed apps to clone, white label, and ship as your own

  • Multilingual i18n: full interpretation text in 10+ languages, included in every plan

Every surface, across all 18 domains, under one flat subscription. No per-product fees, no per-request or token costs.

Frequently asked questions

What the astrology API does, how accurate it is, and how AI agents use it.

What is an astrology API?

An astrology API returns chart positions, horoscopes, transits or compatibility data over HTTP as structured JSON for an application to use. RoxyAPI is a data layer for insight, belief, prediction and self-knowledge products, covering 18+ domains under one subscription. Its Western astrology suite includes natal charts and advanced timing techniques, alongside Vedic astrology, forecast, human design and other domains.

How can AI agents use RoxyAPI?

RoxyAPI supplies a Remote MCP server per domain over Streamable HTTP, so compatible clients can discover tools and request live calculations. One subscription covers the domain servers, and OpenAPI documentation supports integrations that call REST directly. Check docs/mcp for client authentication and connection requirements.

How accurate is RoxyAPI, and how is that verified?

For the Sun, Moon, planets and Chiron, RoxyAPI returned 231 of 231 positions within 0.32 arcseconds (0.00009 degrees) of NASA JPL Horizons, at a median deviation of 0.05 arcseconds (0.00001 degrees). The open RoxyAPI benchmark checks 17 domains, each against its own named authority, from planets, angles and sidereal charts to calendars, time zones and printed rules, and returned 2,701 of 2,701 values within their stated tolerance; only tarot, crystals, dreams and angel numbers, which have no outside value to measure, are left out. Read every domain, value and maximum in the live report at roxyapi.github.io/astrology-api-benchmark, rerun the MIT benchmark at github.com/RoxyAPI/astrology-api-benchmark and inspect live responses in api-reference.

What does RoxyAPI include under one subscription?

RoxyAPI combines 18+ insight domains with advanced Western techniques, Vedic KP, dasha and matching methods under one key. The subscription also covers Remote MCP, SDK access, UI integrations and templates. Published verification evidence and flat request pricing let you assess both the output and the cost before integrating.

Is a newer astrology API safe to build on?

RoxyAPI publishes verification evidence you can assess alongside its production history. Engine work began in 2020, the platform has run in production since 2024, and the test suite includes boundary cases such as the hour a daylight saving change skips, midnight on a solar clock for a BaZi day pillar, a Human Design node under two arcseconds past a gate line, a birth at the South Pole in the first second of 2000, and both ends of the 1550 to 2650 ephemeris span. Before committing, review methodology, rerun the MIT benchmark at github.com/RoxyAPI/astrology-api-benchmark and test representative requests in api-reference.

Can one API key access every domain?

A RoxyAPI subscription includes every domain and endpoint without per-product fees. A secret key can access REST and the domain Remote MCP servers; publishable keys support permitted browser integrations. Localized responses are available in 10+ languages, with coverage documented by domain.

What can I build with RoxyAPI?

Build chart and horoscope apps, compatibility features, AI reading companions, human design tools or multi-domain self-knowledge products. SDKs, supported UI renderers and MIT-licensed templates provide integration paths for developers. Embeddable widgets and the WordPress plugin let site owners add supported readings without building a custom interface.

Which SDKs and developer tools does RoxyAPI provide?

RoxyAPI provides SDKs for TypeScript, Python, PHP, C#, and Go, generated from its OpenAPI specification. Remote MCP supplies tools for compatible AI clients, while Roxy UI renders supported chart and reading responses. Documentation, Postman collections and MIT-licensed templates provide examples you can inspect and adapt.

Can I add astrology to a WordPress site or build with no code?

The official WordPress plugin adds supported readings through shortcodes. The gallery at widgets provides snippets, iframes and hosted links for sites that permit those embed formats. Choose an available widget and configure a publishable key for your site origins.

Is RoxyAPI open source, and can I use it commercially?

The SDKs, Roxy UI components and templates are MIT licensed. Roxy Ephemeris is proprietary hosted infrastructure accessed through the commercial API. You can build a commercial application under the API license without a requirement to disclose your application source; review policy/license for the terms.

Who is behind RoxyAPI?

RoxyAPI is built by a small, independent team of senior engineers, each with over 20 years building consumer and lifestyle products at scale, including at some of the biggest names in the industry. Engine development began in 2020 and the platform has run in production since 2024. The dated product and usage figures are published at transparency.

Where is birth data processed, and what does RoxyAPI store?

API request bodies are never persisted. Responses derived from submitted data may be cached for up to 24 hours; Cache-Control: no-store bypasses the cache. Usage metadata retention is in policy/privacy. Your application keeps user profiles and memory. Service accounts, subscriptions, usage records and response caches are stored at rest in Germany; policy/dpa describes subprocessors, transfers and security measures.

Does the API return interpretations or only raw data?

Many chart and reading endpoints return editorial interpretations alongside structured results, including natal chart placements and tarot spreads. Calendar and reference endpoints return the data relevant to their task, so interpretation coverage varies by endpoint. Inspect the response schema and live example in api-reference before choosing an endpoint.

Is there a free way to try RoxyAPI before paying?

The interactive API reference lets you try live responses before subscribing. Free calculators show selected readings, and MIT-licensed templates let you inspect example applications. Use representative inputs to check the fields and presentation your product needs.

How much does RoxyAPI cost?

Plans start at $39 per month for 50,000 requests and include all 18+ domains and Remote MCP. Annual Starter billing works out to $1.80 per domain per month. One billable calculation request uses one quota unit; current plans and allowances are at pricing.

The insight data layer for builders.

You focus on the experience your users love. Roxy handles the data, the calculations, and the accuracy.

Get API KeyFree templatesTry free tools