POST/v1/western/biorhythm

Biorhythm Cycles

Computes physical (23-day), emotional (28-day), and intellectual (33-day) biorhythm cycles for a birth date. Returns cycle values (-1.0 to +1.0), percentage, phase label (High above +0.5, Low below -0.5, otherwise Rising or Falling by the curve's direction), trend, and critical day flags. Critical days occur when a cycle crosses zero — these represent instability and vulnerability to poor judgment. Supports single-day and multi-day (up to 90 days) range requests. Formula: sin(2π × t / cycle_length) where t = days since birth. Source: Wilhelm Fliess (1897) physical cycle; Hermann Swoboda (1900) emotional cycle; Alfred Teltscher (1926) intellectual cycle.

Request parameters

birth_daterequired

string (date)

Date of birth in YYYY-MM-DD format.

target_dateoptional

string (date) | null

Date to compute cycles for. Defaults to today.

daysoptional

integer

Number of consecutive days to compute (1-90). Use 1 for a single day snapshot. Use >1 for a date range.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

BiorhythmSingleDayResponse | BiorhythmRangeResponse

The endpoint response payload

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Eclipses
• Western Moon Phase
• Western Moon Phase Calendar
• Planetary hours
• Void-of-course Moon
• Western day view

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/western/biorhythm" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"1985-11-12","target_date":"2026-01-01","days":1}'

Python

import asterwise
from asterwise.api.western_api import WesternApi
from asterwise.models.biorhythm_request import BiorhythmRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = BiorhythmRequest(
    birth_date="1985-11-12",
    target_date="2026-01-01",
    days=1,
)

with asterwise.ApiClient(configuration) as client:
    api = WesternApi(client)
    result = api.western_biorhythm(biorhythm_request=request)
    print(result)

TypeScript

import { createClient, createConfig, westernBiorhythm } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await westernBiorhythm({
  client,
  body: {
      "birth_date": "1985-11-12",
      "target_date": "2026-01-01",
      "days": 1
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "birth_date": "1985-11-12",
    "target_date": "2026-01-01",
    "days_since_birth": 14660,
    "cycles": {
      "physical": {
        "value": 0.631088,
        "percentage": 63.11,
        "phase": "High",
        "trend": "falling",
        "is_critical": false,
        "cycle_length_days": 23,
        "description": "Physical stamina, strength, coordination, and resilience. Source: Wilhelm Fliess (1897)."
      },
      "emotional": {
        "value": -0.433884,
        "percentage": -43.39,
        "phase": "Falling",
        "trend": "falling",
        "is_critical": false,
        "cycle_length_days": 28,
        "description": "Emotional sensitivity, creativity, mood, and awareness. Source: Hermann Swoboda (1900)."
      },
      "intellectual": {
        "value": 0.998867,
        "percentage": 99.89,
        "phase": "High",
        "trend": "rising",
        "is_critical": false,
        "cycle_length_days": 33,
        "description": "Analytical ability, logical thinking, and memory. Source: Alfred Teltscher (1926)."
      }
    },
    "critical_today": [],
    "has_critical_day": false,
    "composite_score": 0.39869,
    "note": "Biorhythm is a Western concept (Fliess/Swoboda). Vedic equivalent: Tarabala and Chandrabala measure daily auspiciousness…"
  }
}