Skip to content
RoxyAPI

Astrology API: The Spiritual OS layer for agentic AI.

One 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
Verified against NASA JPL HorizonsAll 18 domains from $39/mo12 open source templates

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.

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

Western Astrology API

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

Natal Chart APIHoroscope APISynastry API+24
Explore
Advanced

Vedic Astrology API

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

Kundli APIPanchang APIChoghadiya API+31
Explore

Forecast API

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

Astrology Transit Forecast APITransit Timeline APISignificant Astrology Dates API+2
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 APIHuman Design Type APIHuman Design Authority API+8
Explore

Chinese Astrology API

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

BaZi APIFour Pillars APILuck Pillars API+11
Explore

Feng Shui API

Flying star charts and Kua numbers that are actually checkable.

Kua Number APIEight Mansions APIFlying Star API+5
Explore

Mesoamerican Astrology API

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

Tzolkin APIMayan Astrology APILong Count Calendar API+4
Explore

Vastu Shastra API

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

Vastu Entrance APIVastu Purusha Mandala APIVastu Plot Analysis API+4
Explore

Numerology API

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

Life Path APINumerology Chart APINumerology Compatibility API+14
Explore

Kabbalah API

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

Gematria APIHebrew Birthday APIKabbalah Birth Angel API+6
Explore
Popular

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 APITarot Card Draw APIThree Card Spread API+6
Explore

Biorhythm API

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

Biorhythm Cycles APIDaily Biorhythm APIBiorhythm Forecast API+3
Explore

Ayurveda API

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

Ayurvedic Constitution APIDosha Type APIDinacharya API+5
Explore
Exclusive

I-Ching Oracle API

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

Daily Hexagram APII Ching Reading APIHexagram API+1
Explore
Exclusive

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 APICrystals by Chakra APIBirthstone API+5
Explore
Exclusive

Dream Interpretation API

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

Dream Symbol APIDream Dictionary APIDaily Dream Symbol API
Explore
Exclusive

Angel Numbers API

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

Angel Number Meaning APIAngel Number Lookup APIDaily Angel Number API
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 APIGeocoding APITimezone API+1
Explore

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.9539944038144341,
      "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.104782784588977,
      "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.94755540214257,
      "sign": "Scorpio",
      "degree": 6.947555402142569
    },
    {
      "number": 2,
      "longitude": 245.70511081785486,
      "sign": "Sagittarius",
      "degree": 5.705110817854859
    }
  ],
  "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.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 creates accept, accepting, balance...",
        "keywords": [
          "accept",
          "accepting"
        ]
      }
    }
  ],
  "ascendant": {
    "longitude": 216.94755540214257,
    "sign": "Scorpio",
    "degree": 6.947555402142569
  },
  "midheaven": {
    "longitude": 134.3757003268656,
    "sign": "Leo",
    "degree": 14.375700326865598
  },
  "partOfFortune": {
    "sign": "Leo",
    "degree": 11.011973544142563,
    "longitude": 131.01197354414256,
    "sect": "day",
    "house": 9
  },
  "vertex": {
    "longitude": 77.23570400870443,
    "sign": "Gemini",
    "degree": 17.23570400870443,
    "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 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 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.

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 directly, no local processes, no Docker, no self hosting.
YesVariesBuild 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 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 users
Boundary 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 testsFound in productionYours to find
Maturity you can check, not years you take on trust
Engine 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 proofYears, self-reportedUpstream history
13,405 automated tests per deploy
3,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.
PublishedNot publishedVaries
Open MIT benchmark
Planet positions re-checked against NASA JPL Horizons DE441 in runnable Python, median deviation 0.05 arcseconds (0.00001 degrees). 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 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 EphemerisSwiss based, licence unverifiableSwiss based, AGPL unless licensed
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 calculations, your own user profiles
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.
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.

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.

Core API

Production REST where one call equals a complete result.

Remote MCP

Hosted agent tools, one server per domain, no local setup.

Typed SDKs

5 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 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

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 Ephemeris13,405 tests, 3620 gold standard
Verified result18 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,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 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?

Planetary positions are verified against NASA JPL Horizons; derived calculations are checked against the reference named for each domain. The public planetary benchmark reports a median deviation of 0.05 arcseconds (0.00001 degrees). 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