Biorhythm Api

Biorhythm API

Biorhythm API

10 cycle types, critical day alerts, compatibility, and multi-day forecasts. One key covers 18+ spiritual domains. MCP-first, no local setup required.

Get API Key Try Live Cycles MCP Server SDK

What is Biorhythm API

The RoxyAPI biorhythm endpoint ships 10 cycle types (physical, emotional, intellectual, intuitive, aesthetic, awareness, spiritual, passion, mastery, wisdom) where most implementations stop at three. Cycles are pure deterministic math anchored on the days-since-birth count, seedable for per-user determinism, with no ephemeris dependency. One RoxyAPI subscription covers 18+ spiritual domains: Western astrology, Vedic astrology, Forecast, Human Design, Chinese astrology, Feng Shui, Mesoamerican astrology, Vastu, numerology, Kabbalah, tarot, biorhythm, Ayurveda, I Ching, crystals, dreams, angel numbers, and location. This repo ships working TypeScript, JavaScript, and Python samples so you can drop biorhythm features into a wellness, productivity, or coaching product in minutes.

Why this API

Property	Value
Coverage	18+ spiritual domains in one subscription
Calculation	Deterministic cycle math, seedable for per-user determinism, no ephemeris dependency
MCP server	https://roxyapi.com/mcp/biorhythm (Streamable HTTP, no local setup)
SDKs	TypeScript on npm @roxyapi/sdk, Python on PyPI roxy-sdk, PHP on Packagist roxyapi/sdk, C# on NuGet RoxyApi.Sdk, Go github.com/RoxyAPI/sdk-go, WordPress plugin roxyapi
Pricing	One key, flat per call, from $39/mo
Licensing	Personal and commercial use, including closed source apps. No AGPL or GPL entanglement. Full terms
Last verified	2026-Q3

Quick start

1. Get a key at roxyapi.com/pricing
2. Pick a language below
3. Copy the snippet, run, ship

cURL

curl -X POST https://roxyapi.com/api/v2/biorhythm/daily \
  -H "X-API-Key: $ROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed":"sample-user","date":"2026-04-23"}'

Python

import os
from roxy_sdk import create_roxy

roxy = create_roxy(os.environ["ROXY_API_KEY"])

# Daily biorhythm: seeded reading with energy rating and cycle snapshot across 10 cycle types
bio = roxy.biorhythm.get_daily_biorhythm(seed="sample-user", date="2026-04-23")

print(bio["energyRating"])                       # 5
print(bio["overallPhase"])                       # critical
print(bio["quickRead"]["physical"])              # -73
print(bio["quickRead"]["emotional"])             # 0
print(bio["quickRead"]["intellectual"])          # 62
print(bio["spotlight"]["cycle"])                 # physical
print(bio["spotlight"]["value"])                 # -73

JavaScript (Node)

import { createRoxy } from '@roxyapi/sdk';

const roxy = createRoxy(process.env.ROXY_API_KEY);

// Daily biorhythm reading: energy rating, phase, and three primary cycle values
const { data, error } = await roxy.biorhythm.getDailyBiorhythm({
  body: { seed: 'sample-user', date: '2026-04-23' },
});

if (error) throw new Error(error.error);

console.log('Energy rating:', data.energyRating);            // 5
console.log('Overall phase:', data.overallPhase);            // critical
console.log('Physical cycle:', data.quickRead.physical);     // -73
console.log('Spotlight cycle:', data.spotlight.cycle);       // physical
console.log('Daily advice:', data.advice);

TypeScript

import { createRoxy } from '@roxyapi/sdk';

const roxy = createRoxy(process.env.ROXY_API_KEY!);

// Daily biorhythm: seeded reading returns energy rating, phase, spotlight, and quickRead cycles
const { data, error } = await roxy.biorhythm.getDailyBiorhythm({
  body: { seed: 'sample-user', date: '2026-04-23' },
});

if (error) throw new Error(error.error);

console.log('Energy rating:', data.energyRating);            // 5
console.log('Overall phase:', data.overallPhase);            // critical
console.log('Physical:', data.quickRead.physical);           // -73
console.log('Emotional:', data.quickRead.emotional);         // 0
console.log('Intellectual:', data.quickRead.intellectual);   // 62
console.log('Spotlight:', data.spotlight.cycle, data.spotlight.value);

Request schema

Field	Type	Required	Description
seed	string	no	Reproducibility key. Same seed plus same date always returns the same reading. Pass any stable identifier such as a user ID or email hash. Omit for anonymous daily readings.
date	string	no	Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for historical lookups or pre-generating future readings.

Response shape

{
  "date": "2026-04-23",
  "seed": "sample-user-2026-04-23",
  "energyRating": 5,
  "overallPhase": "critical",
  "spotlight": {
    "cycle": "physical",
    "value": -73,
    "phase": "low",
    "message": "Your physical energy is significantly diminished..."
  },
  "quickRead": {
    "physical": -73,
    "emotional": 0,
    "intellectual": 62
  },
  "dailyMessage": "Your biorhythm for 2026-04-23: Energy rating 5/10 (Balanced). Physical cycle is low energy at -73%.",
  "advice": "Prioritize rest and recovery. Save demanding tasks for a higher energy phase."
}

Field	Type	Description
date	string	Date the reading is computed for (YYYY-MM-DD, UTC)
seed	string	Computed seed used for this reading. Same value always produces the same output.
energyRating	number	Overall energy score from 1 to 10
overallPhase	string	Summary phase: high_energy, mixed, recovery, or critical
spotlight	object	Featured cycle for this seed: cycle name, value (-100 to 100), phase, and message
quickRead.physical	number	Physical cycle value (-100 to 100)
quickRead.emotional	number	Emotional cycle value (-100 to 100)
quickRead.intellectual	number	Intellectual cycle value (-100 to 100)
dailyMessage	string	Concise daily message combining energy rating and spotlight cycle
advice	string	Actionable 1-2 sentence guidance for the day

Common use cases

Use case	Endpoint flow
Daily wellness check-in for a mobile app	POST /biorhythm/daily with the user ID as seed and today as date
Pre-generate tomorrow notification copy	POST /biorhythm/daily with tomorrow as date; cache and send at 07:00 local time
Best-day planner for a coaching product	POST /biorhythm/forecast with birthDate, startDate, endDate; surface summary.bestDay
Critical day alerts for a sports or medical app	POST /biorhythm/critical-days with birthDate; filter criticalDays[].severity
Couples biorhythm compatibility	POST /biorhythm/compatibility with two birthDate values; read overallScore and rating

Related endpoints in this domain

• POST /biorhythm/forecast (getForecast) - multi-day best-day and worst-day planner with full 10-cycle data per day
• POST /biorhythm/critical-days (getCriticalDays) - zero-crossing alert days for sports, medical, and productivity caution features
• POST /biorhythm/compatibility (calculateBioCompatibility) - couples and team dynamics compatibility score across all cycle types

Use this in your AI agent

Connect Claude, GPT, Gemini, or Cursor to RoxyAPI through the remote MCP server. No Docker. No self hosting. The full MCP tool catalog for this domain is at https://roxyapi.com/mcp/biorhythm.

{
  "mcpServers": {
    "biorhythm": {
      "url": "https://roxyapi.com/mcp/biorhythm",
      "headers": { "X-API-Key": "$ROXY_API_KEY" }
    }
  }
}

See docs/mcp for Claude Desktop, Cursor, Windsurf, VS Code, and Claude Code setup.

For AI coding agents

This repo ships an AGENTS.md execution playbook. Cursor, Claude Code, Aider, Codex, Windsurf, RooCode, and Gemini CLI will pick it up automatically. Top level overview lives at roxyapi.com/AGENTS.md.

Resources

• Methodology and gold standard tests catalog-wide testing surface (cycle math here, JPL Horizons for the ephemeris-driven domains)
• Full API reference interactive Scalar UI
• TypeScript SDK on npm
• Python SDK on PyPI
• PHP SDK on Packagist
• C# SDK on NuGet
• Go SDK on pkg.go.dev
• WordPress plugin
• llms.txt full LLM citation index
• Top level AGENTS.md

Other RoxyAPI samples

KP Astrology API Kundli API Synastry API Natal Chart API Numerology API

License

MIT for this sample repo. See LICENSE.

Catalog licensing: Personal and commercial use, including closed source proprietary apps. No AGPL or GPL entanglement. RoxyAPI APIs and SDKs are safe to embed in commercial products. Full terms at roxyapi.com/policy/license.

Contact

• Site: roxyapi.com
• Status: roxyapi.com/api-reference