Biorhythm API

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

Daily BiorhythmBiorhythm ForecastCompatibilityCritical Days …and so much more

<5mslatency
99.9%uptime

Start building in seconds.

Want to try without writing code? Try this domain live in API playground →

Terminal
npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.biorhythm.get(/* ... */)
SDK docs

Want to ship faster? Clone a free template and go from zero to production in 30 minutes.

Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.

Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.

POST /api/v2/biorhythm/daily
{
  "date": "2026-05-23",
  "seed": "2026-05-23",
  "energyRating": 9,
  "overallPhase": "high_energy",
  "spotlight": {
    "cycle": "intellectual",
    "value": 95,
    "phase": "peak",
    "message": "Your intellectual cycle is at its peak. Mental clarity, analytical thinking, and problem-solving ability are at maximum. Memory retention is sharp and complex ideas feel manageable."
  },
  "quickRead": {
    "physical": 89,
    "emotional": 43,
    "intellectual": 95
  },
  "dailyMessage": "Your biorhythm for 2026-05-23: Energy rating 9/10 (Peak Performance). Intellectual cycle is peak performance at 95%.",
  "advice": "Tackle your most complex challenges now. Your mind is at its sharpest."
}

Structured JSON with documented fields. Not hallucinated text. See all endpoints

Works with your stack

Claude CodeCursorAntigravityChatGPTWindsurfVS Code CopilotOpenAI AgentsGeminiLangChainCrewAIVercel AI SDK

The most complete biorhythm API: 10 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 seeded daily readings for push notifications. 8 languages, sub-millisecond responses, and editorial-grade interpretations. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. Ship a biorhythm feature in hours, not weeks.

Every Biorhythm calculation is verified against NASA JPL Horizons across 828 gold-standard tests, with a public MIT benchmark repo anyone can clone and re-run. See how we test.

Multi-language API responses

EnglishDeutschEspanolFrancaisHindiPortuguesRusskiyTurkce

Key Features

Everything you need from our Biorhythm API, built for production:

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 planning guidance

Seeded daily readings: same seed and date always return the same reading, 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

Pure math, zero external dependencies, deterministic results, sub-millisecond calculations verified against authoritative biorhythm calculators

All Endpoints

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.

Drop-in UI components

Render Biorhythm responses without building charts yourself. These open source, framework-agnostic web components take the typed API response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

MIT licensedFramework agnosticThemeable via CSS variablesjsDelivr CDN
ElementRenders
<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.

AI spiritual voice assistant template with embeddable voice widget for astrology, tarot, numerology, and Vedic readings powered by RoxyAPI

AI Spiritual Voice Assistant

Web App / Open Source30 min

Talk to the stars. Real readings across every spiritual domain, spoken aloud.

VoiceAstrologyVedicTarotNumerologyHuman Design

Browse all templates or use AI prompts to generate a custom app.

What You Can Build with Biorhythm API

Real-world applications and use cases for integrating Biorhythm API into your projects:

Wellness and self-care apps: daily biorhythm check-ins, energy tracking, recovery scheduling, and personalized wellness calendars based on cycle phases

Dating and relationship platforms: compatibility scoring between two birth dates, daily relationship sync tracking, and shared cycle insights for couples

Productivity and scheduling tools: identify peak intellectual days for complex work, flag low-energy days for light tasks, and generate weekly energy forecasts for time blocking

AI chatbots and virtual assistants: daily biorhythm readings via MCP tool calls, energy level queries, and biorhythm context for wellness coaching conversations

Fitness and athletic platforms: physical cycle tracking for training periodization, peak coordination days for competition, and recovery phase scheduling

Content and editorial platforms: daily biorhythm columns for newsletters, personalized push notifications, and engagement widgets based on cycle states

What developers are saying

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

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

Every page here is built so AI search engines can read and cite it, so go straight to the source. 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.

Getting started with Biorhythm API.

From zero to production in 3 steps. No signup required for testing.

3 Steps to Ship

1Install the SDKnpm i @roxyapi/sdk
2Get your API keyView Plans
3Make your first callView Docs

Agent-Ready Infrastructure

MCP

Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.

  • Remote MCP server — every endpoint auto-discovered as a tool by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
  • AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.

From your AI agent to a verified Biorhythm answer.

Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setup
Roxy Ephemeris828 tests vs NASA JPL
Verified result12 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.

Audit it yourself: every Biorhythm endpoint runs live in the API playground

Biorhythm API FAQ

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, so you can ship a wellness, productivity, dating, or fitness timing feature in hours. The same key also unlocks 11 more spiritual data domains and a Remote MCP server, so AI assistants like Claude Code, Cursor, and VS Code can call it in seconds 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, or PHP, or the WordPress plugin and UI components, and a working calculator is live the same day.

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 across eight languages.

What are biorhythm critical days and can I detect them?

Critical days are the dates a cycle crosses its midpoint and flips between its high and low halves, which biorhythm theory treats as caution days for big decisions, travel, or peak physical effort. 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. It is the timing signal sports, productivity, and wellness apps use to tell users when to push and when to ease off.

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, couples features, and team scheduling, where two people want to know when their energy lines up. 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. That makes it a drop in planning layer for calendars, planners, and coaching tools. The same forecast is available through the Remote MCP server, so AI agents can plan a user week without any local install.

Start using Biorhythm API today.

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

All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo — thats $3.25 per domain. No credit card required for testing.

View Pricing & Get API Key