Biorhythm API
Ship a biorhythm feature your users will love. This week.
Start building in seconds
npm install @roxyapi/sdkimport Roxy from '@roxyapi/sdk'
const roxy = new Roxy({ apiKey: 'your-key' })
const data = await roxy.biorhythm.get(/* ... */)curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/biorhythm/claude mcp add --transport http \
roxy-biorhythm-api https://roxyapi.com/mcp/biorhythm-api \
--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.
{
"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."
}
},
"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 6 endpoints
Works with your stack
Multi-language API responses
The most complete biorhythm calculations API available. 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.
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 in 3 days. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they are spot on. 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.
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
MCPThe only MCP server covering 10 spiritual domains under one key
- MCP server — 6 tools auto-discovered by Claude, ChatGPT, Cursor
- llms.txt — AI-native documentation for code generation
- AGENTS.md — Included in SDK for GitHub Copilot, Windsurf, Cline
Start Using Biorhythm API Today
Ship a biorhythm feature your users will love. This week.
All 10 domains included with every plan. 6+ endpoints, MCP server, SDK, and starters.
Plans from $39/mo — thats $3.90 per domain. No credit card required for testing.
View Pricing & Get API Key