{
  "date_range": "1 BCE (-1) to 2500 CE",
  "endpoints": {
    "/aspects": "POST - Calculate aspects between planets",
    "/chart": "POST - Full natal chart calculation",
    "/cross-aspects": "POST - Calculate aspects between two charts",
    "/health": "GET - Health check",
    "/location-timezone": "POST - Get timezone info for city/state/country",
    "/planets": "POST - Calculate planetary positions (standard)",
    "/planets-enhanced": "POST - Calculate planetary positions with native timezone handling",
    "/synastry-analysis": "POST - Compare two charts for compatibility",
    "/transit-analysis": "POST - Compare transits to natal chart"
  },
  "example_enhanced_request": {
    "city": "New York",
    "country": "USA",
    "day": 15,
    "hour": 14,
    "house_system": "placidus",
    "minute": 30,
    "month": 6,
    "second": 0,
    "state": "NY",
    "year": 1990,
    "zodiac": "tropical"
  },
  "example_location_request": {
    "city": "Los Angeles",
    "country": "USA",
    "state": "CA"
  },
  "example_planets_request": {
    "day": 14,
    "hour": 14,
    "house_system": "placidus",
    "latitude": 40.73,
    "longitude": -73.83,
    "minute": 54,
    "month": 6,
    "timezone": "America/New_York",
    "year": 1946,
    "zodiac": "tropical"
  },
  "example_synastry_request": {
    "orb_settings": {
      "Mars": 6,
      "Venus": 8
    },
    "person1": {
      "day": 15,
      "hour": 14,
      "latitude": 40.7128,
      "longitude": -74.006,
      "minute": 30,
      "month": 6,
      "timezone": "America/New_York",
      "year": 1990
    },
    "person2": {
      "day": 22,
      "hour": 8,
      "latitude": 34.0522,
      "longitude": -118.2437,
      "minute": 45,
      "month": 3,
      "timezone": "America/Los_Angeles",
      "year": 1985
    }
  },
  "example_transit_request": {
    "natal_chart": {
      "day": 15,
      "hour": 14,
      "house_system": "placidus",
      "latitude": 40.7128,
      "longitude": -74.006,
      "minute": 30,
      "month": 6,
      "timezone": "America/New_York",
      "year": 1990,
      "zodiac": "tropical"
    },
    "orb_settings": {
      "Mars": 7,
      "Moon": 10,
      "Sun": 10
    },
    "transit_date": "2024-01-15T12:00:00Z"
  },
  "name": "Swiss Ephemeris API",
  "new_features": {
    "applying_separating": "Determine if aspects are applying or separating",
    "aspect_strength": "Calculate relative strength based on orb tightness",
    "cross_aspects": "Calculate aspects between any two sets of planetary positions",
    "historical_precision": "Reliable manual conversion for dates pre-1940 (proven accuracy)",
    "hybrid_precision": "Automatic precision optimization based on date era",
    "location_lookup": "Automatic timezone detection from city/state/country",
    "modern_precision": "Native Swiss Ephemeris conversion for dates 1940+ (maximum accuracy)",
    "precise_orbs": "Configurable orb settings for different planets",
    "precision_metadata": "Shows which calculation method was used and why",
    "synastry_analysis": "Calculate compatibility aspects between two birth charts",
    "transit_analysis": "Compare current planetary transits to natal chart positions",
    "ultra_precision": "8 decimal place precision for house cusps and planetary positions"
  },
  "notes": "All calculations converted to Universal Time (UT) internally",
  "precision_eras": {
    "automatic_selection": "System automatically chooses optimal method based on input date",
    "historical_era": "Pre-1940 uses reliable manual UTC conversion (proven for ancient dates)",
    "modern_era": "1940+ uses native Swiss Ephemeris utc_to_jd() for maximum precision"
  },
  "supported_house_systems": [
    "placidus",
    "whole-sign",
    "campanus"
  ],
  "supported_timezone_formats": [
    "UTC",
    "GMT",
    "\u00b1HH:MM (e.g., +05:30, -08:00)",
    "\u00b1HHMM (e.g., +0530, -0800)",
    "\u00b1H (e.g., +5, -8)",
    "Named zones (America/New_York, Europe/London)",
    "Abbreviations (EST, PST, CET, JST, etc.)"
  ],
  "supported_zodiac_systems": [
    "tropical",
    "lahiri (vedic)"
  ],
  "version": "1.1.0"
}