AI Spiritual Voice Assistant
Web App / Open Source30 minTalk to the stars. Real readings across every domain, spoken aloud.
VoiceAstrologyVedicTarotNumerologyHuman Design
Biorhythm API
Biorhythm cycles past the classic three, with critical days graded by how many cycles cross at once.
Biorhythm CyclesDaily BiorhythmBiorhythm ForecastBiorhythm CompatibilityBiorhythm Critical DaysBiorhythm Phase
Included with every plan (at no extra cost)
What the Biorhythm API covers.
Cycles
- Physical, emotional and intellectual cycles
- Intuitive, aesthetic, awareness and spiritual cycles
- Passion, mastery and wisdom composite cycles
- Phase, trend and days to the next peak or trough
Forecasts
- Day-by-day forecast with best and worst days
- Critical days graded single, double or triple
- Energy rating and overall phase for any date
- Daily reading that holds for the whole day
Compatibility
- Per-cycle alignment and an overall score
- Rating with strengths, challenges and advice
- Daily sync of the primary cycles for a pair
Biorhythm API for entertainment and reflection, with 10 model cycle types across 3 primary (physical, emotional, intellectual), 4 secondary (intuitive, aesthetic, awareness, spiritual), and 3 composite (passion, mastery, wisdom). Critical-day detection with severity classification, 90-day forecasts with best and worst days, two-person compatibility scoring, phase tracking for dashboards, and daily readings that hold all day for push notifications. Localized into every language this API ships, deterministic results, and editorial-grade interpretations. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
Every Biorhythm calculation is covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests locked to the named references on our methodology page. See how we test.
Interpretations in English, Deutsch, Español, Français, हिन्दी, Português, Русский, Türkçe, one query parameter away.
Start your way. Code, agents or no code.
Developers
Typed SDKs for TypeScript, Python, PHP, C#, and Go, generated from the live spec, each with an AGENTS.md so your coding assistant calls the Biorhythm API correctly.
AI agents
A Remote MCP server exposes every endpoint as a tool for Claude, ChatGPT, Cursor and any MCP client, with no local install. Opt-in compact responses cut the tokens your agent reads by roughly 40 to 52 percent, and one call stays one request.
No-code builders
Paste a widget into any site builder, install the WordPress plugin, or start from an MIT template you can white-label. Results render from the Biorhythm API with no backend.
Biorhythm API features, in detail.
The depth behind every line above, written out in full.
- 10 biorhythm cycle types from any birth date: 3 primary (physical 23d, emotional 28d, intellectual 33d), 4 secondary (intuitive 38d, aesthetic 43d, awareness 48d, spiritual 53d), and 3 composite cycles (passion, mastery, wisdom) that standard calculators do not cover
- 8 distinct phase states per cycle: peak, high, rising, critical ascending, critical descending, falling, low, and trough with percentage values from -100 to 100
- Critical day detection across any date range with single, double, and triple severity levels for simultaneous zero crossings across primary cycles
- Two-person compatibility scoring: per-cycle alignment (0-100), overall score, rating label, relationship strengths, challenges, and actionable advice
- 90-day forecasts with daily cycle values, energy ratings (1-10), best and worst day identification, and period-level model interpretation
- Daily readings that stay the same for one user all day, built for push notifications, morning briefings, and daily check-in widgets
- 80+ editorial phase interpretations and 25+ combined cycle readings assembled from actual cycle states, not generic filler text
- Fully deterministic results: the same birth date and target date always return the same cycle values, verified against authoritative biorhythm calculators
Start building with one key.
Want to try without writing code? Try this domain live in API playground →
Terminal
npm install @roxyapi/sdkUsage
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.biorhythm.get(/* ... */)Terminal
pip install roxy-sdkUsage
from roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.biorhythm.get(...) # async: await roxy.biorhythm.get_async(...)Terminal
composer require roxyapi/sdkUsage
use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->biorhythm->get(/* ... */);Terminal
dotnet add package RoxyApi.SdkUsage
using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
// await roxy.Biorhythm.<resource>.GetAsync() or .PostAsync(new() { ... })Terminal
go get github.com/RoxyAPI/sdk-goUsage
import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
// resp, err := roxy.Biorhythm.<Method>(context.Background(), nil)Claude Code / Cursor
claude mcp add --transport http \
roxy-biorhythm https://roxyapi.com/mcp/biorhythm \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all endpoints as callable tools. Zero configuration. Responses can come back token-optimized and lossless, cutting the tokens your agent spends per call by roughly 40 to 52 percent.
Full MCP setup guideTerminal
curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/biorhythm/Want to ship faster? Clone a free template and white-label it as your own app.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app.
Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.
POST /api/v2/biorhythm/reading
{
"birthDate": "1990-07-15",
"targetDate": "2026-04-10",
"daysSinceBirth": 13053,
"cycles": {
"physical": {
"value": -14,
"rawValue": -0.1362,
"phase": "falling",
"phaseLabel": "Falling",
"dayInCycle": 13,
"daysUntilPeak": 17,
"daysUntilTrough": 5,
"daysUntilCritical": 11,
"trend": "falling",
"interpretation": "Your physical energy is declining. Endurance and strength are decreasing, and fatigue may set in more quickly than usual. This is a natural part of the cycle."
},
"emotional": {
"value": 90,
"rawValue": 0.901,
"phase": "peak",
"phaseLabel": "Peak Performance",
"dayInCycle": 6,
"daysUntilPeak": 2,
"daysUntilTrough": 16,
"daysUntilCritical": 9,
"trend": "rising",
"interpretation": "Your emotional sensitivity and creative energy are at their maximum. Empathy, compassion, and artistic inspiration flow naturally. Relationships feel deeply connected and communication carries genuine warmth."
},
"intellectual": {
"value": -28,
"rawValue": -0.2817,
"phase": "falling",
"phaseLabel": "Falling",
"dayInCycle": 19,
"daysUntilPeak": 23,
"daysUntilTrough": 6,
"daysUntilCritical": 15,
"trend": "falling",
"interpretation": "Your intellectual energy is declining. Concentration requires more effort and mental fatigue sets in faster. Focus on familiar tasks rather than learning new complex material."
},
"intuitive": {
"value": 0,
"rawValue": 0,
"phase": "critical_descending",
"phaseLabel": "Critical (Descending)",
"dayInCycle": 20,
"daysUntilPeak": 28,
"daysUntilTrough": 9,
"daysUntilCritical": 19,
"trend": "falling",
"interpretation": "Your intuitive cycle is crossing zero while descending. Gut feelings may be unreliable as this sense shifts into a quieter phase. Rely more heavily on logical analysis."
},
"aesthetic": {
"value": -36,
"rawValue": -0.3572,
"phase": "falling",
"phaseLabel": "Falling",
"dayInCycle": 25,
"daysUntilPeak": 29,
"daysUntilTrough": 8,
"daysUntilCritical": 19,
"trend": "falling",
"interpretation": "Your aesthetic sensitivity is declining. Creative inspiration requires more effort and beauty perception is less acute. Focus on technical execution rather than creative vision."
},
"awareness": {
"value": -38,
"rawValue": -0.3827,
"phase": "falling",
"phaseLabel": "Falling",
"dayInCycle": 46,
"daysUntilPeak": 14,
"daysUntilTrough": 38,
"daysUntilCritical": 3,
"trend": "rising",
"interpretation": "Your self-awareness is decreasing. Habitual patterns operate with less conscious oversight. You may react rather than respond to situations during this phase."
},
"spiritual": {
"value": 98,
"rawValue": 0.9786,
"phase": "peak",
"phaseLabel": "Peak Performance",
"dayInCycle": 16,
"daysUntilPeak": 50,
"daysUntilTrough": 24,
"daysUntilCritical": 12,
"trend": "peaking",
"interpretation": "Your spiritual connection is at its strongest. Inner peace, sense of purpose, and transcendent awareness are profoundly present. Meditation is deep, compassion flows naturally, and meaning feels tangible."
},
"passion": {
"value": 38,
"rawValue": 0.3824,
"phase": "rising",
"phaseLabel": "Rising",
"dayInCycle": 0,
"daysUntilPeak": 86,
"daysUntilTrough": 200,
"daysUntilCritical": 3,
"trend": "falling",
"interpretation": "Your passion is building as physical and emotional energies align in an upward trajectory. Interest and motivation are growing. Good time to revisit projects that inspire you."
},
"mastery": {
"value": -21,
"rawValue": -0.2089,
"phase": "falling",
"phaseLabel": "Falling",
"dayInCycle": 0,
"daysUntilPeak": 155,
"daysUntilTrough": 200,
"daysUntilCritical": 13,
"trend": "falling",
"interpretation": "Your mastery energy is declining. Physical and intellectual coordination is less reliable. Complex skill execution requires more conscious effort and produces more errors."
},
"wisdom": {
"value": 31,
"rawValue": 0.3096,
"phase": "rising",
"phaseLabel": "Rising",
"dayInCycle": 0,
"daysUntilPeak": 200,
"daysUntilTrough": 72,
"daysUntilCritical": 4,
"trend": "falling",
"interpretation": "Your wisdom is building as emotional and intellectual energies align upward. Judgment is improving and you are beginning to see situations with greater nuance and depth."
}
},
"energyRating": 6,
"overallPhase": "mixed",
"interpretation": "Your emotional sensitivity and creative energy are at their maximum. Empathy, compassion, and artistic inspiration flow naturally. Relationships feel deeply connected and communication carries genuine warmth.",
"advice": "Engage in creative work and meaningful conversations today.",
"criticalAlerts": []
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Drop-in UI components and no-code widgets.
Render Biorhythm API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Biorhythm API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Compatibility card widget snippet
Biorhythm chart widget snippet
The complete UI libraryExplore Roxy UI
Biorhythm chart widget snippetThe complete UI libraryExplore Roxy UIShow all Biorhythm UI componentsShow fewer Biorhythm UI components
| Element | Renders |
|---|---|
| <roxy-compatibility-card> | Score card with category breakdown |
| <roxy-biorhythm-chart> | Daily bars, forecast cycle lines, critical days |
Free templates for Biorhythm.
Clone. Edit. Ship. Free and open source by Team Roxy.
Astrology API Accuracy Benchmark
Benchmark / Open Source5 minIndependent proof, domain by domain. Every reference value cited, rerun monthly.
AstrologyVedicForecastHuman DesignFeng ShuiNumerology
Browse all templates or use AI prompts to generate a custom app.
What you can build with the Biorhythm API.
The products teams ship on the Biorhythm API.
- Reflective journaling apps: optional daily model curves and prompts, without inferring health or ability
- Dating and relationship platforms: compatibility scoring between two birth dates, daily relationship sync tracking, and shared cycle insights for couples
- Calendar displays: show model phases as an optional overlay, with scheduling based on availability and user preferences
- AI chatbots and virtual assistants: explain daily biorhythm model readings via MCP tool calls as optional reflection prompts
- Personal dashboards: explore the mathematical curves without using them to plan exercise, treatment or safety-critical work
- Content and editorial platforms: daily biorhythm columns for newsletters, personalized push notifications, and engagement widgets based on cycle states
All 6 endpoints, live in the playground.
Every one is live in the public OpenAPI spec and callable as an MCP tool. Click any endpoint to view detailed documentation, parameters, and response examples.
Get biorhythm reading - Complete cycle analysis for any dateCalculate a complete biorhythm reading for a given birth date and target date. Returns all 10 cycle values (physical, emotional, intellectual, intuitive, aesthetic, awareness, spiritual, passion, mastery, wisdom), phase detection with 8 distinct states, energy rating (1-10), overall phase assessment, editorial-grade interpretation, actionable advice, and critical day alerts. Perfect for wellness apps, dating platforms, productivity tools, and AI chatbot integrations that need structured biorhythm data.Get biorhythm forecast - Multi-day cycle predictions with best and worst daysGenerate a biorhythm forecast for a date range up to 90 days. Returns daily cycle values for physical, emotional, intellectual, and intuitive cycles, daily energy ratings, critical day identification, and a summary with best day, worst day, average energy, and period-level guidance. Ideal for wellness apps, productivity planners, scheduling tools, and calendar integrations that need forward-looking biorhythm data.Find critical days - Zero crossing detection for any date rangeFind all critical days (zero crossings) within a date range up to 180 days. Returns each critical day with cycle name, period, direction (ascending or descending), severity (single, double, or triple), and advisory text. Highlights rare double critical days where two primary cycles cross zero simultaneously and extremely rare triple critical days where all three primary cycles cross zero on the same date. Ideal for calendar integrations, push notification systems, alert engines, and wellness scheduling tools.Calculate compatibility - Biorhythm alignment between two peopleCalculate biorhythm compatibility between two people by overlaying their cycle profiles on a target date. Returns per-cycle alignment scores (0-100) for physical, emotional, and intellectual cycles, an overall compatibility score, relationship rating, strengths, challenges, practical advice, and a daily sync snapshot showing the absolute difference in each primary cycle. Perfect for dating apps, relationship platforms, team-building tools, and couples coaching applications.Get phase info - Lightweight cycle status for dashboards and widgetsGet current phase information for all 10 biorhythm cycles without the full interpretation payload. Returns value, phase name, phase label, day position within cycle, cycle period, days until next critical crossing, and short-term trend for each cycle. Includes a compact summary string. Designed as a lightweight endpoint for dashboards, widgets, status bars, and quick-check interfaces that need biorhythm phase data without editorial text.Get daily biorhythm - Seeded reading for daily check-in featuresGet a daily biorhythm reading with seeded randomness for consistent "biorhythm of the day" features. Same seed and same date always produce the same reading, perfect for daily push notifications, morning briefings, and wellness app check-ins. Returns energy rating, overall phase, a spotlight on one featured cycle, quick-read values for all three primary cycles, a daily message, and actionable advice. The spotlight cycle is deterministically selected by the seed, creating variety across users while maintaining consistency for each individual.
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.
Opens a live web search in a new tab.
From your AI agent to a verified Biorhythm answer.
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.
Audit it yourself: every Biorhythm endpoint runs live in the API playground
Biorhythm API questions, answered.
What is a biorhythm API?
The biorhythm API turns any birth date into the daily cycles that biorhythm theory tracks, with no calculator page to build and nothing to host. One key returns daily readings, multi day forecasts, critical day alerts, and two person compatibility, for entertainment and reflection. Model scores do not measure health, ability or decision quality. The same key also unlocks every other RoxyAPI domain and a Remote MCP server, so AI assistants like Claude Code, Cursor, and VS Code can call it with no Docker and no local setup.
How do I build a biorhythm calculator with an API?
Send a birth date and an optional target date and you get a complete reading back: every cycle as a value from negative 100 to positive 100, a named phase, an energy rating from 1 to 10, and editorial interpretation and advice written from the actual cycle states. Results are a pure deterministic calculation from the birth date, so the same inputs always return the same answer and you can cache freely. Drop in the typed SDKs for TypeScript, Python, PHP, C#, and Go, or the WordPress plugin and UI components, and the calculator needs no math of your own.
What biorhythm cycles does the API calculate?
It returns ten cycle types where most calculators ship only three. You get the three primary cycles, physical at 23 days, emotional at 28 days, and intellectual at 33 days, plus four secondary cycles, intuitive, aesthetic, awareness, and spiritual, and three composite cycles, passion, mastery, and wisdom. That depth lets a wellness or coaching product go far beyond the usual chart, all in a single call and in every language this API ships.
What are biorhythm critical days and can I detect them?
Critical days are dates a model cycle crosses zero and flips between its positive and negative halves. The biorhythm API scans any date range and flags each crossing with its cycle, direction, and a single, double, or triple severity based on how many primary cycles turn on the same day. These are mathematical transition labels, not predictions of accident risk or a basis for medical, financial or safety decisions.
How does biorhythm compatibility work?
Pass two birth dates and a target date and the biorhythm API overlays both sets of cycles into a per cycle alignment score, an overall score from 0 to 100, a clear rating, and written strengths, challenges, and advice. It is a natural fit for dating apps and couples features, for exploring how two model curves align, without predicting relationship outcomes or personal capacity. Because it is a deterministic calculation, every pairing is reproducible and instantly cacheable.
Can I get a multi day biorhythm forecast with best and worst days?
Yes. Give a birth date and a date range and the biorhythm API returns a day by day forecast with an energy rating for each day, then names the best day, the worst day, the number of critical days, and overall guidance for the window. Calendar interfaces can display these model labels alongside user-selected plans. The same forecast is available through the Remote MCP server, so AI agents can display the model without any local server install. Scheduling decisions should follow actual circumstances, not the curve.
Start using Biorhythm API today.
Biorhythm cycles past the classic three, with critical days graded by how many cycles cross at once.
All 18 domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key