Biorhythm API
Ship a biorhythm feature your users will love. This week.
Start building in seconds.
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.biorhythm.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.biorhythm.get(...) # async: await roxy.biorhythm.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->biorhythm->get(/* ... */);curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/biorhythm/claude mcp add --transport http \
roxy-biorhythm https://roxyapi.com/mcp/biorhythm \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all 6 endpoints as callable tools. Zero configuration.
Want to ship faster? Clone a free starter app 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.
{
"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 6 endpoints
Works with your stack
The most complete biorhythm API + remote MCP for AI agents and developers. Hosted MCP server, no local setup, connect Claude Code, Cursor, VS Code in seconds. 10 cycle types: 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 day identification, two-person compatibility scoring, phase tracking for dashboards, and seeded daily readings for push notifications. 6 endpoints, 8 languages, sub-millisecond response times, editorial-grade interpretations. Ship a biorhythm feature in hours, not weeks.
Multi-language API responses
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 6 Endpoints
Click any endpoint to view detailed documentation, parameters, and response examples.
Get biorhythm reading - Complete cycle analysis for any date
Calculate 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 days
Generate 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 range
Find 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 people
Calculate 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 widgets
Get 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 features
Get 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.
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
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.
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.
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.
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 SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Agent-Ready Infrastructure
MCPRemote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.
- Remote MCP server — 6 tools auto-discovered 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.
Start using Biorhythm API today.
Ship a biorhythm feature your users will love. This week.
All 12 domains included with every plan. 6+ endpoints, 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