Skip to content
RoxyAPI

Launch your spiritual app this weekend.

The Spiritual OS layer for agentic AI. 18+ domains, from astrology and Vedic astrology to forecast and human design, all behind one API key and Remote MCP.

AstrologyVedicForecastHuman DesignChinese AstrologyFeng ShuiMesoamericanVastuNumerologyKabbalahTarotBiorhythmAyurvedaI-ChingCrystalsDreamsAngel NumbersLocation
Get API KeyExplore all domains
Verified against NASA JPL HorizonsAll 18 domains from $39/mo11 open source templates

18 intelligence domains. One infrastructure.

One subscription, one API key, full access to every domain. No per-product locks, no variable token costs. Every endpoint is production-ready with Remote MCP support.

Popular

Astrology API

Ship your astrology app this weekend. Not this quarter.

Natal Chart APIHoroscope APISynastry API+14
<50ms
Explore
Advanced

Vedic Astrology API

Launch your Jyotish or KP astrology product in days. Not months.

Kundli APIKP Horary APIGraha Asta API+18
<50ms
Explore

Forecast API

Ship a cross-domain forecast your users can plan around. This week.

Transit Forecast APIForecast Timeline APISignificant Dates API
<200ms
Explore

Human Design API

Ship a Human Design bodygraph your users can trust. This week.

Bodygraph APIType APIConnection API+2
<50ms
Explore

Chinese Astrology API

A BaZi chart that tells you which school it came from.

BaZi APIFour Pillars APIChinese Zodiac API+3
Explore

Feng Shui API

Flying star charts that are actually checkable.

Flying Star APIKua Number APIEight Mansions API+2
Explore

Mesoamerican Astrology API

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

Mayan Astrology APITzolkin APILong Count Calendar API+2
Explore

Vastu Shastra API

Directional design with the verse behind every verdict.

Vastu Shastra APIVastu Entrance APIVastu Purusha Mandala API+2
Explore

Numerology API

Ship a numerology app your users will love. This week.

Life Path APINumerology Chart APICompatibility API+2
<50ms
Explore

Kabbalah API

A gematria number you can show the spelling for.

Gematria APIKabbalah Numerology API72 Names of God API+2
Explore
Popular

Tarot Reading API

Launch a tarot reading app with 78-card authenticity. In days.

Daily Card APIThree Card Spread APICeltic Cross API+3
<50ms
Explore

Biorhythm API

Ship a biorhythm feature your users will love. This week.

Daily Biorhythm APIBiorhythm Forecast APICompatibility API+1
<5ms
Explore

Ayurveda API

Ship a cited Ayurveda feature, not another dosha quiz.

Dosha APIAyurvedic Constitution APIDinacharya API+2
Explore
Exclusive

I-Ching Oracle API

Bring 3,000 years of I-Ching wisdom to your app. In days.

Daily Hexagram APICast Reading APIHexagram API
<50ms
Explore
Exclusive

Crystals and Healing Stones API

The definitive crystal healing API. Build a wellness app this weekend.

Crystals by Zodiac APICrystals by Chakra APIBirthstone API+1
<50ms
Explore
Exclusive

Dream Interpretation API

Ship a dream analysis app with 2,000+ symbols. This weekend.

Dream Symbol APIDream Dictionary APIDaily Dream API
<50ms
Explore
Exclusive

Angel Numbers API

The most complete angel numbers API. Ship a synchronicity app this weekend.

Angel Number APINumber Lookup APIDaily Angel Number API
<50ms
Explore

Location and Timezone API

Geocoding autocomplete with coordinates and timezone for astrology apps

City Search APIGeocoding APITimezone API
<50ms
Explore

More than astrology. The spiritual intelligence suite.

RoxyAPI is the spiritual intelligence suite: 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
  • Sub-50ms responses. Numerology, tarot, and dreams return instantly.
  • 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": -5,
    "nodeType": "true"
  },
  "planets": [
    {
      "name": "Sun",
      "longitude": 113.04427333389695,
      "latitude": -0.000023761128557311987,
      "sign": "Cancer",
      "degree": 23.044273333896953,
      "speed": 0.9540150021003342,
      "isRetrograde": false,
      "house": 8,
      "dignity": "peregrine",
      "interpretation": {
        "summary": "Your Sun in Cancer in The Eighth House reveals how you express self-awareness and ego with intuitive and nurturing energy in the realm of transformation and crisis.",
        "detailed": "Sun represents self-awareness and ego. In Cancer (Crab), this energy becomes intuitive, nurturing, protective. Located in The Eighth House, you direct this Cancer Sun energy toward transformation and crisis and sexuality. This creates a unique expression where your self-awareness and ego naturally manifests through intuitive, nurturing, protective approaches in matters related to the eighth house.",
        "keywords": [
          "active",
          "awareness"
        ]
      }
    },
    {
      "name": "Moon",
      "longitude": 27.657203009977078,
      "latitude": 5.191167434861756,
      "sign": "Aries",
      "degree": 27.657203009977078,
      "speed": 14.118492321516968,
      "isRetrograde": false,
      "house": 5,
      "dignity": "peregrine",
      "interpretation": {
        "summary": "Your Moon in Aries in The Fifth House reveals how you express inner emotional life with ambitious and independent energy in the realm of creative self-expression.",
        "detailed": "Moon represents inner emotional life. In Aries (Ram), this energy becomes ambitious, independent, impatient. Located in The Fifth House, you direct this Aries Moon energy toward creative self-expression and pleasure and entertainment. This creates a unique expression where your inner emotional life naturally manifests through ambitious, independent, impatient approaches in matters related to the fifth house.",
        "keywords": [
          "caretaker",
          "comfort"
        ]
      }
    }
  ],
  "houses": [
    {
      "number": 1,
      "longitude": 228.70514411922719,
      "sign": "Scorpio",
      "degree": 18.705144119227185
    },
    {
      "number": 2,
      "longitude": 258.62614389203986,
      "sign": "Sagittarius",
      "degree": 18.626143892039863
    }
  ],
  "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 creates accept, accepting, balance...",
        "keywords": [
          "accept",
          "accepting"
        ]
      }
    },
    {
      "planet1": "Mercury",
      "planet2": "North Node",
      "type": "OPPOSITION",
      "angle": 180,
      "orb": 0.0012413202818777336,
      "isApplying": false,
      "strength": 99.98448349647653,
      "interpretation": "challenging",
      "aspectInterpretation": {
        "summary": "Your Mercury forms a very strong opposition (180) with North Node, currently separating (weakening). This challenging aspect creates accept, accepting, balance...",
        "keywords": [
          "accept",
          "accepting"
        ]
      }
    }
  ],
  "ascendant": {
    "longitude": 228.70514411922719,
    "sign": "Scorpio",
    "degree": 18.705144119227185
  },
  "midheaven": {
    "longitude": 149.7837331047243,
    "sign": "Leo",
    "degree": 29.78373310472429
  },
  "partOfFortune": {
    "sign": "Leo",
    "degree": 23.31807379530727,
    "longitude": 143.31807379530727,
    "sect": "day",
    "house": 9
  },
  "vertex": {
    "longitude": 91.94342726411993,
    "sign": "Cancer",
    "degree": 1.9434272641199328,
    "house": 8
  },
  "patterns": [
    {
      "kind": "T_SQUARE",
      "name": "T-Square",
      "planets": [
        "Moon",
        "Sun"
      ],
      "apex": "Moon",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 57,
      "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": 57,
      "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
    }
  }
}
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 snippetNatal chart: Natal chart wheel with planet glyphs and aspect linesVedic kundli widget snippetVedic kundli: South, North, or East Indian kundli with degree detail and optional Chandra Lagna viewKP chart widget snippetKP chart: Ascendant, cusps, planets and nodes with KP stellar hierarchy and house meaningsForecast timeline widget snippetForecast timeline: Date-grouped events across Western, Vedic, and biorhythm domains, weighted by significanceBodygraph widget snippetBodygraph: 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 meaningBazi chart widget snippetBazi chart: Year, month, day and hour pillars in hanzi with hidden stems, Ten Gods, Na Yin, element balance and interactionsFlying star chart widget snippetFlying star chart: Nine-palace flying star plate with the mountain, period and water star per palace, the facing and sitting mountains and the structureMayan day sign widget snippetMayan day sign: Day sign and coefficient with the trecena, the reading, and the Calendar Round on the fuller responseVastu mandala widget snippetVastu mandala: Pada grid with a devata per square, the brahmasthan, and the entrance pada lit with its effectNumerology card widget snippetNumerology card: Life path, expression, soul urge, personality, personal year, full chartGematria widget snippetGematria: Values by cipher, every candidate Hebrew spelling with its per letter breakdown, and equal-value wordsTarot card widget snippetTarot card: Single card with upright and reversed flipBiorhythm chart widget snippetBiorhythm chart: Daily bars, forecast cycle lines, critical daysDosha constitution widget snippetDosha constitution: Vata, pitta and kapha shares as one bar with the dominant humour and the cited factors behind itHexagram widget snippetHexagram: Hexagram figure with trigrams, judgment, image, and a reading per line (statement plus meaning); a cast highlights the moving lines and the resulting hexagramCrystal card widget snippetCrystal card: Photo, meaning sections, chakra, zodiac, element, hardness, keywords, and pairingsDream card widget snippetDream card: Symbol name, interpretation body, and letter chipAngel number card widget snippetAngel number card: Number meaning with spiritual, love, career, money, twin flame, biblical, and shadow sectionsThe complete UI libraryExplore Roxy UI
Show all 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 RoxyAPI different.

RoxyAPI is the only multi-domain spiritual intelligence API: 18+ domains, one key, 2,961 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.

Feature comparison of RoxyAPI against legacy astrology APIs and DIY open source libraries, grouped by platform, AI agent readiness, verification, developer experience, and licensing.
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 domains
Astrology, vedic astrology, forecast, human design, numerology, tarot, and more behind a single subscription and a single API key.
YesPer productOne library each
Flat request pricing
1 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.
YesCredit tablesSelf hosted
One call, complete result
A natal chart or kundli returns whole in one response instead of splitting into many separately billed calls.
YesSplit callsAssembly required
New domains at no extra cost
Every new domain lands inside the existing plan automatically.
YesNew invoiceNew 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 chart
Fixed 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 layerNatal and transitsRaw positions
Classical Vedic with the reasoning attached
A 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 evidenceYoga namesPositions only
Human Design past type and authority
Variables 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 PentaType and profileNo engine to fork
Domains that compose, not just coexist
Human 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 engineSeparate productsYou merge it
AI agent readiness
Remote MCP server per domain
Hosted Streamable HTTP servers your agent connects to in seconds, no local processes, no Docker, no self hosting.
YesLocal stdioBuild your own
Token-optimized responses
Opt-in compact mode cuts LLM tokens per response by 40 to 52 percent on detailed charts. Same data, lower agent inference cost, one request.
YesNot offeredNot offered
Agents integrate on their own
Point an AI agent at roxyapi.com and it discovers every capability, the auth model, and the docs without a human in the loop.
YesHuman setupHuman setup
Bring your own LLM
Grounded 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 voiceMarkups, locked promptYes
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 its reference sources and tolerances, the playground returns real production responses with no signup, and uptime is reported by a third party we cannot edit.

12,146 automated tests per deploy
2,961 of them are gold-standard tests pinned to named external references.
PublishedNot publishedVaries
Open MIT benchmark
210 planet positions across 21 charts re-checked against NASA JPL Horizons DE441 in runnable Python. Point it at any provider.
RunnableNo public artifactRun it yourself
Published methodology
Test corpus, tolerances, and reference sources documented in public.
YesAsserted onlyVaries
Proof before you pay
The live playground returns real production responses, not fake sandbox data locked behind a signup. Audit accuracy and response shape first.
No signupSignup or sandboxInstall first
Independent uptime page
Uptime 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 monthsSelf reportedYours to run
Developer experience
Live typed OpenAPI spec
Every operation ships typed request and response schemas, drift-guarded in CI. Try real production responses before paying.
YesDocs or exportsRead the source
Typed SDKs in 5 languages
TypeScript, Python, PHP, C#, and Go, each bundling AGENTS.md so coding agents stop hallucinating endpoint names.
YesFewer languagesNo
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.
YesNoNo
Embeddable widgets
Copy-paste snippets with browser-safe pk_ publishable keys and origin allowlists. Works on Squarespace, Wix, Shopify, or any HTML block.
YesNoNo
White-label MIT Templates
Open source apps you can clone, brand, and ship as your own product.
YesNoVaries
Editorial-grade interpretations in 10+ languages
Complete 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 readyHoroscopes mostlyNumbers only
Usage dashboard and quota alerts
The 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.
YesVariesYou 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 wrapper
Roxy Ephemeris is built in house and verified at NASA JPL Horizons parity. Legacy engines wrap Swiss Ephemeris, a 1990s AGPL copyleft library written for single-user desktop software.
Roxy EphemerisSwiss based (AGPL copyleft)Swiss based (AGPL copyleft)
No AGPL exposure
The 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.
NoneInherited from SwissAGPL common
Commercial license on every plan
Build 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.
YesVariesCopyleft terms
Stateless, zero user data stored
No birth data, journals, or profiles retained, so there is no store to breach and nothing to export or erase when a data subject request arrives. Birth data that can qualify as GDPR Article 9 special category is computed in memory and never lands in a database.
YesAccounts and logsSelf hosted
EU data residency with an Article 28 DPA on every plan
Stored 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 plansEnterprise or on requestYours 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. Sub-50ms median latency.

12,146 automated tests on every deploy, 2,961 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.

Core API

Production REST where one call equals a complete result.

Remote MCP

Hosted agent tools that run in seconds, no local setup.

Typed SDKs

Five languages, generated from the live spec, never hand drifted.

UI components

Render the response, not just fetch it.

Embeddable widgets

Paste one snippet on any site. No backend, no build step.

Templates

Clone, white label, ship as your own product.

Internationalization

Editorial-grade interpretations, localized whole.

Verification and accuracy

Receipts published, not asserted.

Free tools

See real responses before you sign up.

Engineered since 2020. In production since 2024.

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

  1. 2020
    Roxy Ephemeris groundwork begins

    Four 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 at 1.5 arcseconds

    Engine update takes the median deviation from NASA JPL Horizons to 1.5 arcseconds across 210 reference positions, 210 of 210 inside tolerance, 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
    12,146 tests on every deploy

    261 endpoints across 18 domains, verified against NASA JPL Horizons.

Transparency reportPublic changelogIndependent status pageRun the benchmark

Shipped by builders, in production today

From indie developers to dating app founders. Read all reviews

DM

Dhani M.

Indie App Developer

Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.

Email feedback
TH

Tom H.

Senior Developer

The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.

Email feedback
CW

Chris W.

Backend Engineer

Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.

Email feedback
Read all 127 reviews

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 agentyour model, your voice
Remote MCPauto-discovered, no local setupToken-optimized
Roxy Ephemeris12,146 tests, 2961 vs NASA JPL
Verified result18 domains, one flat rate

Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. 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,000+ symbol search, AI interpretation, pattern tracking
Dreams API

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,000+ 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 keyOne 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 computed astrology data, natal charts, horoscopes, transits, and compatibility, over HTTP as structured JSON, so you can build features without writing the astronomy yourself. RoxyAPI is a multi-domain example: one key also covers Vedic astrology, forecast, human design, numerology, tarot, and more, with every calculation verified against NASA JPL Horizons.

Which astrology API is best for AI agents?

RoxyAPI is built for AI agents. Every domain ships a Remote MCP server over Streamable HTTP, so Claude, Cursor, VS Code, and OpenAI agents auto-discover the tools in seconds with no local setup. Your agent picks the domain each question needs (astrology, human design, forecast, numerology) and calls it mid-conversation, with every domain behind one key so adding a capability means no new vendor or bill. It also serves llms.txt and an AGENTS.md playbook, so coding agents call real endpoints instead of hallucinating them and ground each answer in verified calculations.

How accurate is RoxyAPI, and how is that verified?

Every calculation runs on Roxy Ephemeris and is verified against NASA JPL Horizons, with a public MIT licensed benchmark anyone can re-run. A gold-standard test suite cross-references each domain against authoritative sources, and the live API reference returns real production responses, so you can audit accuracy before you pay.

How is RoxyAPI different from legacy astrology APIs?

Three structural differences. Scope: legacy providers sell astrology, while RoxyAPI covers 18 spiritual intelligence domains, astrology, Vedic astrology, forecast, human design, numerology, tarot, and more, under one key and one flat plan where one request equals one quota unit with no credit weighting. Proof: accuracy is published rather than asserted, with 12,146 automated tests on every deploy, 2961 of them gold-standard tests pinned to named external references, plus an open MIT benchmark anyone can re-run against NASA JPL Horizons DE441 and point at any provider. Architecture: Roxy Ephemeris is built in house for APIs and AI agents at NASA JPL Horizons parity, with a Remote MCP server per domain, llms.txt, and AGENTS.md. Legacy providers wrap Swiss Ephemeris, a 1990s desktop-era library whose AGPL reaches network services, so products built on unlicensed wrappers inherit that obligation whether they know it or not. Honest exception: if you need exactly one domain, run your own servers, and are comfortable with copyleft licensing, a free open source library is cheaper.

Can one API key access every domain?

Yes. A single RoxyAPI subscription unlocks every domain, every endpoint, and Remote MCP under one key, with no per-product locks and no variable token costs. You integrate once and get astrology, Vedic astrology, forecast, human design, numerology, tarot, and the rest from the same flat plan, with editorial interpretations available in 10+ languages.

What can I build with RoxyAPI?

The fastest-growing 2026 app categories all map to RoxyAPI: AI astrology companions and reading chatbots grounded in real calculations instead of hallucinated text, dating and relationship compatibility features, personalized daily horoscope and transit forecast apps, human design and bodygraph tools, and Vedic kundli, numerology, and tarot experiences. You do not have to start from scratch either: typed SDKs, drop-in UI components, copy-paste embeddable widgets for Squarespace, Wix, Shopify, Ghost, and Webflow, a WordPress plugin, and free templates ship with every plan. Developers go from API key to a working app in about thirty minutes, and a practitioner with an existing site pastes one snippet and has a live reading running without writing any code.

Which SDKs and developer tools does RoxyAPI provide?

RoxyAPI ships typed SDKs for TypeScript, Python, PHP, C#, and Go, all auto-generated from the live OpenAPI spec so they never drift. Each SDK bundles an AGENTS.md playbook that stops AI coding tools like Cursor and Claude Code from hallucinating endpoint names. Drop-in Roxy UI web components render every response, natal wheels, kundli, dasha timelines, and tarot spreads, straight from the JSON, and the same components ship as copy-paste embeddable widgets for Squarespace, Wix, Shopify, and any site with an HTML block, so a page with no build step gets a live reading from a single snippet. Free open source templates take you from clone to deploy in minutes.

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

Yes, three ways. The official RoxyAPI WordPress plugin adds readings to any page with a shortcode and no code. On Squarespace, Wix, Shopify, or any site with an HTML block, the copy-paste widgets at roxyapi.com/widgets embed a natal chart, horoscope, kundli, or tarot reading with one prefilled snippet or a hosted embed URL, powered by a browser-safe publishable key and no backend. And for custom builds, the drop-in Roxy UI web components work in plain HTML, React, Vue, Svelte, or Angular and render every API response from a single tag, themeable with CSS variables.

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

The SDKs, Roxy UI components, the copy-paste embeddable widgets built on them, and the templates are MIT licensed and free to use in commercial products. The calculation engine carries no AGPL copyleft, so you can ship a closed-source commercial app without the licensing restrictions that come with the older ephemeris libraries most incumbents are built on. RoxyAPI is also stateless: it stores no birth data or user profiles, so your users and the personalization you build on them stay your moat, not ours.

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. Groundwork on the in-house Roxy Ephemeris calculation engine began in 2020, the platform launched in 2024, and it has grown by word of mouth since, verified throughout against NASA JPL Horizons. The platform crossed 1 million cumulative API requests in March 2025, and the full dated figures are published on the transparency report.

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

Birth date, birth time and location are processed in memory and the request body is never written to disk. Computed results are cached briefly on opt-in endpoints and can be switched off per request, so nothing you send is retained once the response is returned. What RoxyAPI does store, meaning accounts, subscriptions and usage records, is held in Germany inside the European Union on every plan, and data at rest does not leave the EU. The Article 28 Data Processing Addendum, the EU Standard Contractual Clauses, the security measures and a dated subprocessor register are published, so a buyer can complete a vendor assessment before paying anything.

Does the API return interpretations or only raw data?

Both. Every chart, reading, and forecast domain returns editorial interpretation text in the same response as the calculated numbers, not just raw coordinates you have to write your own copy for, and that text is translated in the 10+ languages each domain supports rather than only the field labels. A catalogue lookup, such as a tarot card meaning, or a calendar endpoint returning dates and positions, is data by design, because there is nothing to interpret. A natal chart, a kundli, a bodygraph, or a tarot spread carries the reading alongside the chart. Bringing your own LLM on top is optional, for a voice or a persona layered onto a response that already carries a complete interpretation.

Is there a free way to try RoxyAPI before paying?

Yes. The interactive API reference returns real production responses, not signup-locked sandbox data, so you can audit the output before you buy. More than twenty free calculators and open source templates let you see exactly what each endpoint returns with no key required.

How much does RoxyAPI cost?

Plans start at $39 per month for 50,000 requests, and every plan includes all 18 domains, every endpoint, Remote MCP, the typed SDKs, the UI components, the copy-paste embeddable widgets, and the templates. Because the whole catalog is bundled, the unit that matters is the price per domain: $1.80 per domain per month on annual billing, against $12 or more per month for a typical single-domain astrology API. Pricing is flat, so one request equals one quota unit whether it arrives over REST or Remote MCP, and a complete natal chart or kundli returns in a single call rather than several separately billed ones. RoxyAPI uses no credit weighting at all, so a credit allowance quoted by a credit-metered provider is a different unit and does not compare directly: on one such published credit table a single birth chart draws 50 credits, so their headline allowance has to be divided by the per call weight before it lines up against a RoxyAPI request quota.

The intelligence 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