{"openapi":"3.1.0","info":{"title":"Astrology API v3","description":"\n# 🌟 Astrology API v3.2.10 - Professional Astrological Service\n\n**Modern astrological calculations powered by Swiss Ephemeris with comprehensive interpretations and analysis tools.**\n\n## 🚀 **Core Features**\n- **High-precision calculations** - Swiss Ephemeris accuracy with 23 house systems\n- **Traditional astrology** - Hellenistic techniques, dignities, profections, lots\n- **Comprehensive reports** - Natal charts, synastry, transits with detailed interpretations\n- **Business insights** - Team dynamics, compatibility analysis, career guidance\n- **Pet astrology** - Animal personality and care insights\n- **Multiple languages** - Support for EN, RU, FR, DE, ES and more\n- **Fast performance** - 50-500ms response times with intelligent caching\n\n## 📱 **Perfect for**\nProfessional astrologers, mobile apps, educational platforms, research projects, and business consulting tools.\n\n## 📚 **Documentation**\n- **[🚀 RapiDoc](/rapidoc)** - Interactive documentation with live examples\n- **[📥 Postman Collection](/best-astrology-api-postman.json)** - 113 ready-to-use examples\n- **[❓ FAQ & Help](/docs/faq)** - Troubleshooting and implementation guides\n\n**🌟 Quick start: `/api/v3/glossary/active-points`**\n ","version":"3.2.10"},"servers":[{"url":"https://api.astrology-api.io","description":"Production API"},{"url":"http://localhost:8000","description":"Local development"}],"paths":{"/api/v3/data/now":{"get":{"tags":["📊 Raw Data & Positions"],"summary":"Current Time Data","description":"Gets astrological data for the current UTC time.","operationId":"get_now_api_v3_data_now_get","responses":{"200":{"description":"Current UTC time data for immediate astrological calculations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subject-Output"},"example":{"name":"Current UTC Time","birth_data":{"year":2024,"month":9,"day":1,"hour":14,"minute":30,"second":0,"latitude":0.0,"longitude":0.0,"timezone":"UTC"}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error - check field formats"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/data/now\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/now\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/now\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/now\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/now\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/positions":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"Planetary Positions","description":"📊 **Planetary Positions Calculator** - Get precise celestial body positions\n\n**Perfect for:**\n- 🎯 Quick planetary position lookups\n- 📱 Mobile app backends requiring fast data\n- 🔄 Real-time astrological applications\n- 📊 Data analysis and research\n\n**What you get:**\n- **Precise positions** for all requested celestial bodies\n- **Zodiac signs** (3-letter codes: Ari, Tau, Gem, etc.)\n- **Degrees within signs** (0.0 to 29.99)\n- **Absolute longitude** (0-360° full zodiac position)\n- **Retrograde status** for all planets\n- **Planetary speed** (degrees per day)\n\n**Supported celestial bodies:**\n- **Planets**: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto\n- **Lunar Nodes**: Mean_Node, True_Node, Mean_South_Node, True_South_Node\n- **Angles**: Ascendant, Medium_Coeli, Descendant, Imum_Coeli\n- **Points**: Mean_Lilith, True_Lilith, Pars_Fortunae, Vertex\n- **Asteroids**: Chiron, Ceres, Pallas, Juno, Vesta\n\n**Location handling:**\n- Provide city + country_code for automatic geocoding\n- Or use exact latitude/longitude coordinates\n- Timezone automatically detected or specify manually\n\n**Response time:** ~100ms | **Accuracy:** Swiss Ephemeris precision\n- ✅ **City geocoding** - just provide city name, we handle coordinates & timezone\n\nPerfect for applications needing precise astronomical data without interpretations.","operationId":"planetary_positions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataRequest"},"examples":{"basic_positions":{"summary":"Basic Planetary Positions","description":"Standard planetary positions with main planets and moderate precision","value":{"subject":{"name":"Emma Johnson","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","language":"en","tradition":"universal","detail_level":"standard","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2}}},"extended_precision":{"summary":"High Precision Extended Points","description":"All planets, asteroids, and special points with maximum precision","value":{"subject":{"name":"Precision Seeker","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":30,"latitude":48.8566,"longitude":2.3522}},"options":{"house_system":"W","language":"en","tradition":"universal","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Chiron","Ceres","Pallas","Juno","Vesta","Mean_Node","True_Node","Mean_Lilith","True_Lilith","Ascendant","Medium_Coeli"],"precision":6}}},"traditional_points":{"summary":"Traditional Astrology Points","description":"Focus on traditional points including Arabic Parts and nodes","value":{"subject":{"name":"Traditional Astrologer","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Athens","country_code":"GR"}},"options":{"house_system":"W","language":"en","tradition":"classical","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Mean_South_Node","True_South_Node","Part_of_Fortune","Part_of_Spirit","Ascendant","Medium_Coeli","Vertex"],"precision":4}}},"sidereal_calculation":{"summary":"Sidereal Zodiac Positions","description":"Vedic/Sidereal zodiac calculation with traditional points","value":{"subject":{"name":"Vedic Practitioner","birth_data":{"year":1988,"month":3,"day":25,"hour":12,"minute":0,"second":0,"city":"Varanasi","country_code":"IN"}},"options":{"house_system":"A","language":"en","tradition":"vedic","detail_level":"standard","zodiac_type":"Sidereal","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":3}}}}}},"required":true},"responses":{"200":{"description":"Precise planetary positions with coordinates, houses, and motion data","content":{"application/json":{"schema":{},"examples":{"comprehensive_positions":{"summary":"Complete planetary positions with all data","description":"Example showing precise positions for main planets with retrograde motion, house placements, and speed calculations","value":{"positions":[{"name":"Sun","sign":"Tau","degree":20.8231,"absolute_longitude":50.8231,"house":8,"is_retrograde":false,"speed":0.9657},{"name":"Moon","sign":"Aqu","degree":19.2119,"absolute_longitude":319.2119,"house":4,"is_retrograde":false,"speed":12.6633},{"name":"Mercury","sign":"Ari","degree":26.3845,"absolute_longitude":26.3845,"house":7,"is_retrograde":false,"speed":1.4017},{"name":"Venus","sign":"Ari","degree":10.7354,"absolute_longitude":10.7354,"house":6,"is_retrograde":false,"speed":0.5265},{"name":"Mars","sign":"Gem","degree":10.4993,"absolute_longitude":70.4993,"house":8,"is_retrograde":false,"speed":0.6851},{"name":"Jupiter","sign":"Aqu","degree":16.0419,"absolute_longitude":316.0419,"house":4,"is_retrograde":false,"speed":0.0746},{"name":"Saturn","sign":"Sco","degree":25.1425,"absolute_longitude":235.1425,"house":2,"is_retrograde":true,"speed":-0.0746}]}},"angles_and_nodes":{"summary":"Chart angles and lunar nodes","description":"Example showing Ascendant, Midheaven, and North/South Node positions","value":{"positions":[{"name":"Ascendant","sign":"Lib","degree":21.0032,"absolute_longitude":201.0032,"house":1,"is_retrograde":false},{"name":"Medium_Coeli","sign":"Can","degree":27.2303,"absolute_longitude":117.2303,"house":10,"is_retrograde":false},{"name":"Mean_Node","sign":"Ari","degree":18.2327,"absolute_longitude":18.2327,"house":7,"is_retrograde":true,"speed":-0.053},{"name":"Mean_South_Node","sign":"Lib","degree":18.2327,"absolute_longitude":198.2327,"house":1,"is_retrograde":true,"speed":0.053}]}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error - check field formats"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/positions\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/positions\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/positions\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/positions\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/positions\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/house-cusps":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"House Cusps","description":"🏠 **House Cusps Calculator** - Precise astrological house boundaries\n\n**Perfect for:**\n- 🎯 House system comparisons and analysis\n- 📱 Chart calculation backends\n- 🔄 Real-time house position tracking\n- 📊 Astrological research and education\n\n**What you get:**\n- **All 12 house cusps** with precise degree positions\n- **Zodiac signs** for each house cusp (3-letter codes: Ari, Tau, Gem, etc.)\n- **Degrees within signs** (0.0 to 29.99)\n- **Absolute longitude** (0-360° full zodiac position)\n- **House system flexibility** - 23+ systems supported\n\n**Supported house systems:**\n- **P** (Placidus) - Most popular modern system\n- **W** (Whole Sign) - Traditional/Hellenistic system\n- **K** (Koch), **E** (Equal), **C** (Campanus)\n- Plus 18 additional systems - see `/api/v3/glossary/house-systems`\n\n**Location handling:**\n- Provide city + country_code for automatic geocoding\n- Or use exact latitude/longitude coordinates\n- Timezone automatically detected or specify manually\n\n**Note:** House cusps are location-dependent and require precise birth coordinates.\nThis endpoint provides the foundation for accurate house-based interpretations.\n\n**Response time:** ~120ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_house_cusps_api_v3_data_house_cusps_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataRequest"},"examples":{"placidus_system":{"summary":"Placidus House System","description":"Most popular modern house system with unequal houses","value":{"subject":{"name":"House Explorer","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":4}}},"whole_sign_traditional":{"summary":"Whole Sign Houses","description":"Traditional Hellenistic system with equal 30° houses","value":{"subject":{"name":"Traditional Scholar","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Athens","country_code":"GR"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Ascendant","Medium_Coeli","Descendant","Imum_Coeli"],"precision":2}}},"koch_system":{"summary":"Koch House System","description":"Popular European house system with time-based calculations","value":{"subject":{"name":"European Astrologer","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"latitude":48.8566,"longitude":2.3522}},"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Ascendant","Medium_Coeli"],"precision":3}}},"equal_houses":{"summary":"Equal House System","description":"Simple system with equal 30° houses from Ascendant","value":{"subject":{"name":"Equal House User","birth_data":{"year":1988,"month":3,"day":25,"hour":12,"minute":0,"second":0,"city":"Mumbai","country_code":"IN"}},"options":{"house_system":"A","zodiac_type":"Sidereal","active_points":["Ascendant","Medium_Coeli"],"precision":2}}}}}},"required":true},"responses":{"200":{"description":"Precise astrological house boundaries with zodiac signs and degrees","content":{"application/json":{"schema":{},"examples":{"placidus_system_cusps":{"summary":"Placidus house system cusps","description":"Complete set of 12 house cusps using Placidus system with precise degrees","value":{"cusps":[{"house":1,"sign":"Lib","degree":21.0032},{"house":2,"sign":"Sco","degree":17.467},{"house":3,"sign":"Sag","degree":20.0036},{"house":4,"sign":"Cap","degree":27.2303},{"house":5,"sign":"Pis","degree":1.6879},{"house":6,"sign":"Pis","degree":29.4227},{"house":7,"sign":"Ari","degree":21.0032},{"house":8,"sign":"Tau","degree":17.467},{"house":9,"sign":"Gem","degree":20.0036},{"house":10,"sign":"Can","degree":27.2303},{"house":11,"sign":"Vir","degree":1.6879},{"house":12,"sign":"Vir","degree":29.4227}]}},"whole_sign_cusps":{"summary":"Whole sign house system cusps","description":"Traditional whole sign houses where each house equals one complete zodiac sign","value":{"cusps":[{"house":1,"sign":"Lib","degree":0.0},{"house":2,"sign":"Sco","degree":0.0},{"house":3,"sign":"Sag","degree":0.0},{"house":4,"sign":"Cap","degree":0.0},{"house":5,"sign":"Aqu","degree":0.0},{"house":6,"sign":"Pis","degree":0.0},{"house":7,"sign":"Ari","degree":0.0},{"house":8,"sign":"Tau","degree":0.0},{"house":9,"sign":"Gem","degree":0.0},{"house":10,"sign":"Can","degree":0.0},{"house":11,"sign":"Leo","degree":0.0},{"house":12,"sign":"Vir","degree":0.0}]}},"intercepted_houses":{"summary":"Houses with interceptions","description":"Example showing houses with intercepted signs (signs contained entirely within a house)","value":{"cusps":[{"house":1,"sign":"Sag","degree":15.2341},{"house":2,"sign":"Aqu","degree":8.7892},{"house":3,"sign":"Pis","degree":22.5567},{"house":4,"sign":"Ari","degree":29.1234},{"house":5,"sign":"Tau","degree":16.8901},{"house":6,"sign":"Gem","degree":3.4567},{"house":7,"sign":"Gem","degree":15.2341},{"house":8,"sign":"Leo","degree":8.7892},{"house":9,"sign":"Vir","degree":22.5567},{"house":10,"sign":"Lib","degree":29.1234},{"house":11,"sign":"Sco","degree":16.8901},{"house":12,"sign":"Sag","degree":3.4567}]}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error - check field formats"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/house-cusps\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/house-cusps\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/house-cusps\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/house-cusps\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/house-cusps\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/aspects":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"Aspects","description":"🔗 **Planetary Aspects Calculator** - Precise angular relationships between celestial bodies\n\n**Perfect for:**\n- 🎯 Chart interpretation and analysis\n- 📱 Astrology app aspect displays\n- 🔄 Real-time aspect tracking\n- 📊 Astrological research and education\n\n**What you get:**\n- **Major aspects** between all selected celestial bodies\n- **Precise orb measurements** (exact angular distance from perfect aspect)\n- **Aspect types** (conjunction, opposition, trine, square, sextile, etc.)\n- **Applying/separating status** for dynamic interpretation\n- **Configurable precision** for orb values (0-6 decimal places)\n\n**Supported aspects:**\n- **Conjunction** (0°) - Unity and blending of energies\n- **Opposition** (180°) - Tension and awareness\n- **Trine** (120°) - Harmony and flow\n- **Square** (90°) - Challenge and action\n- **Sextile** (60°) - Opportunity and cooperation\n- **Plus minor aspects** - quincunx, semi-square, sesquiquadrate\n\n**Celestial bodies included:**\n- **All planets** including South Nodes (Mean_South_Node, True_South_Node)\n- **Lunar Nodes** and special points\n- **Flexible point selection** - choose which bodies to include\n\n**Response time:** ~150ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_aspects_api_v3_data_aspects_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataRequest"},"examples":{"major_aspects":{"summary":"Major Aspects Analysis","description":"Traditional major aspects between main planets","value":{"subject":{"name":"Aspect Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2}}},"extended_aspects":{"summary":"Extended Aspect Analysis","description":"Comprehensive aspects including outer planets, asteroids, and nodes","value":{"subject":{"name":"Complex Chart","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":40.7128,"longitude":-74.006}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Chiron","Mean_Node","True_Node","Mean_Lilith","Ascendant","Medium_Coeli"],"precision":4}}},"tight_orbs":{"summary":"Tight Orb Precision","description":"High precision aspects with very tight orbs for exact analysis","value":{"subject":{"name":"Precision Master","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":30,"city":"Paris","country_code":"FR"}},"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron"],"precision":6}}},"traditional_focus":{"summary":"Traditional Astrology Aspects","description":"Focus on traditional planets with nodes and Arabic parts","value":{"subject":{"name":"Traditional Scholar","birth_data":{"year":1988,"month":3,"day":25,"hour":12,"minute":0,"second":0,"city":"Athens","country_code":"GR"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Part_of_Fortune","Part_of_Spirit"],"precision":3}}}}}},"required":true},"responses":{"200":{"description":"Planetary aspects with precise orb measurements and relationship types","content":{"application/json":{"schema":{},"examples":{"major_aspects_collection":{"summary":"Major planetary aspects","description":"Traditional major aspects (conjunction, opposition, trine, square, sextile) with precise orb calculations","value":{"aspects":[{"point1":"Sun","point2":"Moon","aspect_type":"square","orb":1.6111},{"point1":"Sun","point2":"Saturn","aspect_type":"opposition","orb":-4.3194},{"point1":"Moon","point2":"Jupiter","aspect_type":"conjunction","orb":3.17},{"point1":"Venus","point2":"Mars","aspect_type":"sextile","orb":-0.2361},{"point1":"Mars","point2":"Jupiter","aspect_type":"trine","orb":-5.5426},{"point1":"Mercury","point2":"Neptune","aspect_type":"trine","orb":-6.8881}]}},"nodal_aspects":{"summary":"Lunar node aspects","description":"Aspects involving North and South lunar nodes with karmic implications","value":{"aspects":[{"point1":"Sun","point2":"Mean_Node","aspect_type":"conjunction","orb":2.5905},{"point1":"Sun","point2":"Mean_South_Node","aspect_type":"opposition","orb":-2.5905},{"point1":"Moon","point2":"Mean_Node","aspect_type":"square","orb":-0.9793},{"point1":"Jupiter","point2":"Mean_Node","aspect_type":"square","orb":2.1907}]}},"tight_orbs_precise":{"summary":"Exact aspects with tight orbs","description":"Very precise aspects with orbs under 1 degree, indicating strong planetary connections","value":{"aspects":[{"point1":"Venus","point2":"Mars","aspect_type":"sextile","orb":-0.2361},{"point1":"Mercury","point2":"Medium_Coeli","aspect_type":"square","orb":0.8458},{"point1":"Moon","point2":"Mean_Node","aspect_type":"square","orb":-0.9793},{"point1":"Jupiter","point2":"Uranus","aspect_type":"sextile","orb":-0.9748}]}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error - check field formats"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/aspects\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/aspects\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/aspects\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/aspects\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/aspects\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/lunar-metrics":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"Lunar Metrics","description":"🌙 **Comprehensive Lunar Analysis** - Detailed Moon phase and cycle information\n\n**Perfect for:**\n- 🌙 Lunar timing and planning\n- 📱 Moon phase apps and calendars\n- 🎯 Electional astrology (choosing optimal timing)\n- 📊 Agricultural and natural cycle tracking\n\n**What you get:**\n- **Current Moon phase** (New, Waxing Crescent, First Quarter, etc.)\n- **Phase percentage** (0-100% illumination)\n- **Days since New Moon** (lunar day count)\n- **Next phase dates** (upcoming New Moon, Full Moon, etc.)\n- **Lunar mansion/nakshatra** (traditional lunar divisions)\n- **Void of Course periods** (when Moon makes no major aspects)\n\n**Lunar cycle information:**\n- **Synodic month** progress (29.5 day cycle)\n- **Sidereal month** progress (27.3 day cycle)\n- **Anomalistic month** (perigee to perigee)\n- **Tropical month** (return to same zodiac degree)\n\n**Response time:** ~150ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_lunar_metrics_api_v3_data_lunar_metrics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataRequest"},"examples":{"current_moon_phase":{"summary":"Current Moon Phase Analysis","description":"Today's lunar phase and cycle information","value":{"subject":{"name":"Moon Phase Observer","birth_data":{"year":2024,"month":3,"day":15,"hour":20,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","language":"en"}}},"new_moon_timing":{"summary":"New Moon Timing","description":"Lunar analysis around New Moon for manifestation timing","value":{"subject":{"name":"New Moon Timer","birth_data":{"year":2024,"month":4,"day":8,"hour":18,"minute":15,"second":0,"latitude":40.7128,"longitude":-74.006}},"options":{"house_system":"P","language":"en"}}},"full_moon_energy":{"summary":"Full Moon Energy Analysis","description":"Lunar metrics during Full Moon for peak energy timing","value":{"subject":{"name":"Full Moon Energy","birth_data":{"year":2024,"month":7,"day":21,"hour":2,"minute":0,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"P","language":"en"}}},"void_of_course":{"summary":"Void of Course Analysis","description":"Lunar analysis for electional astrology and timing decisions","value":{"subject":{"name":"Void of Course Timer","birth_data":{"year":2024,"month":12,"day":8,"hour":14,"minute":45,"second":0,"city":"Tokyo","country_code":"JP"}},"options":{"house_system":"P","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Comprehensive lunar cycle data including phase, distance, and illumination","content":{"application/json":{"schema":{},"examples":{"waxing_crescent_phase":{"summary":"Waxing Crescent Moon phase","description":"Example showing Moon in Waxing Crescent phase with distance and illumination data","value":{"date":"2024-03-15","within_perigee_range":false,"distance":378244.78,"within_apogee_range":false,"apogee_distance":406696.0,"moon_sign":"Gem","moon_phase":"Waxing Crescent","moon_age_in_days":5.48,"moon_day":6,"moon_illumination":36.35}},"full_moon_perigee":{"summary":"Full Moon at perigee (supermoon)","description":"Full Moon occurring near perigee, creating a supermoon with enhanced gravitational effects","value":{"date":"2024-07-21","within_perigee_range":true,"distance":357378.42,"within_apogee_range":false,"apogee_distance":405696.0,"moon_sign":"Cap","moon_phase":"Full Moon","moon_age_in_days":14.73,"moon_day":15,"moon_illumination":99.87}},"new_moon_apogee":{"summary":"New Moon at apogee (micromoon)","description":"New Moon occurring near apogee, creating minimal tidal and gravitational effects","value":{"date":"2024-12-01","within_perigee_range":false,"distance":405234.89,"within_apogee_range":true,"apogee_distance":406696.0,"moon_sign":"Sag","moon_phase":"New Moon","moon_age_in_days":0.12,"moon_day":1,"moon_illumination":0.43}},"third_quarter_phase":{"summary":"Third Quarter (Waning) Moon","description":"Moon in Third Quarter phase with moderate distance and illumination decreasing","value":{"date":"2024-09-11","within_perigee_range":false,"distance":389567.23,"within_apogee_range":false,"apogee_distance":406696.0,"moon_sign":"Gem","moon_phase":"Third Quarter","moon_age_in_days":22.34,"moon_day":23,"moon_illumination":49.12}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error - check field formats"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/lunar-metrics\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/lunar-metrics\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/lunar-metrics\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/lunar-metrics\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/lunar-metrics\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/global-positions":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"Global Positions","description":"🌍 **Global Planetary Positions** - Location-independent ephemeris data\n\n**Perfect for:**\n- 📊 Daily ephemeris table generation\n- 🗄️ Caching planetary positions for multiple locations\n- 📱 Astrology apps requiring global reference data\n- 🔄 Background data synchronization\n\n**What you get:**\n- **Precise positions** for all requested celestial bodies\n- **Zodiac signs** (3-letter codes: Ari, Tau, Gem, etc.)\n- **Degrees within signs** (0.0 to 29.99)\n- **Absolute longitude** (0-360° full zodiac position)\n- **Retrograde status** for all planets\n- **Planetary speed** (degrees per day)\n\n**Key features:**\n- **No location required** - uses universal reference (0°N, 0°W)\n- **Both zodiac types** - Tropical and Sidereal calculations\n- **Flexible precision** - 0-8 decimal places\n- **Extensive body support** - planets, asteroids, nodes, special points\n\n**Excluded points:** Location-dependent angles (Ascendant, MC, Vertex) are not included\nsince no birth location is provided.\n\n**Use case:** Cache these positions once per day, then calculate house placements\nlocally for different birth locations to optimize API usage.\n\n**Response time:** ~80ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_global_positions_api_v3_data_global_positions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalDataRequest"},"examples":{"daily_ephemeris":{"summary":"Daily Ephemeris - Today","description":"Current planetary positions for ephemeris table or daily caching","value":{"year":2024,"month":3,"day":15,"hour":12,"minute":0,"second":0,"options":{"zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":2}}},"midnight_positions":{"summary":"Midnight Universal Positions","description":"Planetary positions at midnight UTC for global reference","value":{"year":2024,"month":7,"day":21,"hour":0,"minute":0,"second":0,"options":{"zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":4}}},"sidereal_ephemeris":{"summary":"Sidereal Ephemeris Data","description":"Vedic/Sidereal zodiac positions for traditional calculations","value":{"year":2024,"month":12,"day":8,"hour":6,"minute":30,"second":0,"options":{"zodiac_type":"Sidereal","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":3}}},"extended_points":{"summary":"Extended Celestial Points","description":"Comprehensive list including asteroids and special points","value":{"year":2024,"month":4,"day":1,"hour":18,"minute":45,"second":0,"options":{"zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Chiron","Ceres","Pallas","Juno","Vesta","Mean_Node","True_Node","Mean_Lilith"],"precision":5}}}}}},"required":true},"responses":{"200":{"description":"Global planetary positions at specified date/time with precise coordinates","content":{"application/json":{"schema":{},"examples":{"daily_ephemeris_response":{"summary":"Daily ephemeris planetary positions","description":"Complete set of planetary positions for ephemeris table generation","value":{"datetime_utc":"2024-03-15T12:00:00Z","zodiac_type":"Tropic","positions":[{"name":"Sun","sign":"Pis","degree":24.83,"absolute_longitude":354.83,"is_retrograde":false,"speed":1.0157},{"name":"Moon","sign":"Gem","degree":18.45,"absolute_longitude":78.45,"is_retrograde":false,"speed":13.2341},{"name":"Mercury","sign":"Pis","degree":12.67,"absolute_longitude":342.67,"is_retrograde":false,"speed":1.8392},{"name":"Venus","sign":"Aqu","degree":28.91,"absolute_longitude":328.91,"is_retrograde":false,"speed":1.2458},{"name":"Mars","sign":"Aqu","degree":4.23,"absolute_longitude":304.23,"is_retrograde":false,"speed":0.7219},{"name":"Jupiter","sign":"Tau","degree":15.78,"absolute_longitude":45.78,"is_retrograde":false,"speed":0.2145},{"name":"Saturn","sign":"Pis","degree":11.34,"absolute_longitude":341.34,"is_retrograde":false,"speed":0.1087},{"name":"Uranus","sign":"Tau","degree":19.89,"absolute_longitude":49.89,"is_retrograde":false,"speed":0.0543},{"name":"Neptune","sign":"Pis","degree":27.12,"absolute_longitude":357.12,"is_retrograde":false,"speed":0.0284},{"name":"Pluto","sign":"Aqu","degree":1.56,"absolute_longitude":301.56,"is_retrograde":false,"speed":0.0167}]}},"retrograde_emphasis":{"summary":"Positions with retrograde motion","description":"Example showing planets in retrograde motion with negative speeds","value":{"datetime_utc":"2024-07-15T12:00:00Z","zodiac_type":"Tropic","positions":[{"name":"Sun","sign":"Can","degree":29.12,"absolute_longitude":119.12,"is_retrograde":false,"speed":0.9563},{"name":"Moon","sign":"Sco","degree":3.78,"absolute_longitude":213.78,"is_retrograde":false,"speed":11.9847},{"name":"Mercury","sign":"Leo","degree":15.43,"absolute_longitude":135.43,"is_retrograde":true,"speed":-0.8721},{"name":"Venus","sign":"Gem","degree":22.89,"absolute_longitude":82.89,"is_retrograde":true,"speed":-0.4256},{"name":"Jupiter","sign":"Gem","degree":8.92,"absolute_longitude":68.92,"is_retrograde":true,"speed":-0.1234},{"name":"Saturn","sign":"Pis","degree":19.67,"absolute_longitude":349.67,"is_retrograde":true,"speed":-0.0651}]}},"sidereal_positions":{"summary":"Sidereal zodiac calculation","description":"Vedic/Sidereal zodiac positions showing offset from tropical zodiac","value":{"datetime_utc":"2024-03-15T12:00:00Z","zodiac_type":"Sidereal","positions":[{"name":"Sun","sign":"Aqu","degree":24.12,"absolute_longitude":324.12,"is_retrograde":false,"speed":1.0157},{"name":"Moon","sign":"Tau","degree":17.23,"absolute_longitude":47.23,"is_retrograde":false,"speed":13.2341},{"name":"Mercury","sign":"Aqu","degree":11.45,"absolute_longitude":311.45,"is_retrograde":false,"speed":1.8392},{"name":"Mean_Node","sign":"Pis","degree":2.67,"absolute_longitude":332.67,"is_retrograde":true,"speed":-0.053}]}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error in date/time or options parameters","content":{"application/json":{"example":{"success":false,"error":{"error_code":"VALIDATION_ERROR","message":"Invalid date parameters","field":"day","value":32,"severity":"medium","suggestions":["Day must be between 1-31","Check if the month has this many days"]},"timestamp":"2024-03-15T12:00:00Z"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/global-positions\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/global-positions\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/global-positions\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/global-positions\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/global-positions\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/positions/enhanced":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"Enhanced Positions","description":"🏛️ **Enhanced Planetary Positions with Traditional Astrology (v3.2.0)**\n\nReturns planetary positions enriched with traditional Hellenistic astrology data:\n\n**Traditional Enhancements:**\n- ✅ **Essential Dignities**: Domicile, exaltation, triplicity, term, decan\n- ✅ **Essential Debilities**: Exile (detriment), fall\n- ✅ **Sect Analysis**: Day/night chart with planetary sect preferences\n- ✅ **Planetary Conditions**: Combustion, cazimi, under the beams\n- ✅ **Houses of Joy**: Traditional planetary jubilation\n- ✅ **Dispositor Chains**: Complete dispositor analysis\n- ✅ **Mutual Receptions**: Planets in mutual reception by domicile\n- ✅ **Traditional Points**: Part of Fortune, Part of Spirit, 7 more Arabic Lots\n- ✅ **About to Change Sign**: 24-hour sign change predictions\n\n**Dignity Overview:**\n- `dignified_planets`: Planets with essential dignity (domicile, exaltation, triplicity, own term, own decan)\n- `debilitated_planets`: Planets in exile or fall\n- `mutual_receptions`: Domicile-based mutual receptions between planets\n\n**Perfect for:**\n- Traditional astrology applications\n- Dignity-based chart analysis\n- Educational astrology tools\n- Professional astrology software\n\n**Speed:** Degrees per day via Swiss Ephemeris (negative = retrograde).","operationId":"get_enhanced_positions_api_v3_data_positions_enhanced_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataRequest"},"examples":{"traditional_dignities":{"summary":"Traditional Dignities Analysis","description":"Enhanced positions with complete traditional astrology dignities","value":{"subject":{"name":"Dignity Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"W","language":"en","tradition":"classical","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":4}}},"sect_analysis":{"summary":"Day/Night Sect Analysis","description":"Enhanced positions with sect analysis and planetary conditions","value":{"subject":{"name":"Sect Scholar","birth_data":{"year":1985,"month":8,"day":22,"hour":2,"minute":30,"second":0,"city":"Athens","country_code":"GR"}},"options":{"house_system":"W","language":"en","tradition":"classical","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node"],"precision":3}}},"reception_focus":{"summary":"Mutual Reception Focus","description":"Enhanced positions emphasizing mutual receptions and dispositor chains","value":{"subject":{"name":"Reception Master","birth_data":{"year":1992,"month":11,"day":8,"hour":18,"minute":45,"second":0,"latitude":48.8566,"longitude":2.3522}},"options":{"house_system":"A","language":"en","tradition":"classical","detail_level":"standard","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Part_of_Fortune"],"precision":2}}},"oleg_test":{"summary":"Standard Test Subject","description":"Using Oleg test data from Kharkiv, Ukraine for consistency","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"P","language":"en","tradition":"universal","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Ascendant","Medium_Coeli"],"precision":4}}}}}},"required":true},"responses":{"200":{"description":"Enhanced planetary positions with traditional astrology analysis and dignities","content":{"application/json":{"schema":{},"examples":{"dignified_positions":{"summary":"Positions with traditional dignities","description":"Enhanced positions showing planets in dignity with complete traditional analysis","value":{"positions":[{"name":"Sun","sign":"Leo","degree":15.2341,"absolute_longitude":135.2341,"house":10,"is_retrograde":false,"speed":0.9563,"conditions":{"domicile":true,"exaltation":false,"exile":false,"fall":false,"triplicity":{"is_in_triplicity":true,"ruler_primary":"Sun","ruler_secondary":"Jupiter","ruler_participant":"Saturn","active_ruler":"Sun"},"term":"Jupiter","decan":"Saturn","combustion":false,"cazimi":false,"under_beams":false,"in_joy":false,"about_to_change_sign":false}},{"name":"Moon","sign":"Can","degree":8.7892,"absolute_longitude":98.7892,"house":9,"is_retrograde":false,"speed":13.2341,"conditions":{"domicile":true,"exaltation":false,"exile":false,"fall":false,"triplicity":{"is_in_triplicity":true,"ruler_primary":"Venus","ruler_secondary":"Mars","ruler_participant":"Moon","active_ruler":"Venus"},"term":"Mars","decan":"Venus","combustion":false,"cazimi":false,"under_beams":false,"in_joy":false,"about_to_change_sign":false}},{"name":"Venus","sign":"Pis","degree":27.4567,"absolute_longitude":357.4567,"house":5,"is_retrograde":false,"speed":1.2458,"conditions":{"domicile":false,"exaltation":true,"exile":false,"fall":false,"triplicity":{"is_in_triplicity":true,"ruler_primary":"Venus","ruler_secondary":"Mars","ruler_participant":"Moon","active_ruler":"Venus"},"term":"Venus","decan":"Saturn","combustion":false,"cazimi":false,"under_beams":false,"in_joy":true,"about_to_change_sign":true}}],"dignity_overview":{"dignified_planets":[{"planet":"Sun","dignities":["domicile"]},{"planet":"Moon","dignities":["domicile"]},{"planet":"Venus","dignities":["exaltation","triplicity"]}],"debilitated_planets":[],"mutual_receptions":[{"planet1":"Jupiter","planet2":"Mercury","reception_type":"domicile","quality":"strong"}]},"sect_info":{"is_day_chart":true,"sect":"diurnal","sect_ruler":"Sun","benefic_in_sect":"Jupiter","malefic_out_of_sect":"Mars"},"traditional_points":{"Part_of_Fortune":{"sign":"Vir","degree":12.3456,"absolute_longitude":162.3456,"house":11},"Part_of_Spirit":{"sign":"Tau","degree":23.789,"absolute_longitude":53.789,"house":7}},"subject_data":{"name":"Dignified Example","year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","nation":"GB","lng":-0.1278,"lat":51.5074,"tz_str":"Europe/London"},"planets":{"Sun":{"abs_pos":135.2341,"sign":"Leo","house":10,"speed":0.9563,"retrograde":false},"Moon":{"abs_pos":98.7892,"sign":"Can","house":9,"speed":13.2341,"retrograde":false}},"calculation_time":"2024-03-15T12:00:00Z"}},"debilitated_conditions":{"summary":"Planets in challenging conditions","description":"Enhanced positions showing planets in exile, fall, combustion, and other difficult conditions","value":{"positions":[{"name":"Mars","sign":"Can","degree":19.6743,"absolute_longitude":109.6743,"house":9,"is_retrograde":false,"speed":0.6851,"conditions":{"domicile":false,"exaltation":false,"exile":false,"fall":true,"triplicity":{"is_in_triplicity":false,"ruler_primary":"Venus","ruler_secondary":"Mars","ruler_participant":"Moon","active_ruler":"Venus"},"term":"Mars","decan":"Mars","combustion":false,"cazimi":false,"under_beams":false,"in_joy":false,"about_to_change_sign":false}},{"name":"Mercury","sign":"Leo","degree":16.7834,"absolute_longitude":136.7834,"house":10,"is_retrograde":true,"speed":-0.8721,"conditions":{"domicile":false,"exaltation":false,"exile":false,"fall":false,"triplicity":{"is_in_triplicity":false,"ruler_primary":"Sun","ruler_secondary":"Jupiter","ruler_participant":"Saturn","active_ruler":"Sun"},"term":"Jupiter","decan":"Saturn","combustion":true,"cazimi":false,"under_beams":true,"in_joy":false,"about_to_change_sign":false}}],"sect_info":{"is_day_chart":true,"sect":"diurnal"},"subject_data":{"name":"Debility Example","year":1988,"month":8,"day":10,"hour":15,"minute":0,"second":0,"city":"Rome","nation":"IT","lng":12.4964,"lat":41.9028,"tz_str":"Europe/Rome"},"traditional_points":{"Part_of_Fortune":{"sign":"Sco","degree":18.1234,"absolute_longitude":228.1234,"house":1}},"dignity_overview":{"dignified_planets":[],"debilitated_planets":[{"planet":"Mars","debilities":["fall"]}],"mutual_receptions":[]},"planets":{"Mars":{"abs_pos":109.6743,"sign":"Can","house":9,"speed":0.6851,"retrograde":false},"Mercury":{"abs_pos":136.7834,"sign":"Leo","house":10,"speed":-0.8721,"retrograde":true}},"calculation_time":"2024-03-15T12:00:00Z"}},"night_chart_example":{"summary":"Night chart sect analysis","description":"Enhanced positions for nocturnal chart showing sect-based planetary conditions","value":{"positions":[{"name":"Moon","sign":"Sco","degree":14.3721,"absolute_longitude":224.3721,"house":1,"is_retrograde":false,"speed":12.6633,"conditions":{"domicile":false,"exaltation":false,"exile":false,"fall":false,"triplicity":{"is_in_triplicity":true,"ruler_primary":"Mars","ruler_secondary":"Mars","ruler_participant":"Venus","active_ruler":"Mars"},"term":"Mars","decan":"Mars","combustion":false,"cazimi":false,"under_beams":false,"in_joy":false,"about_to_change_sign":false}}],"sect_info":{"is_day_chart":false,"sect":"nocturnal","sect_ruler":"Moon","benefic_in_sect":"Venus","malefic_out_of_sect":"Saturn"},"subject_data":{"name":"Night Chart Example","year":1992,"month":11,"day":15,"hour":23,"minute":30,"second":0,"city":"Berlin","nation":"DE","lng":13.405,"lat":52.52,"tz_str":"Europe/Berlin"},"traditional_points":{"Part_of_Fortune":{"sign":"Pis","degree":5.6789,"absolute_longitude":335.6789,"house":4}},"dignity_overview":{"dignified_planets":[],"debilitated_planets":[],"mutual_receptions":[]},"planets":{"Moon":{"abs_pos":224.3721,"sign":"Sco","house":1,"speed":12.6633,"retrograde":false}},"calculation_time":"2024-03-15T12:00:00Z"}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error in birth data or calculation options","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INVALID_CELESTIAL_BODY","message":"Invalid celestial body name","field":"active_points","value":"invalid_planet","severity":"low","suggestions":["Use standard names: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn","See /api/v3/glossary/active-points for complete list"]},"timestamp":"2024-03-15T12:00:00Z"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/positions/enhanced\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/positions/enhanced\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/positions/enhanced\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/positions/enhanced\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/positions/enhanced\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/aspects/enhanced":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"Enhanced Aspects","description":"🏛️ **Enhanced Aspects with Reception Analysis (v3.2.0)**\n\nReturns aspects enriched with traditional reception analysis:\n\n**Traditional Enhancements:**\n- ✅ **Reception Quality**: Mutual and single receptions between planets\n- ✅ **Dignity Context**: Both planets' dignity status in aspects\n- ✅ **Aspect Strength**: Weighted by planetary dignities and orbs\n- ✅ **Aspect Nature**: benefic, mildly_malefic, malefic, neutral\n\n**Reception Types:**\n- **mutual_pure**: Both planets receive each other by the SAME dignity type (e.g., both by domicile)\n- **mutual_mixed**: Both planets receive each other by DIFFERENT dignity types (e.g., domicile + exaltation)\n- **single**: Only one planet receives the other\n- **Reception by Dignity**: Domicile, exaltation, triplicity, term, decan\n\n**Aspect Nature Classification:**\n- **benefic**: Benefic aspects (trine, sextile) or benefic planets\n- **mildly_malefic**: Malefic conjunct luminary WITH reception (mitigated)\n- **malefic**: Malefic hard aspects to luminaries, or malefic conjunct luminary WITHOUT reception\n- **neutral**: Other aspects not clearly benefic or malefic\n\n**Mutual Receptions List:**\n- Includes `is_pure` field (true = mutual_pure, false = mutual_mixed)\n- Quality rating: excellent, strong, moderate, weak\n\n**Aspect Strength Calculation:**\n- Orb tightness (closer = stronger)\n- Planetary dignity status\n- Reception quality bonus\n- Traditional aspect hierarchy\n\n**Perfect for:**\n- Traditional aspect interpretation\n- Reception-based counseling\n- Advanced astrological analysis\n- Educational applications","operationId":"get_enhanced_aspects_api_v3_data_aspects_enhanced_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataRequest"},"examples":{"reception_aspects":{"summary":"Reception-Based Aspects","description":"Enhanced aspects with mutual reception analysis and dignity context","value":{"subject":{"name":"Aspect Master","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"W","language":"en","tradition":"classical","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3}}},"strength_analysis":{"summary":"Aspect Strength Analysis","description":"Enhanced aspects with strength calculations based on dignities and orbs","value":{"subject":{"name":"Strength Seeker","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Florence","country_code":"IT"}},"options":{"house_system":"A","language":"en","tradition":"classical","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":4}}},"traditional_interpretation":{"summary":"Traditional Interpretation","description":"Enhanced aspects with traditional Hellenistic interpretation methods","value":{"subject":{"name":"Traditional Interpreter","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"latitude":35.6762,"longitude":139.6503}},"options":{"house_system":"W","language":"en","tradition":"classical","detail_level":"standard","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron"],"precision":2}}},"oleg_test":{"summary":"Standard Test Subject","description":"Using Oleg test data from Kharkiv, Ukraine for consistency","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"P","language":"en","tradition":"universal","detail_level":"full","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3}}}}}},"required":true},"responses":{"200":{"description":"Enhanced aspects with reception analysis and traditional strength calculations","content":{"application/json":{"schema":{},"examples":{"reception_analysis":{"summary":"Aspects with mutual reception analysis","description":"Enhanced aspects showing reception quality and traditional strength calculations","value":{"aspects":[{"point1":"Sun","point2":"Jupiter","aspect_type":"trine","orb":2.3456,"applying":true,"strength":8.5,"reception_data":{"has_reception":true,"reception_type":"single","reception_quality":"strong","receiving_planet":"Jupiter","dignity_type":"domicile","description":"Jupiter receives Sun by domicile in Sagittarius"},"traditional_strength":{"orb_factor":0.95,"dignity_bonus":1.5,"aspect_nature":"benefic","sect_consideration":"favorable","total_strength":8.5}},{"point1":"Venus","point2":"Mars","aspect_type":"conjunction","orb":0.7823,"applying":false,"strength":9.2,"reception_data":{"has_reception":true,"reception_type":"mutual_pure","reception_quality":"excellent","receiving_planet":"both","dignity_type":"domicile","description":"Venus in Aries (Mars rulership) and Mars in Taurus (Venus rulership)"},"traditional_strength":{"orb_factor":0.98,"dignity_bonus":2.0,"aspect_nature":"benefic","sect_consideration":"neutral","total_strength":9.2}},{"point1":"Moon","point2":"Saturn","aspect_type":"square","orb":-3.4567,"applying":true,"strength":4.8,"reception_data":{"has_reception":false,"description":"No reception between Moon and Saturn"},"traditional_strength":{"orb_factor":0.85,"dignity_bonus":0.0,"aspect_nature":"malefic","sect_consideration":"challenging","total_strength":4.8}}],"reception_summary":{"total_mutual_receptions":1,"total_single_receptions":1,"strongest_reception":{"planets":["Venus","Mars"],"type":"mutual","strength":9.2},"reception_types":{"domicile":2,"exaltation":0,"triplicity":0,"term":0}},"mutual_receptions":[{"planet1":"Venus","planet2":"Mars","type":"mutual_pure","is_pure":true,"dignity_type":"domicile","quality":"excellent","effect":"Passion meets artistry in harmonious exchange"}],"strongest_aspects":[{"planets":["Venus","Mars"],"aspect":"conjunction","strength":9.2,"nature":"complex - passion and harmony"},{"planets":["Sun","Jupiter"],"aspect":"trine","strength":8.5,"nature":"benefic - expansion and confidence"}]}},"dignity_context":{"summary":"Aspects with complete dignity analysis","description":"Enhanced aspects showing how planetary dignities affect aspect interpretation","value":{"aspects":[{"point1":"Mercury","point2":"Jupiter","aspect_type":"sextile","orb":1.2345,"applying":true,"strength":7.8,"reception_data":{"has_reception":true,"reception_type":"mutual_pure","reception_quality":"excellent","receiving_planet":"both","dignity_type":"domicile","description":"Mercury in Sagittarius receives Jupiter, Jupiter in Gemini receives Mercury"},"dignity_analysis":{"mercury_dignity":{"sign":"Sag","in_domicile":false,"in_exaltation":false,"in_exile":true,"in_fall":false,"dignity_score":-1},"jupiter_dignity":{"sign":"Gem","in_domicile":false,"in_exaltation":false,"in_exile":true,"in_fall":false,"dignity_score":-1},"combined_effect":"Mutual reception overcomes exile status"}},{"point1":"Sun","point2":"Moon","aspect_type":"opposition","orb":-0.8912,"applying":false,"strength":9.8,"reception_data":{"has_reception":false,"reception_type":"none","reception_quality":"neutral","receiving_planet":"neither","dignity_type":"none","description":"No formal reception - luminaries in natural opposition"},"dignity_analysis":{"sun_dignity":{"sign":"Leo","in_domicile":true,"in_exaltation":false,"in_exile":false,"in_fall":false,"dignity_score":5},"moon_dignity":{"sign":"Aqu","in_domicile":false,"in_exaltation":false,"in_exile":true,"in_fall":false,"dignity_score":-1},"combined_effect":"Strong Sun opposes weakened Moon - imbalance of will and emotion"}}],"reception_summary":{"total_mutual_receptions":1,"total_single_receptions":0,"strongest_reception":{"planets":["Mercury","Jupiter"],"type":"mutual","strength":7.8},"reception_types":{"domicile":2,"exaltation":0,"triplicity":0,"term":0}},"mutual_receptions":[{"planet1":"Mercury","planet2":"Jupiter","type":"mutual_pure","is_pure":true,"dignity_type":"domicile","quality":"excellent","effect":"Enhances communication and wisdom exchange"}],"strongest_aspects":[{"planets":["Sun","Moon"],"aspect":"opposition","strength":9.8,"nature":"luminary opposition - consciousness vs emotion"}]}},"traditional_interpretation":{"summary":"Traditional Hellenistic aspect analysis","description":"Enhanced aspects with traditional interpretation methods and sect-based analysis","value":{"aspects":[{"point1":"Mars","point2":"Venus","aspect_type":"trine","orb":4.5678,"applying":false,"strength":6.3,"traditional_interpretation":{"aspect_nature":"harmonious","planetary_relationship":"complementary opposites","sect_analysis":{"mars_in_sect":false,"venus_in_sect":true,"sect_effect":"Venus strengthened, Mars somewhat weakened"},"hellenistic_meaning":"Harmony between desire and attraction, balanced passion","practical_effect":"Creative expression, artistic talents, harmonious relationships"}},{"point1":"Saturn","point2":"Jupiter","aspect_type":"square","orb":-2.1456,"applying":true,"strength":5.7,"traditional_interpretation":{"aspect_nature":"challenging","planetary_relationship":"contrary benefic vs malefic","sect_analysis":{"saturn_in_sect":false,"jupiter_in_sect":true,"sect_effect":"Jupiter protected, Saturn more challenging"},"hellenistic_meaning":"Restriction vs expansion, conservative vs optimistic","practical_effect":"Delayed rewards, earned wisdom through obstacles"}}],"sect_overview":{"chart_sect":"diurnal","in_sect_planets":["Sun","Jupiter","Saturn"],"out_of_sect_planets":["Moon","Venus","Mars"],"sect_ruler":"Sun","benefic_in_sect":"Jupiter","malefic_out_of_sect":"Mars"},"reception_summary":{"total_mutual_receptions":0,"total_single_receptions":1,"strongest_reception":{"planets":["Mars","Venus"],"type":"single","strength":6.3},"reception_types":{"domicile":1,"exaltation":0,"triplicity":0,"term":0}},"mutual_receptions":[],"strongest_aspects":[{"planets":["Mars","Venus"],"aspect":"trine","strength":6.3,"nature":"harmonious - passion and beauty"},{"planets":["Saturn","Jupiter"],"aspect":"square","strength":5.7,"nature":"challenging - restriction vs expansion"}]}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error in birth data or aspect calculation parameters","content":{"application/json":{"example":{"success":false,"error":{"error_code":"CALCULATION_FAILED","message":"Enhanced aspects calculation failed: Invalid house system","field":"house_system","value":"invalid_system","severity":"medium","suggestions":["Use valid house system codes: P, W, K, A, R, C","See /api/v3/glossary/house-systems for complete list"]},"timestamp":"2024-03-15T12:00:00Z"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/aspects/enhanced\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/aspects/enhanced\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/aspects/enhanced\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/aspects/enhanced\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/aspects/enhanced\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/data/lunar-metrics/enhanced":{"post":{"tags":["📊 Raw Data & Positions"],"summary":"Enhanced Lunar Metrics","description":"🏛️ **Enhanced Lunar Metrics with Traditional Analysis (v3.2.0)**\n\nReturns lunar data enriched with traditional techniques:\n\n**Traditional Enhancements:**\n- ✅ **Void of Course**: Moon makes no more aspects in current sign\n- ✅ **Elongation**: Angular distance from Sun (traditional phase calculation)\n- ✅ **Traditional Phase Meanings**: Hellenistic lunar phase interpretations\n- ✅ **Lunar Dignities**: Moon's current essential dignities\n- ✅ **Next Sign Change**: When Moon changes sign with dignity implications\n- ✅ **Next Lunar Aspect**: Upcoming lunar aspects with timing\n\n**Void of Course Analysis:**\n- Determines if Moon is void of course\n- Calculates duration until next sign\n- Traditional timing implications\n\n**Enhanced Phase Data:**\n- Elongation degrees (0-180°)\n- Increasing/decreasing light\n- Traditional phase meanings\n- Optimal timing guidance\n\n**Perfect for:**\n- Electional astrology (timing)\n- Traditional lunar planning\n- Void of course tracking\n- Lunar gardening/timing apps","operationId":"get_enhanced_lunar_metrics_api_v3_data_lunar_metrics_enhanced_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataRequest"},"examples":{"void_of_course":{"summary":"Void of Course Analysis","description":"Enhanced lunar metrics with void of course periods and traditional timing","value":{"subject":{"name":"Void of Course Timer","birth_data":{"year":2024,"month":3,"day":15,"hour":20,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","language":"en","tradition":"classical","detail_level":"full"}}},"lunar_dignities":{"summary":"Lunar Dignities Focus","description":"Enhanced lunar analysis with Moon's current essential dignities","value":{"subject":{"name":"Lunar Dignitary","birth_data":{"year":2024,"month":7,"day":21,"hour":14,"minute":15,"second":0,"latitude":48.8566,"longitude":2.3522}},"options":{"house_system":"W","language":"en","tradition":"classical","detail_level":"full"}}},"electional_timing":{"summary":"Electional Astrology Timing","description":"Enhanced lunar metrics for optimal timing and electional astrology","value":{"subject":{"name":"Election Timer","birth_data":{"year":2024,"month":12,"day":8,"hour":9,"minute":45,"second":0,"city":"Athens","country_code":"GR"}},"options":{"house_system":"W","language":"en","tradition":"classical","detail_level":"standard"}}},"oleg_test":{"summary":"Standard Test Subject","description":"Using Oleg test data from Kharkiv, Ukraine for consistency","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"P","language":"en","tradition":"universal","detail_level":"full"}}}}}},"required":true},"responses":{"200":{"description":"Enhanced lunar metrics with void of course analysis and traditional timing","content":{"application/json":{"schema":{},"examples":{"moon_in_gemini":{"summary":"Moon in Gemini - no essential dignity","description":"Enhanced lunar metrics when Moon is in Gemini with no major dignity","value":{"moon_sign":"Gem","phase_info":{"phase_name":"Waning Crescent","illumination_percent":8.45,"moon_age_days":26.2,"elongation_deg":38.7,"increasing_light":false,"void_of_course":false,"next_aspect":{"planet":"Venus","aspect_type":"sextile","hours_until":4.3,"exact_time":"2024-03-15T16:18:00Z"}},"void_of_course":false,"traditional_phase_meaning":"Time of rest, healing, and preparation for new cycle","lunar_dignities":{"domicile":false,"exaltation":false,"detriment":false,"fall":false,"triplicity":{"is_in_triplicity":false,"ruler_primary":"Mercury","ruler_secondary":"Mercury","ruler_participant":"Jupiter","active_ruler":"Mercury"},"term":"Jupiter","decan":"Mercury"},"next_sign_change":{"hours_until":5.2,"next_sign":"Can","dignity_change":"enters domicile"}}},"moon_in_cancer_domicile":{"summary":"Moon in Cancer - domicile (strongest)","description":"Enhanced lunar metrics when Moon is in Cancer (its domicile/rulership)","value":{"moon_sign":"Can","phase_info":{"phase_name":"New Moon","illumination_percent":2.1,"moon_age_days":0.8,"elongation_deg":12.4,"increasing_light":true,"void_of_course":false,"next_aspect":{"planet":"Mercury","aspect_type":"conjunction","hours_until":2.1,"exact_time":"2024-07-21T16:06:00Z"}},"void_of_course":false,"traditional_phase_meaning":"Time of new beginnings, planting seeds, setting intentions","lunar_dignities":{"domicile":true,"exaltation":false,"detriment":false,"fall":false,"triplicity":{"is_in_triplicity":true,"ruler_primary":"Venus","ruler_secondary":"Mars","ruler_participant":"Moon","active_ruler":"Venus"},"term":"Venus","decan":"Venus"},"next_sign_change":{"hours_until":48.3,"next_sign":"Leo","dignity_change":"leaves domicile"}}},"moon_in_taurus_exaltation":{"summary":"Moon in Taurus - exaltation","description":"Enhanced lunar metrics when Moon is in Taurus (its exaltation)","value":{"moon_sign":"Tau","phase_info":{"phase_name":"First Quarter","illumination_percent":51.7,"moon_age_days":7.3,"elongation_deg":91.2,"increasing_light":true,"void_of_course":false,"next_aspect":{"planet":"Jupiter","aspect_type":"trine","hours_until":6.8,"exact_time":"2024-11-05T14:30:00Z"}},"void_of_course":false,"traditional_phase_meaning":"Time of challenges and decisions, overcoming obstacles","lunar_dignities":{"domicile":false,"exaltation":true,"detriment":false,"fall":false,"triplicity":{"is_in_triplicity":true,"ruler_primary":"Venus","ruler_secondary":"Moon","ruler_participant":"Mars","active_ruler":"Venus"},"term":"Venus","decan":"Moon"},"next_sign_change":{"hours_until":32.1,"next_sign":"Gem","dignity_change":"leaves exaltation"}}}}}}},"400":{"description":"Invalid input parameters"},"422":{"description":"Validation error in date/time location data","content":{"application/json":{"example":{"success":false,"error":{"error_code":"LOCATION_RESOLUTION_FAILED","message":"Unable to resolve location coordinates or timezone","field":"city","value":"invalid_city_name","severity":"medium","suggestions":["Use valid city names like 'London', 'New York', 'Tokyo'","Provide latitude/longitude coordinates directly","Include country_code for disambiguation"]},"timestamp":"2024-03-15T12:00:00Z"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/data/lunar-metrics/enhanced\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/data/lunar-metrics/enhanced\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/data/lunar-metrics/enhanced\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/data/lunar-metrics/enhanced\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/data/lunar-metrics/enhanced\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/natal":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Chart Natal","description":"🗺️ **Complete Natal Chart Generator** - Full birth chart analysis\n\n**Perfect for:**\n- 🎯 Professional astrological consultations\n- 📱 Comprehensive astrology apps\n- 📊 Complete personality analysis\n- 🎓 Educational astrology tools\n\n**What you get:**\n- **All planetary positions** with houses and signs\n- **House cusps** in your chosen house system (23 systems supported)\n- **Major aspects** between all planets (conjunction, opposition, trine, square, sextile)\n- **Angle calculations** (Ascendant, Midheaven, Descendant, IC)\n- **Lunar nodes** and special points\n- **Retrograde indicators** for all planets\n\n**House systems supported:**\n- **P** (Placidus) - Most popular modern system\n- **W** (Whole Sign) - Traditional/Hellenistic system \n- **K** (Koch), **E** (Equal), **C** (Campanus)\n- Plus 18 additional systems - see `/api/v3/glossary/house-systems`\n\n**Precision options:**\n- Configurable decimal precision (0-6 places)\n- Swiss Ephemeris accuracy\n- Automatic timezone handling\n\n**Response time:** ~200ms | **Accuracy:** Professional grade","operationId":"chart_natal","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalChartRequest"},"examples":{"basic_chart":{"summary":"Basic Natal Chart - London","description":"Standard natal chart with Placidus houses and main planets","value":{"subject":{"name":"Emma Johnson","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2}}},"traditional_whole_sign":{"summary":"Traditional - Whole Sign Houses","description":"Traditional astrology setup with Whole Sign houses and extended points","value":{"subject":{"name":"Marcus Aurelius","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Part_of_Fortune","Part_of_Spirit"],"precision":4}}},"modern_extended":{"summary":"Modern Extended Chart","description":"Modern astrology with outer planets, asteroids, and high precision","value":{"subject":{"name":"Sophia Chen","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":30,"latitude":35.6762,"longitude":139.6503}},"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Chiron","Ceres","Pallas","Juno","Vesta","Mean_Lilith","True_Lilith"],"precision":6}}},"sidereal_vedic":{"summary":"Sidereal/Vedic Approach","description":"Sidereal zodiac calculation with Equal houses (Vedic style)","value":{"subject":{"name":"Arjun Patel","birth_data":{"year":1988,"month":3,"day":25,"hour":12,"minute":0,"second":0,"city":"Mumbai","country_code":"IN"}},"options":{"house_system":"A","zodiac_type":"Sidereal","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":3}}},"fixed_stars":{"summary":"Fixed Stars Analysis","description":"Chart focused on fixed star conjunctions with royal stars","value":{"subject":{"name":"Stella Maris","birth_data":{"year":1987,"month":7,"day":4,"hour":16,"minute":20,"second":0,"city":"Sydney","country_code":"AU"}},"options":{"house_system":"R","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Aldebaran","Regulus","Antares","Fomalhaut","Sirius","Spica"],"precision":4}}}}}},"required":true},"responses":{"200":{"description":"Successful natal chart calculation with complete planetary positions, house cusps, and aspects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalChartResponse"},"examples":{"successful_response":{"summary":"Successful chart calculation response","description":"Complete chart data with all requested calculations","value":{"subject_data":{"name":"Emma Johnson","year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","nation":"GB","lng":-0.1278,"lat":51.5074,"tz_str":"Europe/London","sun":{"name":"Sun","quality":"Fixed","element":"Earth","sign":"Tau","sign_num":1,"position":24.83,"abs_pos":54.83,"emoji":"♉️","point_type":"Planet","house":"Tenth_House","retrograde":false},"moon":{"name":"Moon","quality":"Fixed","element":"Water","sign":"Sco","sign_num":7,"position":12.45,"abs_pos":222.45,"emoji":"♏️","point_type":"Planet","house":"Fourth_House","retrograde":false},"mercury":{"name":"Mercury","quality":"Mutable","element":"Air","sign":"Gem","sign_num":2,"position":8.91,"abs_pos":68.91,"emoji":"♊️","point_type":"Planet","house":"Eleventh_House","retrograde":false},"venus":{"name":"Venus","quality":"Cardinal","element":"Fire","sign":"Ari","sign_num":0,"position":2.67,"abs_pos":2.67,"emoji":"♈️","point_type":"Planet","house":"Eighth_House","retrograde":false},"mars":{"name":"Mars","quality":"Fixed","element":"Air","sign":"Aqu","sign_num":10,"position":19.23,"abs_pos":319.23,"emoji":"♒️","point_type":"Planet","house":"Seventh_House","retrograde":false},"jupiter":{"name":"Jupiter","quality":"Cardinal","element":"Water","sign":"Can","sign_num":3,"position":15.78,"abs_pos":105.78,"emoji":"♋️","point_type":"Planet","house":"Twelfth_House","retrograde":false},"saturn":{"name":"Saturn","quality":"Cardinal","element":"Earth","sign":"Cap","sign_num":9,"position":28.34,"abs_pos":298.34,"emoji":"♑️","point_type":"Planet","house":"Sixth_House","retrograde":false}},"chart_data":{"planetary_positions":[{"name":"Sun","sign":"Tau","degree":24.83,"absolute_longitude":54.83,"house":10,"is_retrograde":false,"speed":0.958},{"name":"Moon","sign":"Sco","degree":12.45,"absolute_longitude":222.45,"house":4,"is_retrograde":false,"speed":13.156},{"name":"Mercury","sign":"Gem","degree":8.91,"absolute_longitude":68.91,"house":11,"is_retrograde":false,"speed":1.234},{"name":"Venus","sign":"Ari","degree":2.67,"absolute_longitude":2.67,"house":8,"is_retrograde":false,"speed":1.156},{"name":"Mars","sign":"Aqu","degree":19.23,"absolute_longitude":319.23,"house":7,"is_retrograde":false,"speed":0.624},{"name":"Jupiter","sign":"Can","degree":15.78,"absolute_longitude":105.78,"house":12,"is_retrograde":false,"speed":0.089},{"name":"Saturn","sign":"Cap","degree":28.34,"absolute_longitude":298.34,"house":6,"is_retrograde":false,"speed":0.034},{"name":"Ascendant","sign":"Leo","degree":5.12,"absolute_longitude":125.12,"house":1,"is_retrograde":false},{"name":"Medium_Coeli","sign":"Ari","degree":28.89,"absolute_longitude":28.89,"house":10,"is_retrograde":false}],"house_cusps":[{"house":1,"sign":"Leo","degree":5.12},{"house":2,"sign":"Vir","degree":2.45},{"house":3,"sign":"Lib","degree":8.23},{"house":4,"sign":"Sco","degree":18.89},{"house":5,"sign":"Sag","degree":24.67},{"house":6,"sign":"Cap","degree":22.12},{"house":7,"sign":"Aqu","degree":5.12},{"house":8,"sign":"Pis","degree":2.45},{"house":9,"sign":"Ari","degree":8.23},{"house":10,"sign":"Tau","degree":18.89},{"house":11,"sign":"Gem","degree":24.67},{"house":12,"sign":"Can","degree":22.12}],"aspects":[{"point1":"Sun","point2":"Moon","aspect_type":"opposition","orb":2.38},{"point1":"Sun","point2":"Jupiter","aspect_type":"trine","orb":0.95},{"point1":"Moon","point2":"Mars","aspect_type":"square","orb":3.22},{"point1":"Venus","point2":"Saturn","aspect_type":"square","orb":4.33},{"point1":"Mercury","point2":"Ascendant","aspect_type":"sextile","orb":3.79}]}}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation error - check subject data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/natal\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/natal\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/natal\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/natal\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/natal\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/synastry":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Synastry (two charts dialogue)","description":"💬 **Synastry: Dialogue Between Two Charts** - How two people influence each other\n\n**What this is:**\nComparison of two **separate** natal charts. Shows how one person's planets\ninteract with another person's planets (cross-aspects).\nAnswers the question: **\"How do WE affect each other?\"**\n\n**vs /composite:** Use `/composite` to see the relationship as a separate entity (\"What is our relationship's destiny?\")\n\n**Perfect for:**\n- 💑 Relationship compatibility — who triggers what in whom\n- 👥 Business partnerships — working dynamics\n- 👨‍👩‍👧‍👦 Family dynamics — parent-child, sibling relationships\n- 🤝 Friendship compatibility\n\n**What you get:**\n- **Cross-aspects** between both charts (`Sun_1` ↔ `Moon_2`, `Venus_1` ↔ `Mars_2`)\n- **Planetary overlays** — which houses person B's planets activate in person A's chart\n- **Aspect orbs and types** — conjunction, trine, square, opposition, sextile\n- **Both charts preserved** — each person remains a separate entity\n\n**Example cross-aspects:**\n- `Venus_1 conjunction Mars_2` → sexual attraction from person 1 to person 2\n- `Moon_1 square Saturn_2` → emotional coldness from person 2\n- `Sun_1 trine Moon_2` → natural harmony and understanding\n\n**Metaphor:** Two people having a conversation — each remains themselves, but influences the other.\n\n**Response time:** ~300ms | **Accuracy:** Professional relationship analysis","operationId":"get_synastry_chart_api_v3_charts_synastry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryChartRequest"},"examples":{"romantic_compatibility":{"summary":"Romantic Compatibility","description":"Love relationship analysis between partners from different countries","value":{"subject1":{"name":"Isabella Garcia","birth_data":{"year":1990,"month":6,"day":15,"hour":14,"minute":30,"second":0,"city":"Madrid","country_code":"ES"}},"subject2":{"name":"James Anderson","birth_data":{"year":1988,"month":9,"day":22,"hour":18,"minute":45,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron"],"precision":2}}},"business_partnership":{"summary":"Business Partnership Analysis","description":"Professional compatibility using coordinates and extended points","value":{"subject1":{"name":"Sarah Kim","birth_data":{"year":1985,"month":3,"day":10,"hour":9,"minute":15,"second":0,"latitude":37.5665,"longitude":126.978}},"subject2":{"name":"David Mueller","birth_data":{"year":1987,"month":11,"day":5,"hour":16,"minute":20,"second":0,"latitude":52.52,"longitude":13.405}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Mean_Node","True_Node"],"precision":4}}},"karmic_connection":{"summary":"Karmic Connection Analysis","description":"Soul connection focus with nodes, Lilith, and spiritual points","value":{"subject1":{"name":"Luna Mystica","birth_data":{"year":1992,"month":12,"day":21,"hour":0,"minute":0,"second":0,"city":"Glastonbury","country_code":"GB"}},"subject2":{"name":"Phoenix Rising","birth_data":{"year":1989,"month":8,"day":8,"hour":8,"minute":8,"second":8,"city":"Sedona","country_code":"US"}},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Mean_South_Node","True_South_Node","Mean_Lilith","True_Lilith","Chiron","Part_of_Fortune"],"precision":3}}}}}},"required":true},"responses":{"200":{"description":"Successful synastry chart calculation with cross-aspects between both people's charts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryChartResponse"},"examples":{"successful_response":{"summary":"Successful chart calculation response","description":"Complete chart data with all requested calculations","value":{"subject_data":{"subject1":{"name":"Isabella Garcia","year":1990,"month":6,"day":15,"hour":14,"minute":30,"city":"Madrid","nation":"ES","lng":-3.7038,"lat":40.4168,"tz_str":"Europe/Madrid"},"subject2":{"name":"James Anderson","year":1988,"month":9,"day":22,"hour":18,"minute":45,"city":"London","nation":"GB","lng":-0.1278,"lat":51.5074,"tz_str":"Europe/London"}},"chart_data":{"planetary_positions":[{"name":"Sun_1","sign":"Gem","degree":24.15,"absolute_longitude":84.15,"house":9,"is_retrograde":false,"speed":0.958},{"name":"Sun_2","sign":"Vir","degree":29.82,"absolute_longitude":149.82,"house":2,"is_retrograde":false,"speed":0.958},{"name":"Venus_1","sign":"Tau","degree":8.45,"absolute_longitude":38.45,"house":7,"is_retrograde":false,"speed":1.202},{"name":"Mars_2","sign":"Sco","degree":12.78,"absolute_longitude":222.78,"house":4,"is_retrograde":false,"speed":0.634}],"house_cusps":[{"house":1,"sign":"Cap","degree":15.23},{"house":2,"sign":"Aqu","degree":12.45},{"house":3,"sign":"Pis","degree":18.67},{"house":4,"sign":"Ari","degree":25.89},{"house":5,"sign":"Tau","degree":28.12},{"house":6,"sign":"Gem","degree":24.34},{"house":7,"sign":"Can","degree":15.23},{"house":8,"sign":"Leo","degree":12.45},{"house":9,"sign":"Vir","degree":18.67},{"house":10,"sign":"Lib","degree":25.89},{"house":11,"sign":"Sco","degree":28.12},{"house":12,"sign":"Sag","degree":24.34}],"aspects":[{"point1":"Sun_1","point2":"Sun_2","aspect_type":"square","orb":5.67},{"point1":"Venus_1","point2":"Mars_2","aspect_type":"opposition","orb":4.33},{"point1":"Moon_1","point2":"Venus_2","aspect_type":"trine","orb":2.15},{"point1":"Mercury_1","point2":"Mercury_2","aspect_type":"sextile","orb":1.89},{"point1":"Jupiter_1","point2":"Ascendant_2","aspect_type":"conjunction","orb":0.75}]}}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation error - check subject data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/synastry\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"person1\": {\"name\": \"Alice\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"Paris\", \"country_code\": \"FR\"}}, \"person2\": {\"name\": \"Bob\", \"birth_data\": {\"year\": 1988, \"month\": 8, \"day\": 22, \"hour\": 18, \"minute\": 45, \"city\": \"Lisbon\", \"country_code\": \"PT\"}}, \"options\": {\"house_system\": \"P\", \"orb_set\": \"tight\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/synastry\";\n\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/synastry\";\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/synastry\"\n\n# Request data\ndata = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/synastry\"\n \n data := map[string]interface{}{\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/composite":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Composite (relationship as entity)","description":"👶 **Composite: The Third Entity** - The relationship itself as a separate chart\n\n**What this is:**\nCreates a **new chart** from mathematical midpoints between both people's planets.\nThis is the chart of the relationship itself — a \"third entity\" born from two people.\nAnswers the question: **\"What is OUR RELATIONSHIP's destiny?\"**\n\n**vs /synastry:** Use `/synastry` to see how two people influence each other (\"How do we interact?\")\n\n**Perfect for:**\n- 💑 Understanding relationship potential and destiny\n- 🎯 Couples counseling — what the relationship needs\n- 📅 Transits to composite — timing for the relationship\n- 📱 Dating apps — relationship compatibility score\n\n**How it works:**\n- `Composite Sun` = (Sun_Alice + Sun_Bob) / 2\n- `Composite Moon` = (Moon_Alice + Moon_Bob) / 2\n- Creates ONE unified chart representing combined energies\n\n**What you get:**\n- **Composite planetary positions** — midpoints of corresponding planets\n- **Composite houses** — where the relationship energy manifests\n- **Internal aspects** — aspects within the composite (Sun-Moon, Venus-Mars, etc.)\n- **Single unified chart** — NOT two separate charts\n\n**Example interpretation:**\n- Composite Sun in 7th house → relationship focused on partnership\n- Composite Moon square Saturn → emotional challenges in the relationship\n- Composite Venus conjunct Jupiter → abundant love and growth together\n\n**Metaphor:** Two people create a \"child\" — the relationship itself, which has its own chart and destiny.\n\n**Response time:** ~400ms | **Content:** Complete composite chart with planetary positions and aspects","operationId":"get_composite_chart_api_v3_charts_composite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeChartRequest"},"examples":{"basic_composite":{"summary":"Basic Composite Chart","description":"Calculate composite chart for two people using default options","value":{"subject1":{"name":"Alice Johnson","birth_data":{"year":1990,"month":3,"day":15,"hour":14,"minute":30,"city":"London","nation":"GB","timezone":"Europe/London"}},"subject2":{"name":"Bob Smith","birth_data":{"year":1988,"month":7,"day":22,"hour":9,"minute":45,"city":"Paris","nation":"FR","timezone":"Europe/Paris"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Ascendant","Medium_Coeli"],"precision":2}}},"advanced_composite":{"summary":"Advanced Composite Chart","description":"Composite chart with custom house system and extended planetary points","value":{"subject1":{"name":"Emma Wilson","birth_data":{"year":1985,"month":12,"day":8,"hour":18,"minute":15,"city":"New York","nation":"US","timezone":"America/New_York"}},"subject2":{"name":"Michael Davis","birth_data":{"year":1983,"month":4,"day":25,"hour":11,"minute":20,"city":"Sydney","nation":"AU","timezone":"Australia/Sydney"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Mean_Node","Chiron","Ascendant","Medium_Coeli"],"precision":3}}}}}},"required":true},"responses":{"200":{"description":"Successful composite chart calculation with midpoint-based planetary positions representing the relationship","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeChartResponse"},"examples":{"successful_response":{"summary":"Successful chart calculation response","description":"Complete chart data with all requested calculations","value":{"subject_data":{"subject1":{"name":"Alice Johnson","year":1990,"month":3,"day":15,"hour":14,"minute":30,"city":"London","nation":"GB","lng":-0.1278,"lat":51.5074,"tz_str":"Europe/London"},"subject2":{"name":"Bob Smith","year":1988,"month":7,"day":22,"hour":9,"minute":45,"city":"Paris","nation":"FR","lng":2.3522,"lat":48.8566,"tz_str":"Europe/Paris"},"composite_subject":{"name":"Alice & Bob Composite","year":1989,"month":5,"day":18,"hour":12,"minute":7,"city":"London","nation":"GB","lng":-1.65,"lat":49.5,"tz_str":"Europe/London"}},"chart_data":{"planetary_positions":[{"name":"Sun","sign":"Gem","degree":3.45,"absolute_longitude":63.45,"house":8,"is_retrograde":false,"speed":0.958},{"name":"Moon","sign":"Lib","degree":18.23,"absolute_longitude":198.23,"house":2,"is_retrograde":false,"speed":13.156},{"name":"Mercury","sign":"Can","degree":12.67,"absolute_longitude":102.67,"house":9,"is_retrograde":false,"speed":1.234},{"name":"Venus","sign":"Leo","degree":25.89,"absolute_longitude":145.89,"house":11,"is_retrograde":false,"speed":1.156},{"name":"Mars","sign":"Vir","degree":8.12,"absolute_longitude":158.12,"house":12,"is_retrograde":false,"speed":0.624},{"name":"Ascendant","sign":"Sco","degree":14.56,"absolute_longitude":224.56,"house":1,"is_retrograde":false},{"name":"Medium_Coeli","sign":"Leo","degree":22.34,"absolute_longitude":142.34,"house":10,"is_retrograde":false}],"house_cusps":[{"house":1,"sign":"Sco","degree":14.56},{"house":2,"sign":"Sag","degree":18.23},{"house":3,"sign":"Cap","degree":25.78},{"house":4,"sign":"Aqu","degree":2.34},{"house":5,"sign":"Pis","degree":8.91},{"house":6,"sign":"Ari","degree":12.45},{"house":7,"sign":"Tau","degree":14.56},{"house":8,"sign":"Gem","degree":18.23},{"house":9,"sign":"Can","degree":25.78},{"house":10,"sign":"Leo","degree":2.34},{"house":11,"sign":"Vir","degree":8.91},{"house":12,"sign":"Lib","degree":12.45}],"aspects":[{"point1":"Sun","point2":"Venus","aspect_type":"sextile","orb":2.44},{"point1":"Moon","point2":"Mars","aspect_type":"square","orb":10.11},{"point1":"Mercury","point2":"Ascendant","aspect_type":"trine","orb":1.89},{"point1":"Venus","point2":"Medium_Coeli","aspect_type":"conjunction","orb":3.55},{"point1":"Sun","point2":"Moon","aspect_type":"trine","orb":5.22}]}}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation error - check subject data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/composite\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/composite\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/composite\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/composite\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/composite\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/transit":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Transit Snapshot (specific moment)","description":"📸 **Transit Snapshot** - Planetary positions at a specific moment\n\n**What this is:**\nA \"photograph\" of the sky at a **specific date/time** overlaid on the natal chart.\nAnswers the question: **\"What's happening in my chart RIGHT NOW?\"**\n\n**Input:** Natal data + exact transit datetime (e.g., \"March 15, 2024 at 12:00\")\n\n**vs /natal-transits:** Use `/natal-transits` for period analysis (\"What transits await me in March?\")\n\n**Perfect for:**\n- 🎯 Daily astrological guidance — current sky snapshot\n- 📅 Checking transits for a specific moment\n- 🔮 Understanding \"what's happening now\"\n- 📱 Transit wheel visualizations\n\n**What you get:**\n- **Transit positions** (`Sun_transit`, `Moon_transit`, etc.) overlaid on natal chart\n- **Natal positions** (`Sun_natal`, `Moon_natal`, etc.) for reference\n- **Active aspects** between transiting and natal planets at this moment\n- **House overlays** showing which houses transits are activating\n- **Aspect orbs** — how close to exact each aspect is\n\n**Analysis includes:**\n- **Major transits** (Jupiter, Saturn, Uranus, Neptune, Pluto)\n- **Personal transits** (Sun, Moon, Mercury, Venus, Mars)\n- **Nodal transits** for karmic timing\n- **Angular transits** (to Ascendant, Midheaven)\n\n**Response time:** ~250ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_transit_chart_api_v3_charts_transit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitChartRequest"},"examples":{"current_transits":{"summary":"Current Transits - Today","description":"Current planetary transits to natal chart for today","value":{"subject":{"name":"Jennifer Wilson","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"transit_time":{"datetime":{"year":2024,"month":3,"day":15,"hour":12,"minute":0,"second":0,"city":"London","country_code":"GB"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2}}},"major_transits":{"summary":"Major Outer Planet Transits","description":"Focus on slow-moving outer planets for long-term influences","value":{"subject":{"name":"Robert Chen","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":40.7128,"longitude":-74.006}},"transit_time":{"datetime":{"year":2024,"month":7,"day":21,"hour":15,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Jupiter","Saturn","Uranus","Neptune","Pluto","Chiron","Mean_Node"],"precision":4}}},"relocation_transits":{"summary":"Relocated Transit Analysis","description":"Transits calculated for different location than birth (relocation astrology)","value":{"subject":{"name":"Maria Santos","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"London","country_code":"GB"}},"transit_time":{"datetime":{"year":2024,"month":12,"day":8,"hour":20,"minute":0,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Ascendant","Medium_Coeli"],"precision":3}}}}}},"required":true},"responses":{"200":{"description":"Successful transit chart calculation showing current planetary positions overlaid on natal chart","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitChartResponse"},"examples":{"successful_response":{"summary":"Successful chart calculation response","description":"Complete chart data with all requested calculations","value":{"subject_data":{"natal_subject":{"name":"Jennifer Wilson","year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","nation":"GB","lng":-0.1278,"lat":51.5074,"tz_str":"Europe/London","sun":{"name":"Sun","sign":"Tau","position":24.83,"abs_pos":54.83,"house":"Tenth_House"}},"transit_subject":{"name":"Transit Chart 2024-03-15","year":2024,"month":3,"day":15,"hour":12,"minute":0,"city":"London","nation":"GB","lng":-0.1278,"lat":51.5074,"tz_str":"Europe/London","sun":{"name":"Sun","sign":"Pis","position":25.12,"abs_pos":355.12,"house":"Eighth_House"}}},"chart_data":{"planetary_positions":[{"name":"Sun_transit","sign":"Pis","degree":25.12,"absolute_longitude":355.12,"house":8,"is_retrograde":false,"speed":0.958},{"name":"Moon_transit","sign":"Can","degree":8.45,"absolute_longitude":98.45,"house":12,"is_retrograde":false,"speed":12.892},{"name":"Jupiter_transit","sign":"Tau","degree":18.67,"absolute_longitude":48.67,"house":10,"is_retrograde":false,"speed":0.089},{"name":"Saturn_transit","sign":"Pis","degree":12.34,"absolute_longitude":342.34,"house":8,"is_retrograde":false,"speed":0.034},{"name":"Sun_natal","sign":"Tau","degree":24.83,"absolute_longitude":54.83,"house":10,"is_retrograde":false,"speed":0.958},{"name":"Moon_natal","sign":"Sco","degree":12.45,"absolute_longitude":222.45,"house":4,"is_retrograde":false,"speed":13.156}],"house_cusps":[{"house":1,"sign":"Leo","degree":5.12},{"house":2,"sign":"Vir","degree":2.45},{"house":3,"sign":"Lib","degree":8.23},{"house":4,"sign":"Sco","degree":18.89},{"house":5,"sign":"Sag","degree":24.67},{"house":6,"sign":"Cap","degree":22.12},{"house":7,"sign":"Aqu","degree":5.12},{"house":8,"sign":"Pis","degree":2.45},{"house":9,"sign":"Ari","degree":8.23},{"house":10,"sign":"Tau","degree":18.89},{"house":11,"sign":"Gem","degree":24.67},{"house":12,"sign":"Can","degree":22.12}],"aspects":[{"point1":"Sun_transit","point2":"Sun_natal","aspect_type":"trine","orb":0.29},{"point1":"Jupiter_transit","point2":"Sun_natal","aspect_type":"conjunction","orb":6.16},{"point1":"Saturn_transit","point2":"Moon_natal","aspect_type":"trine","orb":2.11},{"point1":"Moon_transit","point2":"Jupiter_natal","aspect_type":"opposition","orb":7.33},{"point1":"Mars_transit","point2":"Ascendant_natal","aspect_type":"square","orb":4.67}]}}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation error - check subject data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/transit\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/transit\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/transit\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/transit\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/transit\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/solar-return":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Chart Solar Return","description":"☀️ **Solar Return Chart** - Annual birthday chart for yearly forecasting\n\n**Perfect for:**\n- 🎂 Annual birthday readings\n- 📅 Year-ahead planning and forecasting\n- 🎯 Understanding yearly themes and focus\n- 📊 Professional annual consultations\n\n**What you get:**\n- **Solar return chart** calculated for exact Sun return moment\n- **Relocated chart** for current residence (if different from birth)\n- **House emphasis** showing life areas of focus for the year\n- **Planetary aspects** indicating yearly themes\n- **Angular planets** for major yearly influences\n\n**Forecasting insights:**\n- **Career and reputation** (10th house emphasis)\n- **Relationships and partnerships** (7th house focus)\n- **Health and daily routine** (6th house themes)\n- **Home and family** (4th house matters)\n- **Creativity and romance** (5th house activities)\n\n**Technical details:**\n- Calculated for exact moment Sun returns to natal degree\n- Uses current location (relocation astrology)\n- Valid for one solar year (birthday to birthday)\n\n**Response time:** ~300ms | **Accuracy:** Precise solar return timing","operationId":"get_solar_return_chart_api_v3_charts_solar_return_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnRequest"},"examples":{"birthday_2024":{"summary":"2024 Birthday Chart","description":"Solar return for 2024 calculated at birth location","value":{"subject":{"name":"Birthday Person","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_year":2024,"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":3}}},"relocated_return":{"summary":"Relocated Solar Return","description":"Solar return calculated for current residence (different from birth location)","value":{"subject":{"name":"Relocated Person","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"return_year":2025,"return_location":{"year":2025,"month":8,"day":22,"hour":12,"minute":0,"city":"Tokyo","country_code":"JP"},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron","Mean_Node"],"precision":2}}},"precise_coordinates":{"summary":"High Precision Solar Return","description":"Solar return with exact coordinates for maximum accuracy","value":{"subject":{"name":"Precision Seeker","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":30,"latitude":40.7128,"longitude":-74.006}},"return_year":2024,"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Ascendant","Medium_Coeli"],"precision":6}}}}}},"required":true},"responses":{"200":{"description":"Successful solar return chart calculation for the exact moment Sun returns to natal degree","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnChartResponse"},"examples":{"successful_response":{"summary":"Successful chart calculation response","description":"Complete chart data with all requested calculations","value":{"subject_data":{"name":"Birthday Person","year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","nation":"GB","lng":-0.1278,"lat":51.5074,"tz_str":"Europe/London"},"chart_data":{"planetary_positions":[{"name":"Sun","sign":"Tau","degree":24.83,"absolute_longitude":54.83,"house":9,"is_retrograde":false,"speed":0.958},{"name":"Moon","sign":"Aqu","degree":16.78,"absolute_longitude":316.78,"house":5,"is_retrograde":false,"speed":14.234},{"name":"Mercury","sign":"Tau","degree":1.45,"absolute_longitude":31.45,"house":8,"is_retrograde":true,"speed":-0.782},{"name":"Venus","sign":"Gem","degree":12.91,"absolute_longitude":72.91,"house":10,"is_retrograde":false,"speed":1.234},{"name":"Mars","sign":"Ari","degree":5.67,"absolute_longitude":5.67,"house":7,"is_retrograde":false,"speed":0.725},{"name":"Jupiter","sign":"Gem","degree":28.23,"absolute_longitude":88.23,"house":11,"is_retrograde":false,"speed":0.156},{"name":"Saturn","sign":"Pis","degree":18.34,"absolute_longitude":348.34,"house":6,"is_retrograde":false,"speed":0.089},{"name":"Uranus","sign":"Tau","degree":22.78,"absolute_longitude":52.78,"house":9,"is_retrograde":false,"speed":0.045},{"name":"Neptune","sign":"Pis","degree":29.12,"absolute_longitude":359.12,"house":6,"is_retrograde":true,"speed":-0.021},{"name":"Pluto","sign":"Aqu","degree":2.45,"absolute_longitude":302.45,"house":5,"is_retrograde":true,"speed":-0.012},{"name":"Ascendant","sign":"Vir","degree":28.56,"absolute_longitude":148.56,"house":1,"is_retrograde":false},{"name":"Medium_Coeli","sign":"Gem","degree":15.23,"absolute_longitude":75.23,"house":10,"is_retrograde":false}],"house_cusps":[{"house":1,"sign":"Vir","degree":28.56},{"house":2,"sign":"Lib","degree":22.34},{"house":3,"sign":"Sco","degree":18.78},{"house":4,"sign":"Sag","degree":15.23},{"house":5,"sign":"Cap","degree":12.91},{"house":6,"sign":"Aqu","degree":8.45},{"house":7,"sign":"Pis","degree":28.56},{"house":8,"sign":"Ari","degree":22.34},{"house":9,"sign":"Tau","degree":18.78},{"house":10,"sign":"Gem","degree":15.23},{"house":11,"sign":"Can","degree":12.91},{"house":12,"sign":"Leo","degree":8.45}],"aspects":[{"point1":"Sun","point2":"Uranus","aspect_type":"conjunction","orb":2.05},{"point1":"Mercury","point2":"Mars","aspect_type":"conjunction","orb":4.22},{"point1":"Venus","point2":"Jupiter","aspect_type":"opposition","orb":4.32},{"point1":"Moon","point2":"Saturn","aspect_type":"sextile","orb":1.56},{"point1":"Mars","point2":"Ascendant","aspect_type":"trine","orb":7.11},{"point1":"Neptune","point2":"Pluto","aspect_type":"sextile","orb":3.33}]}}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation error - check subject data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/solar-return\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/solar-return\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/solar-return\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/solar-return\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/solar-return\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/lunar-return":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Chart Lunar Return","description":"🌙 **Lunar Return Chart** - Monthly Moon return for short-term forecasting\n\n**Perfect for:**\n- 🌙 Monthly planning and timing\n- 📅 Short-term emotional cycles\n- 🎯 Understanding monthly themes\n- 📊 Complementing solar return analysis\n\n**What you get:**\n- **Lunar return chart** for exact Moon return to natal position\n- **Monthly emotional themes** and focus areas\n- **Relationship dynamics** for the lunar month\n- **Daily life patterns** and routine changes\n- **Intuitive and psychic cycles**\n\n**Monthly insights:**\n- **Emotional focus** (Moon's house position)\n- **Communication patterns** (Mercury aspects)\n- **Social interactions** (Venus influences)\n- **Energy levels** (Mars placement)\n- **Subconscious patterns** (12th house themes)\n\n**Technical details:**\n- Calculated for exact moment Moon returns to natal degree\n- Occurs approximately every 27.3 days\n- Valid for one sidereal month\n- Uses current location for relocated chart\n\n**Response time:** ~250ms | **Accuracy:** Precise lunar return timing","operationId":"get_lunar_return_chart_api_v3_charts_lunar_return_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnRequest"},"examples":{"current_lunar_return":{"summary":"Current Lunar Return","description":"Most recent lunar return for monthly planning and emotional cycles","value":{"subject":{"name":"Luna Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_date":"2024-03-15","options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3}}},"relocated_lunar":{"summary":"Relocated Lunar Return","description":"Lunar return calculated for current location (relocation astrology)","value":{"subject":{"name":"Lunar Traveler","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Sydney","country_code":"AU"}},"return_date":"2024-04-20","return_location":{"year":2024,"month":4,"day":20,"hour":14,"minute":30,"city":"Paris","country_code":"FR"},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":2}}},"precise_lunar_timing":{"summary":"Precise Lunar Timing","description":"High precision lunar return with exact coordinates and timing","value":{"subject":{"name":"Lunar Precision","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":30,"latitude":35.6762,"longitude":139.6503}},"return_date":"2024-07-05","options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron","Part_of_Fortune"],"precision":4}}}}}},"required":true},"responses":{"200":{"description":"Successful lunar return chart calculation for the exact moment Moon returns to natal degree","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnChartResponse"},"examples":{"successful_response":{"summary":"Successful lunar return chart calculation","description":"Complete lunar return chart data with all planetary positions and aspects","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","nation":"UA","lng":36.2304,"lat":49.9935,"tz_str":"Europe/Kiev","lunar_return_date":"2024-03-15T14:32:15Z"},"chart_data":{"planetary_positions":[{"name":"Sun","sign":"Pis","degree":25.12,"absolute_longitude":355.12,"house":8,"is_retrograde":false,"speed":0.958},{"name":"Moon","sign":"Tau","degree":20.83,"absolute_longitude":50.83,"house":10,"is_retrograde":false,"speed":13.234},{"name":"Mercury","sign":"Ari","degree":8.45,"absolute_longitude":8.45,"house":9,"is_retrograde":false,"speed":1.234},{"name":"Venus","sign":"Aqu","degree":15.67,"absolute_longitude":315.67,"house":7,"is_retrograde":false,"speed":1.156},{"name":"Mars","sign":"Aqu","degree":22.89,"absolute_longitude":322.89,"house":7,"is_retrograde":false,"speed":0.624},{"name":"Ascendant","sign":"Can","degree":12.34,"absolute_longitude":102.34,"house":1,"is_retrograde":false},{"name":"Medium_Coeli","sign":"Pis","degree":28.91,"absolute_longitude":358.91,"house":10,"is_retrograde":false}],"house_cusps":[{"house":1,"sign":"Can","degree":12.34},{"house":2,"sign":"Leo","degree":8.67},{"house":3,"sign":"Vir","degree":15.23},{"house":4,"sign":"Lib","degree":28.91},{"house":5,"sign":"Sco","degree":25.45},{"house":6,"sign":"Sag","degree":18.78},{"house":7,"sign":"Cap","degree":12.34},{"house":8,"sign":"Aqu","degree":8.67},{"house":9,"sign":"Pis","degree":15.23},{"house":10,"sign":"Ari","degree":28.91},{"house":11,"sign":"Tau","degree":25.45},{"house":12,"sign":"Gem","degree":18.78}],"aspects":[{"point1":"Sun","point2":"Moon","aspect_type":"trine","orb":4.29},{"point1":"Mercury","point2":"Mars","aspect_type":"sextile","orb":2.44},{"point1":"Venus","point2":"Mars","aspect_type":"conjunction","orb":7.22},{"point1":"Moon","point2":"Medium_Coeli","aspect_type":"trine","orb":1.92},{"point1":"Sun","point2":"Ascendant","aspect_type":"square","orb":3.22}]}}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid request data","description":"Example of validation error response","value":{"detail":[{"type":"value_error","loc":["body","return_date"],"msg":"Invalid date format. Use YYYY-MM-DD","input":"2024-13-45"}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/lunar-return\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/lunar-return\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/lunar-return\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/lunar-return\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/lunar-return\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/solar-return-transits":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Solar Return Transits","description":"☀️🔄 **Solar Return Transit Analysis** - Current planetary influences on your yearly chart\n\n**Perfect for:**\n- 🎂 Annual birthday chart transit tracking\n- 📅 Timing major yearly events and decisions\n- 🎯 Understanding current influences within your solar year\n- 📊 Professional annual consultation materials\n\n**What you get:**\n- **Transits to solar return chart** - how current planets affect your yearly forecast\n- **Aspect direction analysis** - applying (forming), separating (dissolving), or exact\n- **Precise timing calculations** - exact moment when aspects become perfect (0° orb)\n- **Transit speed data** - planetary velocity for dynamic interpretation\n- **Orb measurements** - exact angular distance from perfect aspects\n\n**Analysis includes:**\n- **Major yearly transits** (Jupiter, Saturn, Uranus, Neptune, Pluto)\n- **Personal transits** (Sun, Moon, Mercury, Venus, Mars) to solar return positions\n- **Timing precision** for peak influence periods\n- **Dynamic interpretation** based on planetary speeds and directions\n\n**Technical features:**\n- **Aspect direction**: Whether aspect is forming or dissolving\n- **Exact timing**: Precise moment for aspect culmination (when calculable)\n- **Transit speed**: Planet velocity in degrees/day (negative = retrograde)\n\n**Note:** Analyzes transits to your solar return chart (yearly forecast chart).\nPerfect for timing events and understanding influences within your solar year cycle.\n\n**Response time:** ~350ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_solar_return_transits_api_v3_charts_solar_return_transits_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnTransitRequest"},"examples":{"birthday_transits":{"summary":"Birthday Year Transits","description":"Current transits to solar return chart for birthday year analysis","value":{"subject":{"name":"Birthday Tracker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_year":2024,"date_range":{"start_date":{"year":2024,"month":5,"day":15},"end_date":{"year":2025,"month":5,"day":14}},"orb":2.0}},"relocated_sr_transits":{"summary":"Relocated Solar Return Transits","description":"Transits to relocated solar return chart for different location analysis","value":{"subject":{"name":"Relocated Analyst","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"return_year":2024,"return_location":{"year":2025,"month":8,"day":22,"hour":12,"minute":0,"city":"Tokyo","country_code":"JP"},"date_range":{"start_date":{"year":2024,"month":8,"day":22},"end_date":{"year":2024,"month":11,"day":22}},"orb":1.5}},"precise_sr_timing":{"summary":"Precise Solar Return Timing","description":"High precision transits to solar return for exact event timing","value":{"subject":{"name":"Precision Timer","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":30,"latitude":40.7128,"longitude":-74.006}},"return_year":2024,"date_range":{"start_date":{"year":2024,"month":11,"day":1},"end_date":{"year":2024,"month":11,"day":30}},"orb":0.5}}}}},"required":true},"responses":{"200":{"description":"Successful solar return transit calculation with current planetary influences on yearly chart","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnTransitChartResponse"},"examples":{"successful_response":{"summary":"Successful solar return transits calculation","description":"Complete transit analysis to solar return chart with precise timing","value":{"events":[{"date":"2024-05-15","exact_time":"2024-05-15T10:32:00Z","transiting_planet":"Jupiter","aspect_type":"trine","stationed_planet":"Sun","orb":1.25,"aspect_direction":"applying","transiting_speed":0.089,"transiting_house":9,"natal_house":10},{"date":"2024-05-18","exact_time":"2024-05-18T14:45:00Z","transiting_planet":"Saturn","aspect_type":"square","stationed_planet":"Moon","orb":0.75,"aspect_direction":"separating","transiting_speed":0.034,"transiting_house":6,"natal_house":4},{"date":"2024-05-20","exact_time":"2024-05-20T08:15:00Z","transiting_planet":"Mars","aspect_type":"conjunction","stationed_planet":"Mercury","orb":0.45,"aspect_direction":"exact","transiting_speed":0.634,"transiting_house":8,"natal_house":8}]}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid date range","description":"Example of validation error for invalid date range","value":{"detail":[{"type":"value_error","loc":["body","date_range","end_date"],"msg":"End date must be after start date","input":{"start_date":"2024-05-15","end_date":"2024-05-10"}}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/solar-return-transits\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/solar-return-transits\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/solar-return-transits\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/solar-return-transits\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/solar-return-transits\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/lunar-return-transits":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Chart Lunar Return Transits","description":"Calculates exact transits to a lunar return chart over a given period.\n\nAnalyzes transits to your lunar return chart (monthly forecast chart).\nPerfect for timing events within your lunar month cycle.","operationId":"get_lunar_return_transits_api_v3_charts_lunar_return_transits_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnTransitRequest"},"examples":{"monthly_lunar_transits":{"summary":"Monthly Lunar Transits","description":"Current transits to lunar return chart for monthly emotional timing","value":{"subject":{"name":"Lunar Transit Tracker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_date":"2024-03-15","date_range":{"start_date":{"year":2024,"month":3,"day":15},"end_date":{"year":2024,"month":4,"day":14}},"orb":1.5}},"precise_lunar_timing":{"summary":"Precise Lunar Timing","description":"High precision lunar return transits for exact event timing","value":{"subject":{"name":"Lunar Precision Timer","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":35.6762,"longitude":139.6503}},"return_date":"2024-07-05","date_range":{"start_date":{"year":2024,"month":7,"day":5},"end_date":{"year":2024,"month":7,"day":12}},"orb":0.5}}}}},"required":true},"responses":{"200":{"description":"Successful lunar return transit calculation with current planetary influences on monthly chart","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnTransitChartResponse"},"examples":{"successful_response":{"summary":"Successful lunar return transits calculation","description":"Complete transit analysis to lunar return chart with emotional timing","value":{"events":[{"date":"2024-03-18","exact_time":"2024-03-18T06:42:00Z","transiting_planet":"Moon","aspect_type":"square","stationed_planet":"Moon","orb":0.15,"aspect_direction":"exact","transiting_speed":12.892,"transiting_house":1,"natal_house":10},{"date":"2024-03-20","exact_time":"2024-03-20T11:30:00Z","transiting_planet":"Mercury","aspect_type":"conjunction","stationed_planet":"Sun","orb":0.89,"aspect_direction":"applying","transiting_speed":1.234,"transiting_house":8,"natal_house":8},{"date":"2024-03-22","transiting_planet":"Venus","aspect_type":"trine","stationed_planet":"Ascendant","orb":1.45,"aspect_direction":"separating","transiting_speed":1.156,"transiting_house":9,"natal_house":1}]}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid lunar return date","description":"Example of validation error for invalid return date","value":{"detail":[{"type":"value_error","loc":["body","return_date"],"msg":"Lunar return date must be within reasonable range of birth date","input":"1900-01-01"}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/lunar-return-transits\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/lunar-return-transits\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/lunar-return-transits\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/lunar-return-transits\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/lunar-return-transits\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/progressions":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Chart Progressions","description":"Calculates a progression chart based on the specified type.\n\nSupported progression types:\n- **secondary**: Day-for-a-year progressions (most common)\n- **primary**: Degree-for-a-year (not yet implemented)\n- **tertiary**: Day-for-a-month (not yet implemented)\n- **minor**: Month-for-a-year (not yet implemented)","operationId":"get_progression_chart_api_v3_charts_progressions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionRequest"},"examples":{"secondary_progression":{"summary":"Secondary Progressions","description":"Day-for-a-year progressions for current age analysis","value":{"subject":{"name":"Progression Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"target_date":"2024-03-15","progression_type":"secondary","options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3}}},"coordinates_progression":{"summary":"High Precision Progressions","description":"Secondary progressions with exact coordinates for maximum accuracy","value":{"subject":{"name":"Precise Progressor","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":30,"latitude":48.8566,"longitude":2.3522}},"target_date":"2024-08-22","progression_type":"secondary","options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Ascendant","Medium_Coeli"],"precision":4}}}}}},"required":true},"responses":{"200":{"description":"Successful progression chart calculation with evolved planetary positions based on progression method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionChartResponse"},"examples":{"successful_response":{"summary":"Successful progression chart calculation","description":"Complete progression chart data with advanced planetary positions","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","nation":"UA","lng":36.2304,"lat":49.9935,"tz_str":"Europe/Kiev"},"progressed_data":{"name":"Oleg (Progressed)","year":1985,"month":6,"day":19,"hour":18,"minute":15,"city":"Kharkiv","nation":"UA"},"chart_data":{"planetary_positions":[{"name":"Sun","sign":"Gem","degree":12.45,"absolute_longitude":72.45,"house":11,"is_retrograde":false,"speed":0.958},{"name":"Moon","sign":"Sag","degree":8.91,"absolute_longitude":248.91,"house":4,"is_retrograde":false,"speed":13.156},{"name":"Mercury","sign":"Can","degree":2.67,"absolute_longitude":92.67,"house":12,"is_retrograde":false,"speed":1.234},{"name":"Venus","sign":"Leo","degree":18.34,"absolute_longitude":138.34,"house":1,"is_retrograde":false,"speed":1.156}],"house_cusps":[{"house":1,"sign":"Leo","degree":5.12},{"house":2,"sign":"Vir","degree":2.45},{"house":3,"sign":"Lib","degree":8.23},{"house":4,"sign":"Sco","degree":18.89},{"house":5,"sign":"Sag","degree":24.67},{"house":6,"sign":"Cap","degree":22.12},{"house":7,"sign":"Aqu","degree":5.12},{"house":8,"sign":"Pis","degree":2.45},{"house":9,"sign":"Ari","degree":8.23},{"house":10,"sign":"Tau","degree":18.89},{"house":11,"sign":"Gem","degree":24.67},{"house":12,"sign":"Can","degree":22.12}],"aspects":[{"point1":"Sun","point2":"Moon","aspect_type":"trine","orb":3.54},{"point1":"Mercury","point2":"Venus","aspect_type":"square","orb":5.67},{"point1":"Venus","point2":"Mars","aspect_type":"sextile","orb":2.44}]},"progression_type":"secondary","target_date":"2024-05-11"}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid progression type","description":"Example of validation error for unsupported progression method","value":{"detail":[{"type":"value_error","loc":["body","progression_type"],"msg":"Progression type must be 'secondary'. Other types not yet implemented.","input":"tertiary"}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/progressions\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/progressions\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/progressions\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/progressions\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/progressions\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/directions":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Chart Directions","description":"Calculates a direction chart based on the specified type.\n\nSupported direction types:\n- **solar_arc**: All planets move by the progressed Sun's arc\n- **symbolic**: Fixed rate (default 1° = 1 year, customizable)\n- **profection**: 30° = 1 year (not yet implemented)\n- **naibod**: 0.9856° = 1 year (not yet implemented)","operationId":"get_direction_chart_api_v3_charts_directions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectionRequest"},"examples":{"primary_directions":{"summary":"Primary Directions","description":"Traditional primary directions for major life timing and events","value":{"subject":{"name":"Direction Master","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"target_date":"2024-03-15","direction_type":"solar_arc","options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3}}},"coordinates_directions":{"summary":"High Precision Directions","description":"Primary directions with exact coordinates for maximum accuracy","value":{"subject":{"name":"Precise Director","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":30,"latitude":48.8566,"longitude":2.3522}},"target_date":"2024-08-22","direction_type":"solar_arc","options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Ascendant"],"precision":4}}}}}},"required":true},"responses":{"200":{"description":"Successful direction chart calculation with planetary positions moved by directional arc","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectionChartResponse"},"examples":{"successful_response":{"summary":"Successful direction chart calculation","description":"Complete direction chart data with directed planetary positions","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","nation":"UA","lng":36.2304,"lat":49.9935,"tz_str":"Europe/Kiev"},"directed_data":{"name":"Oleg (Directed)","year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","nation":"UA"},"chart_data":{"planetary_positions":[{"name":"Sun","sign":"Can","degree":29.98,"absolute_longitude":119.98,"house":1,"is_retrograde":false},{"name":"Moon","sign":"Can","degree":29.98,"absolute_longitude":119.98,"house":1,"is_retrograde":false},{"name":"Mercury","sign":"Leo","degree":24.6,"absolute_longitude":144.6,"house":2,"is_retrograde":false}],"house_cusps":[{"house":1,"sign":"Vir","degree":14.27},{"house":2,"sign":"Lib","degree":11.6},{"house":3,"sign":"Sco","degree":17.38},{"house":4,"sign":"Sag","degree":28.04},{"house":5,"sign":"Aqu","degree":3.82},{"house":6,"sign":"Pis","degree":1.27},{"house":7,"sign":"Pis","degree":14.27},{"house":8,"sign":"Ari","degree":11.6},{"house":9,"sign":"Tau","degree":17.38},{"house":10,"sign":"Gem","degree":28.04},{"house":11,"sign":"Leo","degree":3.82},{"house":12,"sign":"Vir","degree":1.27}],"aspects":[{"point1":"Sun","point2":"Moon","aspect_type":"conjunction","orb":0.0},{"point1":"Mercury","point2":"Venus","aspect_type":"sextile","orb":4.54}]},"direction_type":"solar_arc","arc_used":39.15,"target_date":"2024-05-11"}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid direction type","description":"Example of validation error for unsupported direction method","value":{"detail":[{"type":"value_error","loc":["body","direction_type"],"msg":"Direction type must be 'solar_arc' or 'symbolic'. Other types not yet implemented.","input":"primary"}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/directions\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/directions\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/directions\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/directions\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/directions\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/charts/natal-transits":{"post":{"tags":["🗺️ Chart Data & Analysis"],"summary":"Transit Period Analysis (date range)","description":"📅 **Transit Period Analysis** - All transits over a date range with exact timing\n\n**What this is:**\nAnalyzes all transits over a **date range** with calculation of exact aspect times.\nAnswers the question: **\"What transits await me in March?\"**\n\n**Input:** Natal data + date_range (start_date → end_date) + orb\n\n**vs /transit:** Use `/transit` for a snapshot at a specific moment (\"What's happening now?\")\n\n**Perfect for:**\n- 📅 Monthly/yearly transit forecasts\n- 🔔 Transit notification and calendar apps\n- 🎯 Planning important events around favorable transits\n- 📊 Long-term astrological planning\n\n**What you get:**\n- **All transits in the period** with dates when aspects form\n- **Exact timing** (`exact_time`) — precise moment when aspect perfects (0° orb)\n- **Aspect direction** — `applying` (forming), `separating` (dissolving), or `exact`\n- **Transit speed** — planetary velocity (negative = retrograde)\n- **Orb measurements** — angular distance from perfection\n- **Period statistics** — total transits, major transits, exact aspects count\n\n**Analysis includes:**\n- **Major life transits** (Jupiter, Saturn, Uranus, Neptune, Pluto)\n- **Personal daily transits** (Sun, Moon, Mercury, Venus, Mars)\n- **Nodal transits** for karmic timing and life direction\n- **Angular transits** to Ascendant, Midheaven for major life themes\n\n**Technical features:**\n- **Aspect direction**: `applying` (forming), `separating` (dissolving), or `exact`\n- **Exact timing**: ISO datetime when aspect perfects (for close applying aspects)\n- **Transit speed**: Planet speed in degrees/day (negative = retrograde)\n\n**Example response data:**\n```json\n{\n \"date\": \"2024-01-15\",\n \"exact_time\": \"2024-01-15T14:32:00\",\n \"transiting_planet\": \"Mars\",\n \"aspect_type\": \"trine\",\n \"stationed_planet\": \"Sun\",\n \"orb\": 0.75,\n \"aspect_direction\": \"applying\",\n \"transiting_speed\": 0.524\n}\n```\n\n**Response time:** ~300ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_natal_transits_api_v3_charts_natal_transits_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitRequest"},"examples":{"current_transits":{"summary":"Current Transits Analysis","description":"Current planetary transits to natal chart for timing and guidance","value":{"subject":{"name":"Transit Tracker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"date_range":{"start_date":{"year":2024,"month":3,"day":1},"end_date":{"year":2024,"month":3,"day":31}},"orb":2.0}},"major_transits_year":{"summary":"Major Yearly Transits","description":"Outer planet transits for the year with wider orbs for long-term planning","value":{"subject":{"name":"Long Term Planner","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":48.8566,"longitude":2.3522}},"date_range":{"start_date":{"year":2024,"month":1,"day":1},"end_date":{"year":2024,"month":12,"day":31}},"orb":3.0}},"precise_timing":{"summary":"Precise Weekly Timing","description":"High-precision weekly transit analysis for exact timing of events","value":{"subject":{"name":"Timing Master","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Tokyo","country_code":"JP"}},"date_range":{"start_date":{"year":2024,"month":4,"day":15},"end_date":{"year":2024,"month":4,"day":21}},"orb":0.5}}}}},"required":true},"responses":{"200":{"description":"Successful natal transit calculation with current planetary influences on birth chart","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitChartResponse"},"examples":{"successful_response":{"summary":"Successful natal transits calculation","description":"Complete transit analysis to natal chart with precise timing and aspects","value":{"events":[{"date":"2024-05-11","exact_time":"2024-05-11T08:15:00Z","transiting_planet":"Jupiter","aspect_type":"conjunction","stationed_planet":"Sun","orb":0.25,"aspect_direction":"exact","transiting_speed":0.089,"transiting_house":10,"natal_house":10},{"date":"2024-05-15","exact_time":"2024-05-15T14:32:00Z","transiting_planet":"Saturn","aspect_type":"trine","stationed_planet":"Moon","orb":1.67,"aspect_direction":"applying","transiting_speed":0.034,"transiting_house":8,"natal_house":10},{"date":"2024-05-18","transiting_planet":"Mars","aspect_type":"square","stationed_planet":"Mercury","orb":2.89,"aspect_direction":"separating","transiting_speed":0.634,"transiting_house":9,"natal_house":11},{"date":"2024-05-20","exact_time":"2024-05-20T10:45:00Z","transiting_planet":"Venus","aspect_type":"sextile","stationed_planet":"Venus","orb":0.78,"aspect_direction":"applying","transiting_speed":1.156,"transiting_house":2,"natal_house":12}]}}}}}},"400":{"description":"Invalid chart parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid orb value","description":"Example of validation error for invalid orb parameter","value":{"detail":[{"type":"value_error","loc":["body","orb"],"msg":"Orb must be between 0.1 and 10.0 degrees","input":15.5}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/charts/natal-transits\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/charts/natal-transits\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/charts/natal-transits\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/charts/natal-transits\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/charts/natal-transits\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/render/natal":{"post":{"tags":["🎨 Chart Rendering"],"summary":"Render Natal Chart","description":"🎨 **Render Natal Chart** - Generate visual birth chart in multiple formats\n\n**Output Formats:**\n- `svg` - Scalable vector (default) - best for web, infinite scaling\n- `png` - Raster with transparency - universal compatibility\n- `jpg` - Compressed raster - email-compatible (works in Outlook!)\n- `webp` - Modern format - 30% smaller than PNG\n- `pdf` - Print-ready vector - professional quality\n\n**Size Options:**\n- `width` - Output width in pixels (100-4096), height auto-calculated\n- `scale` - Resolution multiplier (0.5-4.0) for HiDPI/retina displays\n\n**Quality:**\n- `quality` - For jpg/webp formats (1-100), default 90\n\n**🎨 Custom Colors (NEW!):**\nCreate branded charts with your own color scheme:\n- `background` - Chart background color\n- `text` - Text and lines color\n- `primary` / `secondary` - Accent colors\n- `aspect_harmony` - Harmonious aspects (green)\n- `aspect_tension` - Tense aspects (red)\n- `zodiac_bg_0` / `zodiac_bg_1` - Alternating zodiac sector colors\n\n**Use Cases:**\n- 📧 Email reports → `jpg` or `png` (Outlook compatible)\n- 🌐 Web display → `svg` or `webp`\n- 📱 Social media → `jpg` with width=1080\n- 🖨️ Print → `pdf` with scale=2.0\n- 📱 Retina → `png` with scale=2.0\n- 🎨 White-label → `custom_colors` for brand consistency\n\n**Response time:** ~400-600ms depending on format","operationId":"render_natal_chart_api_v3_render_natal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalChartRenderRequest"},"examples":{"svg_default":{"summary":"SVG (Default)","description":"Scalable vector format, perfect for web display","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"P","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"]},"render_options":{"format":"svg","theme":"dark"}}},"png_email":{"summary":"PNG for Email","description":"Raster format with transparency, works in all email clients including Outlook","value":{"subject":{"name":"Emma Wilson","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"render_options":{"format":"png","width":800,"theme":"light"}}},"jpg_social":{"summary":"JPG for Social Media","description":"Compressed format ideal for sharing on social platforms","value":{"subject":{"name":"Maria Santos","birth_data":{"year":1988,"month":3,"day":15,"hour":9,"minute":45,"city":"Paris","country_code":"FR"}},"render_options":{"format":"jpg","width":1080,"quality":85,"theme":"dark"}}},"pdf_print":{"summary":"PDF for Print","description":"Vector format for high-quality printing","value":{"subject":{"name":"James Chen","birth_data":{"year":1975,"month":12,"day":8,"hour":6,"minute":0,"city":"Tokyo","country_code":"JP"}},"render_options":{"format":"pdf","scale":2.0,"theme":"classic"}}},"webp_modern":{"summary":"WebP for Modern Web","description":"Modern format with excellent compression (30% smaller than PNG)","value":{"subject":{"name":"Sophie Brown","birth_data":{"year":1995,"month":6,"day":21,"hour":12,"minute":0,"city":"Sydney","country_code":"AU"}},"render_options":{"format":"webp","width":1200,"quality":80,"theme":"dark"}}},"retina_hd":{"summary":"Retina/HiDPI","description":"Double resolution for high-density displays","value":{"subject":{"name":"Anna Schmidt","birth_data":{"year":1992,"month":11,"day":3,"hour":20,"minute":30,"city":"Berlin","country_code":"DE"}},"render_options":{"format":"png","scale":2.0,"theme":"dark-high-contrast"}}},"custom_brand_colors":{"summary":"🎨 Custom Brand Colors","description":"Chart with custom brand colors - perfect for white-label apps","value":{"subject":{"name":"Custom Brand","birth_data":{"year":1990,"month":6,"day":15,"hour":12,"minute":0,"city":"New York","country_code":"US"}},"render_options":{"format":"png","width":1200,"theme":"dark","custom_colors":{"background":"#1a1a2e","text":"#eaeaea","primary":"#6366f1","secondary":"#ec4899","aspect_harmony":"#22c55e","aspect_tension":"#ef4444","zodiac_bg_0":"#2d2d44","zodiac_bg_1":"#3d3d5c"}}}},"cosmic_purple_theme":{"summary":"🌌 Cosmic Purple Theme","description":"Deep space aesthetic with purple/cyan accents","value":{"subject":{"name":"Cosmic Style","birth_data":{"year":1995,"month":3,"day":21,"hour":0,"minute":0,"city":"Los Angeles","country_code":"US"}},"render_options":{"format":"png","width":1080,"theme":"dark","custom_colors":{"background":"#0f0f23","text":"#e0e0ff","primary":"#a855f7","secondary":"#06b6d4","aspect_harmony":"#34d399","aspect_tension":"#f43f5e"}}}}}}},"required":true},"responses":{"200":{"description":"Chart image in requested format","content":{"application/json":{"schema":{}},"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid render parameters"},"422":{"description":"Validation error - check render options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/render/natal\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/render/natal\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/render/natal\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/render/natal\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/render/natal\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/render/synastry":{"post":{"tags":["🎨 Chart Rendering"],"summary":"Render Synastry Chart","description":"💕 **Render Synastry Chart** - Relationship compatibility visualization\n\n**What you get:**\n- Dual-ring chart showing both partners' planetary positions\n- Aspect lines connecting related planets between charts\n- Color-coded connections (harmonious vs challenging)\n\n**Formats:** svg, png, jpg, webp, pdf\n\n**Response time:** ~500-700ms","operationId":"render_synastry_chart_api_v3_render_synastry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryChartRenderRequest"},"examples":{"relationship_svg":{"summary":"Relationship Chart (SVG)","description":"Synastry chart showing compatibility between two people","value":{"subject1":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"subject2":{"name":"Elena","birth_data":{"year":1988,"month":9,"day":22,"hour":14,"minute":30,"city":"Paris","country_code":"FR"}},"render_options":{"format":"svg","theme":"light"}}},"compatibility_png":{"summary":"Compatibility Report (PNG)","description":"PNG format for email reports","value":{"subject1":{"name":"Michael","birth_data":{"year":1982,"month":3,"day":15,"hour":10,"minute":0,"city":"New York","country_code":"US"}},"subject2":{"name":"Sarah","birth_data":{"year":1985,"month":7,"day":8,"hour":16,"minute":45,"city":"London","country_code":"GB"}},"render_options":{"format":"png","width":1000,"theme":"dark"}}}}}},"required":true},"responses":{"200":{"description":"Chart image in requested format","content":{"application/json":{"schema":{}},"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid render parameters"},"422":{"description":"Validation error - check render options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/render/synastry\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"person1\": {\"name\": \"Alice\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"Paris\", \"country_code\": \"FR\"}}, \"person2\": {\"name\": \"Bob\", \"birth_data\": {\"year\": 1988, \"month\": 8, \"day\": 22, \"hour\": 18, \"minute\": 45, \"city\": \"Lisbon\", \"country_code\": \"PT\"}}, \"options\": {\"house_system\": \"P\", \"orb_set\": \"tight\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/render/synastry\";\n\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/render/synastry\";\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/render/synastry\"\n\n# Request data\ndata = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/render/synastry\"\n \n data := map[string]interface{}{\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/render/transit":{"post":{"tags":["🎨 Chart Rendering"],"summary":"Render Transit Chart","description":"🔄 **Render Transit Chart** - Current planetary influences visualization\n\n**What you get:**\n- Inner ring: Natal chart positions\n- Outer ring: Current transiting planets\n- Aspect lines showing active influences\n\n**Formats:** svg, png, jpg, webp, pdf\n\n**Response time:** ~450-650ms","operationId":"render_transit_chart_api_v3_render_transit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitChartRenderRequest"},"examples":{"current_transits":{"summary":"Current Transits","description":"Today's planetary influences on natal chart","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"transit_time":{"datetime":{"year":2024,"month":12,"day":1,"hour":12,"minute":0,"city":"Kharkiv","country_code":"UA"}},"render_options":{"format":"svg","theme":"dark"}}},"transit_png_email":{"summary":"Transit Chart for Email","description":"PNG format compatible with email clients","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"transit_time":{"datetime":{"year":2024,"month":12,"day":15,"hour":10,"minute":0,"city":"London","country_code":"GB"}},"render_options":{"format":"png","width":800,"theme":"light"}}}}}},"required":true},"responses":{"200":{"description":"Chart image in requested format","content":{"application/json":{"schema":{}},"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid render parameters"},"422":{"description":"Validation error - check render options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/render/transit\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/render/transit\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/render/transit\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/render/transit\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/render/transit\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/render/composite":{"post":{"tags":["🎨 Chart Rendering"],"summary":"Render Composite Chart","description":"🌟 **Render Composite Chart** - Relationship as a single entity\n\n**What you get:**\n- Single chart representing the relationship itself\n- Midpoint calculations between partners' planets\n- Unique relationship personality visualization\n\n**Formats:** svg, png, jpg, webp, pdf\n\n**Response time:** ~600-800ms","operationId":"render_composite_chart_api_v3_render_composite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeChartRenderRequest"},"examples":{"composite_svg":{"summary":"Composite Chart (SVG)","description":"Relationship dynamics as a single chart","value":{"subject1":{"name":"Alice","birth_data":{"year":1990,"month":3,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"subject2":{"name":"Bob","birth_data":{"year":1988,"month":7,"day":22,"hour":9,"minute":45,"city":"Paris","country_code":"FR"}},"render_options":{"format":"svg","theme":"dark"}}},"composite_pdf":{"summary":"Composite for Print (PDF)","description":"High-quality PDF for professional reports","value":{"subject1":{"name":"John","birth_data":{"year":1985,"month":11,"day":8,"hour":18,"minute":0,"city":"New York","country_code":"US"}},"subject2":{"name":"Jane","birth_data":{"year":1987,"month":4,"day":25,"hour":11,"minute":20,"city":"Sydney","country_code":"AU"}},"render_options":{"format":"pdf","scale":1.5,"theme":"classic"}}}}}},"required":true},"responses":{"200":{"description":"Chart image in requested format","content":{"application/json":{"schema":{}},"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid render parameters"},"422":{"description":"Validation error - check render options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/render/composite\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/render/composite\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/render/composite\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/render/composite\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/render/composite\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/svg/natal":{"post":{"tags":["🎨 [Deprecated] SVG Chart Generation"],"summary":"Get Natal Chart Svg","description":"⚠️ **DEPRECATED** - Use `POST /api/v3/render/natal` instead.\n\nThe new endpoint supports multiple formats (SVG, PNG, JPG, WebP, PDF) via `render_options.format`.\nThis endpoint will be removed in v4.0.\n\n---\n\n🎨 **Natal Chart SVG Generator** - Beautiful visual birth chart\n\n**Perfect for:**\n- 🖼️ Website chart displays\n- 📱 Mobile app visualizations\n- 🖨️ High-quality printable charts\n- 📊 Professional consultation materials\n\n**What you get:**\n- **Scalable vector graphics** (SVG format)\n- **Professional chart wheel** with houses and signs\n- **Planetary symbols** positioned accurately\n- **Aspect lines** connecting related planets\n- **Customizable themes** (light, dark, classic)\n\n**Visual features:**\n- **Clean, readable design** optimized for all sizes\n- **Color-coded elements** for easy interpretation\n- **Traditional symbols** for planets and signs\n- **Precise positioning** based on calculations\n- **Print-ready quality** at any resolution\n\n**Customization options:**\n- Multiple visual themes available\n- Configurable chart elements\n- Adjustable aspect line display\n- Custom color schemes\n\n**Response time:** ~400ms | **Format:** SVG (scalable vector graphics)","operationId":"get_natal_chart_svg_api_v3_svg_natal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalChartSVGRequest"},"examples":{"classic_theme":{"summary":"Classic Theme Chart","description":"Traditional black and white natal chart with classic styling","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2},"svg_options":{"theme":"classic","language":"en"}}},"dark_theme":{"summary":"Dark Theme Chart","description":"Modern dark theme natal chart perfect for websites and apps","value":{"subject":{"name":"Sophia Chen","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Tokyo","country_code":"JP"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Chiron"],"precision":3},"svg_options":{"theme":"dark","language":"en"}}},"light_theme_french":{"summary":"Light Theme - French","description":"Clean light theme with French language labels","value":{"subject":{"name":"Marie Dubois","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":2},"svg_options":{"theme":"light","language":"fr"}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"image/svg+xml":{}}},"400":{"description":"Invalid SVG generation parameters"},"422":{"description":"Validation error - check chart options"}},"deprecated":true,"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/svg/natal\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/svg/natal\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/svg/natal\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/svg/natal\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/svg/natal\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/svg/synastry":{"post":{"tags":["🎨 [Deprecated] SVG Chart Generation"],"summary":"Get Synastry Chart Svg","description":"⚠️ **DEPRECATED** - Use `POST /api/v3/render/synastry` instead.\n\nThe new endpoint supports multiple formats (SVG, PNG, JPG, WebP, PDF) via `render_options.format`.\nThis endpoint will be removed in v4.0.\n\n---\n\n💕 **Synastry Chart SVG Generator** - Beautiful relationship compatibility visualization\n\n**Perfect for:**\n- 💑 Relationship counseling materials\n- 📱 Dating app compatibility displays\n- 🖨️ Professional consultation printouts\n- 📊 Relationship analysis presentations\n\n**What you get:**\n- **Dual-ring chart wheel** showing both partners' planets\n- **Cross-aspect lines** connecting compatible/challenging planetary connections\n- **Color-coded aspects** for easy interpretation (harmonious vs. challenging)\n- **Professional symbols** for all planets and zodiac signs\n- **Scalable vector format** - perfect quality at any size\n\n**Visual features:**\n- **Inner ring**: First person's natal chart\n- **Outer ring**: Second person's planetary positions\n- **Aspect lines**: Visual connections between partners' planets\n- **House overlays**: How each person's planets fall in partner's houses\n- **Customizable themes**: Light, dark, or classic color schemes\n\n**Input parameters:**\n- **subject1** - First person's birth data (name + DateTimeLocation)\n- **subject2** - Second person's birth data (name + DateTimeLocation)\n- **options** - Chart customization (house system, theme, aspect display)\n\n**Response time:** ~500ms | **Format:** SVG (scalable vector graphics)","operationId":"get_synastry_chart_svg_api_v3_svg_synastry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryChartSVGRequest"},"examples":{"romantic_couple":{"summary":"Romantic Couple Visualization","description":"Beautiful synastry chart for romantic relationship analysis","value":{"subject1":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"subject2":{"name":"Anna Petrov","birth_data":{"year":1987,"month":9,"day":22,"hour":14,"minute":30,"second":0,"city":"Moscow","country_code":"RU"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2},"svg_options":{"theme":"light","language":"en"}}},"business_partnership":{"summary":"Business Partnership Chart","description":"Professional synastry visualization with dark theme","value":{"subject1":{"name":"Sarah Kim","birth_data":{"year":1985,"month":3,"day":10,"hour":9,"minute":15,"second":0,"city":"Seoul","country_code":"KR"}},"subject2":{"name":"David Mueller","birth_data":{"year":1987,"month":11,"day":5,"hour":16,"minute":20,"second":0,"city":"Berlin","country_code":"DE"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":3},"svg_options":{"theme":"dark","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"image/svg+xml":{}}},"400":{"description":"Invalid SVG generation parameters"},"422":{"description":"Validation error - check chart options"}},"deprecated":true,"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/svg/synastry\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"person1\": {\"name\": \"Alice\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"Paris\", \"country_code\": \"FR\"}}, \"person2\": {\"name\": \"Bob\", \"birth_data\": {\"year\": 1988, \"month\": 8, \"day\": 22, \"hour\": 18, \"minute\": 45, \"city\": \"Lisbon\", \"country_code\": \"PT\"}}, \"options\": {\"house_system\": \"P\", \"orb_set\": \"tight\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/svg/synastry\";\n\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/svg/synastry\";\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/svg/synastry\"\n\n# Request data\ndata = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/svg/synastry\"\n \n data := map[string]interface{}{\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/svg/composite":{"post":{"tags":["🎨 [Deprecated] SVG Chart Generation"],"summary":"Get Composite Chart Svg","description":"⚠️ **DEPRECATED** - Use `POST /api/v3/render/composite` instead.\n\nThe new endpoint supports multiple formats (SVG, PNG, JPG, WebP, PDF) via `render_options.format`.\nThis endpoint will be removed in v4.0.\n\n---\n\n🌟 **Composite Chart SVG Generator** - Visual representation of relationship dynamics\n\n**Perfect for:**\n- 💑 **Relationship visualization** - Beautiful charts for couples\n- 🎯 **Professional presentations** - High-quality graphics for consultations\n- 📚 **Educational materials** - Teaching composite chart techniques\n- 📱 **App integration** - Scalable graphics for any screen size\n\n**What you get:**\n- **Professional chart wheel** - Clean, accurate composite chart visualization\n- **Customizable themes** - Light, dark, and high-contrast options\n- **Multi-language support** - Chart labels in 9 languages\n- **Scalable vector format** - Perfect quality at any size\n\n**Visual features:**\n- **Composite planetary positions** - Midpoint calculations displayed clearly\n- **House divisions** - Relationship-focused house system visualization\n- **Aspect lines** - Internal aspects within the composite chart\n- **Professional styling** - Publication-ready quality\n\n**Input parameters:**\n- **subjects** - Array of two subjects' birth data (name + BirthData)\n- **options** - Chart and output customization options\n\n**Response time:** ~600ms | **Format:** SVG (scalable vector graphics)","operationId":"get_composite_chart_svg_api_v3_svg_composite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeChartSVGRequest"},"examples":{"basic_composite_svg":{"summary":"Basic Composite Chart SVG","description":"Visual representation of composite chart with default styling","value":{"subject1":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"subject2":{"name":"Elena Volkov","birth_data":{"year":1988,"month":7,"day":22,"hour":9,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"P","language":"en","tradition":"universal"}}},"dark_composite_svg":{"summary":"Dark Theme Composite Chart","description":"Composite chart with dark theme and custom language","value":{"subject1":{"name":"Emma Wilson","birth_data":{"year":1985,"month":12,"day":8,"hour":18,"minute":15,"second":0,"city":"New York","country_code":"US"}},"subject2":{"name":"Michael Davis","birth_data":{"year":1983,"month":4,"day":25,"hour":11,"minute":20,"second":0,"city":"Sydney","country_code":"AU"}},"options":{"house_system":"W","language":"de","tradition":"universal"}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"image/svg+xml":{}}},"400":{"description":"Invalid SVG generation parameters"},"422":{"description":"Validation error - check chart options"}},"deprecated":true,"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/svg/composite\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/svg/composite\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/svg/composite\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/svg/composite\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/svg/composite\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/svg/transit":{"post":{"tags":["🎨 [Deprecated] SVG Chart Generation"],"summary":"Get Transit Chart Svg","description":"⚠️ **DEPRECATED** - Use `POST /api/v3/render/transit` instead.\n\nThe new endpoint supports multiple formats (SVG, PNG, JPG, WebP, PDF) via `render_options.format`.\nThis endpoint will be removed in v4.0.\n\n---\n\n🔄 **Transit Chart SVG Generator** - Current planetary influences visualization\n\n**Perfect for:**\n- 📅 Daily astrological guidance materials\n- 🎯 Timing decision-making tools\n- 📱 Astrology app transit displays\n- 🖨️ Professional consultation charts\n\n**What you get:**\n- **Dual-ring chart wheel** with natal chart (inner) and current transits (outer)\n- **Transit aspect lines** showing current planetary influences\n- **Highlighted activations** - which natal planets are being activated\n- **Color-coded transits** - beneficial vs. challenging influences\n- **Professional quality** scalable vector graphics\n\n**Visual features:**\n- **Inner ring**: Your natal birth chart positions\n- **Outer ring**: Current transiting planetary positions\n- **Aspect lines**: Active transit connections to natal planets\n- **House emphasis**: Visual highlighting of activated life areas\n- **Time-sensitive data**: Accurate for the specified date/time\n\n**Perfect for timing:**\n- 🎯 Important decisions and launches\n- 💼 Business timing and negotiations\n- 💕 Relationship milestones\n- 🏠 Life transitions and moves\n- 📚 Learning and educational pursuits\n\n**Input parameters:**\n- **subject** - Birth data for natal chart foundation\n- **transit_time** - Date/time for current planetary positions\n- **options** - Visual customization (theme, aspects, house system)\n\n**Response time:** ~450ms | **Format:** SVG (scalable vector graphics)","operationId":"get_transit_chart_svg_api_v3_svg_transit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitChartSVGRequest"},"examples":{"current_transits":{"summary":"Current Transit Visualization","description":"Today's planetary transits overlaid on natal chart","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"transit_time":{"datetime":{"year":2024,"month":3,"day":15,"hour":12,"minute":0,"second":0,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2},"svg_options":{"theme":"classic","language":"en"}}},"major_transits":{"summary":"Major Outer Planet Transits","description":"Focus on slow-moving outer planets with dark theme","value":{"subject":{"name":"Robert Chen","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"New York","country_code":"US"}},"transit_time":{"datetime":{"year":2024,"month":7,"day":21,"hour":15,"minute":30,"second":0,"city":"New York","country_code":"US"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Jupiter","Saturn","Uranus","Neptune","Pluto","Chiron"],"precision":3},"svg_options":{"theme":"dark","language":"en"}}},"relocation_chart":{"summary":"Relocation Transit Chart","description":"Transit chart for different location with light theme","value":{"subject":{"name":"Maria Santos","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"London","country_code":"GB"}},"transit_time":{"datetime":{"year":2024,"month":12,"day":8,"hour":20,"minute":0,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":2},"svg_options":{"theme":"light","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"image/svg+xml":{}}},"400":{"description":"Invalid SVG generation parameters"},"422":{"description":"Validation error - check chart options"}},"deprecated":true,"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/svg/transit\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/svg/transit\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/svg/transit\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/svg/transit\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/svg/transit\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/natal-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Natal Report","description":"📖 **Comprehensive Natal Chart Report** - Detailed personality analysis\n\n**Perfect for:**\n- 🎯 Professional astrological consultations\n- 📚 In-depth personality understanding\n- 🎓 Learning astrology through examples\n- 📱 Astrology apps with detailed reports\n\n**What you get:**\n- **Planets in Signs** - Core personality traits and motivations\n- **Planets in Houses** - Life areas where energies manifest\n- **Major Aspects** - How different parts of personality interact\n- **Moon Phases** - Emotional patterns and lunar influences\n- **Traditional insights** - Classical astrological wisdom\n\n**Available traditions:**\n- **Classical** - Traditional Western astrology\n- **Psychological** - Modern psychological approach\n- **Event-oriented** - Predictive focus\n- **Universal** - Balanced comprehensive approach\n\n**Languages supported:**\n- English (en), German (de), French (fr), Spanish (es)\n- Italian (it), Portuguese (pt), Russian (ru), Chinese (zh)\n- Hindi (hi) - 9 languages total\n\n**Response time:** ~500ms | **Content:** 15-25 detailed interpretations","operationId":"get_natal_report_api_v3_analysis_natal_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalReportRequest"},"examples":{"english_psychological":{"summary":"🇬🇧 English - Psychological","description":"Modern psychological astrology interpretation in English","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"report_options":{"tradition":"psychological","language":"en"}}},"french_classical":{"summary":"🇫🇷 French - Classical","description":"Traditional Western astrology interpretation in French","value":{"subject":{"name":"Marie","birth_data":{"year":1990,"month":7,"day":14,"hour":14,"minute":30,"second":0,"city":"Paris","country_code":"FR"}},"report_options":{"tradition":"classical","language":"fr"}}},"german_universal":{"summary":"🇩🇪 German - Universal","description":"Balanced comprehensive approach in German","value":{"subject":{"name":"Hans","birth_data":{"year":1985,"month":3,"day":20,"hour":10,"minute":0,"second":0,"city":"Berlin","country_code":"DE"}},"report_options":{"tradition":"universal","language":"de"}}},"spanish_event_oriented":{"summary":"🇪🇸 Spanish - Event-Oriented","description":"Predictive focus approach in Spanish","value":{"subject":{"name":"Carlos","birth_data":{"year":1988,"month":11,"day":5,"hour":16,"minute":45,"second":0,"city":"Madrid","country_code":"ES"}},"report_options":{"tradition":"event_oriented","language":"es"}}},"portuguese_psychological":{"summary":"🇵🇹 Portuguese - Psychological","description":"Modern psychological astrology interpretation in Portuguese","value":{"subject":{"name":"João","birth_data":{"year":1992,"month":4,"day":25,"hour":9,"minute":20,"second":0,"city":"Lisbon","country_code":"PT"}},"report_options":{"language":"pt","tradition":"psychological"}}}}}},"required":true},"responses":{"200":{"description":"Successful natal report generation with comprehensive interpretations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v3__schemas__responses__NatalReportResponse"},"examples":{"successful_response":{"summary":"Successful analysis response","description":"Complete analysis with all requested information","value":{"subject":{"name":"Emma Thompson","year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"tz_str":"Europe/London","city":"London","nation":"GB","lat":51.5074,"lng":-0.1278},"interpretations":[{"title":"Sun in Tau","text":"With the Sun in Taurus, you possess a natural stability and determination that serves as your core foundation. You approach life with patience and practicality, preferring to build slowly and steadily toward your goals. Your Taurus Sun gives you a deep appreciation for beauty, comfort, and the finer things in life, while your reliable nature makes you someone others can count on through both good times and challenges."},{"title":"Moon in Sco","text":"Your Moon in Scorpio reveals intense emotional depths and a powerful intuitive nature. You feel everything deeply and have a natural ability to understand the hidden motivations and psychological undercurrents in any situation. This placement gives you emotional resilience and the ability to transform through life's challenges, though you may tend to keep your most vulnerable feelings private."},{"title":"Mercury in Gem","text":"Mercury in Gemini blesses you with a quick, versatile mind that thrives on variety and intellectual stimulation. You're naturally curious about everything and have a gift for communication, easily adapting your conversational style to connect with different people. Your mental agility allows you to process information rapidly and see multiple perspectives on any issue."},{"title":"Venus in Ari","text":"Venus in Aries brings passion and spontaneity to your approach to love and relationships. You're drawn to exciting, dynamic partners and prefer direct, honest expressions of affection. In love, you can be both passionate and impatient, often falling quickly but also expecting immediate reciprocation of your feelings."},{"title":"Mars in Aqu","text":"Mars in Aquarius drives you to fight for causes greater than yourself and pursue your goals in unconventional ways. You're motivated by ideals of progress, equality, and innovation, and you prefer to take action as part of a group rather than going it alone. Your approach to conflict is often detached and intellectual rather than purely emotional."},{"title":"Sun in House_10","text":"With your Sun in the 10th house, your life's purpose is closely tied to your career and public reputation. You have natural leadership abilities and a strong drive to achieve recognition and success in your chosen field. Your identity is significantly shaped by your professional accomplishments and the respect you earn from others."},{"title":"Moon in House_4","text":"Your Moon in the 4th house emphasizes the importance of home, family, and emotional security in your life. You have strong ties to your roots and may be particularly influenced by your mother or family heritage. Creating a safe, nurturing home environment is essential for your emotional well-being."},{"title":"Sun_opposition_Moon","text":"The opposition between your Sun and Moon creates internal tension between your conscious goals and emotional needs. You may often feel torn between what you want to achieve and what you need for emotional fulfillment. Learning to integrate these opposing forces will be a key theme in your personal development."},{"title":"Sun_trine_Jupiter","text":"The trine between your Sun and Jupiter brings optimism, good fortune, and expansion opportunities into your life. You naturally attract positive experiences and have faith in your ability to succeed. This aspect supports growth, wisdom, and a generous spirit that others find inspirational."},{"title":"Venus_square_Saturn","text":"The square between Venus and Saturn may create challenges in love and relationships, often manifesting as feelings of unworthiness or difficulty expressing affection. However, this aspect also teaches valuable lessons about commitment, loyalty, and the importance of building relationships on solid foundations rather than fleeting attractions."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/natal-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/natal-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/natal-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/natal-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/natal-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/lunar-analysis":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Lunar Analysis","description":"🌙 **Detailed Lunar Analysis** - Comprehensive Moon phase and cycle interpretation\n\n**Perfect for:**\n- 🌙 Understanding emotional cycles and patterns\n- 📅 Lunar timing for important decisions\n- 🎯 Electional astrology and optimal timing\n- 📊 Feminine cycles and natural rhythms\n\n**What you get:**\n- **Current Moon phase** detailed interpretation\n- **Lunar mansion analysis** (traditional 28 divisions)\n- **Void of Course periods** and their meanings\n- **Lunar aspects** and their emotional implications\n- **Monthly lunar calendar** with key dates\n\n**Analysis includes:**\n- **Emotional themes** for current lunar phase\n- **Optimal timing** for different activities\n- **Energy levels** throughout lunar cycle\n- **Intuitive insights** and psychic sensitivity\n- **Agricultural and natural timing** guidance\n\n**Response time:** ~400ms | **Content:** Detailed lunar interpretations","operationId":"get_lunar_analysis_api_v3_analysis_lunar_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarAnalysisRequest"},"examples":{"city_example":{"summary":"Using City Name - report_options","description":"API will automatically determine coordinates and timezone from city name","value":{"datetime_location":{"year":2024,"month":3,"day":15,"hour":20,"minute":30,"second":0,"city":"London","country_code":"GB"},"report_options":{"tradition":"psychological","language":"en"}}},"coordinates_example":{"summary":"Using Coordinates - report_options","description":"API will automatically determine timezone from coordinates","value":{"datetime_location":{"year":2024,"month":7,"day":21,"hour":14,"minute":15,"second":0,"latitude":40.7128,"longitude":-74.006},"report_options":{"tradition":"universal","language":"en"}}},"paris_example":{"summary":"Paris with French Language - report_options","description":"Example with different city and language using report_options","value":{"datetime_location":{"year":2024,"month":12,"day":8,"hour":9,"minute":45,"second":0,"city":"Paris","country_code":"FR"},"report_options":{"tradition":"classical","language":"fr"}}}}}},"required":true},"responses":{"200":{"description":"Successful lunar analysis with detailed moon phase and cycle interpretations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarAnalysisResponse"},"examples":{"successful_response":{"summary":"Successful analysis response","description":"Complete analysis with all requested information","value":{"lunar_metrics":{"date":"2024-03-15","within_perigee_range":false,"distance":384400.5,"within_apogee_range":false,"apogee_distance":406696.2,"moon_sign":"Leo","moon_phase":"Waxing Crescent","moon_age_in_days":5.2,"moon_day":6,"moon_illumination":28.4},"interpretations":[{"title":"Waxing Crescent Phase","text":"The Waxing Crescent phase represents a time of intention setting and taking initial action toward your goals. This is an ideal time for planning new projects, making decisions, and building momentum. The energy is growing and optimistic, encouraging you to move forward with confidence while remaining flexible in your approach."},{"title":"Moon in Leo","text":"With the Moon currently in Leo, emotions run dramatic and expressive. This is a time when creativity, self-expression, and personal recognition become especially important. You may feel more confident, generous, and eager to share your talents with others. Romance and artistic pursuits are favored under this placement."},{"title":"Lunar Day 6 Energy","text":"The 6th lunar day brings energy focused on service, healing, and practical improvements. This is an excellent time for addressing health matters, organizing your environment, and helping others. The energy supports methodical work and attention to detail, making it ideal for tasks that require precision and care."},{"title":"28% Illumination Impact","text":"At 28% illumination, the Moon's influence is moderate but growing. This level of lunar energy supports new beginnings while maintaining enough introspective quality for thoughtful planning. It's an excellent balance for both action and reflection, allowing you to move forward with confidence while staying connected to your inner wisdom."},{"title":"Distance and Emotional Intensity","text":"At a standard orbital distance of 384,400 km, the Moon's emotional influence is at typical intensity. You may experience emotions in a balanced way - neither overwhelmingly intense nor unusually detached. This neutral lunar distance supports steady emotional progress and clear decision-making abilities."},{"title":"Optimal Timing Guidance","text":"This lunar configuration is excellent for creative projects, romantic endeavors, and public presentations. The Leo Moon encourages bold self-expression, while the Waxing Crescent phase supports new initiatives. Avoid major emotional decisions late in the evening when Leo's dramatic tendencies might be amplified."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/lunar-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"datetime_location\": {\"year\": 2024, \"month\": 3, \"day\": 15, \"hour\": 20, \"minute\": 30, \"second\": 0, \"city\": \"London\", \"country_code\": \"GB\"}, \"tradition\": \"psychological\", \"language\": \"en\"}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/lunar-analysis\";\n\nconst data = {\n \"datetime_location\": {\n \"year\": 2024,\n \"month\": 3,\n \"day\": 15,\n \"hour\": 20,\n \"minute\": 30,\n \"second\": 0,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n },\n \"tradition\": \"psychological\",\n \"language\": \"en\"\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/lunar-analysis\";\nconst data = {\n \"datetime_location\": {\n \"year\": 2024,\n \"month\": 3,\n \"day\": 15,\n \"hour\": 20,\n \"minute\": 30,\n \"second\": 0,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n },\n \"tradition\": \"psychological\",\n \"language\": \"en\"\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/lunar-analysis\"\n\n# Request data\ndata = {\n \"datetime_location\": {\n \"year\": 2024,\n \"month\": 3,\n \"day\": 15,\n \"hour\": 20,\n \"minute\": 30,\n \"second\": 0,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n },\n \"tradition\": \"psychological\",\n \"language\": \"en\"\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/lunar-analysis\"\n \n data := map[string]interface{}{\n \"datetime_location\": {\n \"year\": 2024,\n \"month\": 3,\n \"day\": 15,\n \"hour\": 20,\n \"minute\": 30,\n \"second\": 0,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n },\n \"tradition\": \"psychological\",\n \"language\": \"en\"\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/relationship-score":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Relationship Score","description":"💯 **Relationship Compatibility Score** - Ciro Discepolo's \"Indice di Relazione\" Method\n\n**Method:** Uses the Discepolo Relationship Index - a proven astrological scoring system\ndeveloped by Italian astrologer Ciro Discepolo for quantifying relationship compatibility.\n\n**Perfect for:**\n- 💑 Quick compatibility assessment\n- 📊 Dating app integrations\n- 🎯 Relationship counseling tools\n- 📱 Simple compatibility widgets\n\n**What you get:**\n- **Discepolo score** (0-50+ scale, higher = stronger karmic connection)\n- **Destiny Sign detection** (same modality Sun signs)\n- **Key aspects** (Sun-Sun, Sun-Moon, Venus-Mars, Ascendant-Moon)\n- **Harmony/Tension ratio** (percentage breakdown)\n- **Dynamic type** classification (Harmonious Flow, Dynamic Growth, etc.)\n\n**Discepolo Score Interpretation:**\n- **0-5**: Minimal connection (background noise)\n- **5-10**: Weak significance\n- **10-15**: Moderate significance\n- **15-20**: Important relationship\n- **20-29**: Considerable significance\n- **29-35**: Strong karmic bond\n- **35+**: Exceptional/profound connection\n\n**Core aspects analyzed:**\n- **Sun-Sun** (ego/identity compatibility)\n- **Sun-Moon** (core marriage indicator)\n- **Sun-Ascendant** (attraction and first impressions)\n- **Venus-Mars** (physical/romantic attraction)\n- **Ascendant-Moon** (emotional comfort)\n\n**Response time:** ~200ms | **Format:** Discepolo score with aspect breakdown","operationId":"get_relationship_score_api_v3_analysis_relationship_score_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryChartRequest"},"examples":{"romantic_couple":{"summary":"Romantic Couple - Discepolo Index","description":"Discepolo relationship score for romantic partners (London-Paris)","value":{"subject1":{"name":"Alice Johnson","birth_data":{"year":1990,"month":6,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"subject2":{"name":"Pierre Martin","birth_data":{"year":1988,"month":9,"day":22,"hour":18,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2}}},"business_partners":{"summary":"Business Partnership - Coordinates","description":"Professional compatibility using exact coordinates for precision","value":{"subject1":{"name":"Sarah Chen","birth_data":{"year":1985,"month":3,"day":10,"hour":9,"minute":15,"second":0,"latitude":40.7128,"longitude":-74.006}},"subject2":{"name":"Michael Brown","birth_data":{"year":1987,"month":11,"day":5,"hour":16,"minute":20,"second":0,"latitude":34.0522,"longitude":-118.2437}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node"],"precision":4}}},"family_dynamics":{"summary":"Family Relationship - Parent & Child","description":"Parent-child compatibility analysis with extended planetary points","value":{"subject1":{"name":"Parent","birth_data":{"year":1970,"month":4,"day":25,"hour":12,"minute":0,"second":0,"city":"Tokyo","country_code":"JP"}},"subject2":{"name":"Child","birth_data":{"year":2000,"month":7,"day":18,"hour":8,"minute":30,"second":0,"city":"Tokyo","country_code":"JP"}},"options":{"house_system":"K","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron","Mean_Node","True_Node"],"precision":3}}}}}},"required":true},"responses":{"200":{"description":"Discepolo Relationship Index score with aspect breakdown and dynamics analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationshipScoreResponse"},"examples":{"successful_response":{"summary":"Discepolo Index: Score 29 (Considerable Significance)","description":"Complete Discepolo relationship index with Destiny Sign detection and core aspects","value":{"score":29.0,"score_description":"Exceptional significance - Profound karmic bond, predominantly harmonious","is_destiny_sign":true,"aspects":[{"point1":"Sun","point2":"Sun","aspect_type":"square","orb":5.7},{"point1":"Sun","point2":"Moon","aspect_type":"trine","orb":7.8},{"point1":"Sun","point2":"Ascendant","aspect_type":"trine","orb":5.5},{"point1":"Mars","point2":"Venus","aspect_type":"trine","orb":5.5},{"point1":"Ascendant","point2":"Moon","aspect_type":"trine","orb":5.1}],"dynamics":{"harmony_percentage":80.0,"tension_percentage":20.0,"dynamic_type":"Harmonious Flow","key_strengths":["Sun trine Moon","Sun trine Ascendant","Mars trine Venus","Ascendant trine Moon"],"growth_areas":["Sun square Sun (ego/emotional tension)"],"summary":"This connection flows naturally with strong mutual support. Note: Sun aspects indicate core identity dynamics that require mutual respect. Strong Venus-Mars connections suggest natural romantic attraction."},"subject_data":{"subject1":{"name":"Alice Johnson","year":1990,"month":6,"day":15,"hour":14,"minute":30,"second":0,"tz_str":"Europe/London","city":"London","nation":"GB","lat":51.5074,"lng":-0.1278},"subject2":{"name":"Pierre Martin","year":1988,"month":9,"day":22,"hour":18,"minute":45,"second":0,"tz_str":"Europe/Paris","city":"Paris","nation":"FR","lat":48.8566,"lng":2.3522}}}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/relationship-score\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/relationship-score\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/relationship-score\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/relationship-score\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/relationship-score\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/synastry-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Synastry Report","description":"Generates and returns a textual synastry report.","operationId":"get_synastry_report_api_v3_analysis_synastry_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryReportRequest"},"examples":{"detailed_relationship":{"summary":"Detailed Relationship Analysis","description":"Comprehensive synastry report with psychological tradition","value":{"subject1":{"name":"Emma Watson","birth_data":{"year":1990,"month":4,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"subject2":{"name":"James Smith","birth_data":{"year":1988,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Edinburgh","country_code":"GB"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron"],"precision":2},"report_options":{"tradition":"psychological","language":"en"}}},"classical_approach":{"summary":"Classical Synastry - French","description":"Traditional approach to relationship analysis in French","value":{"subject1":{"name":"Marie Dupont","birth_data":{"year":1985,"month":6,"day":10,"hour":10,"minute":15,"second":0,"city":"Paris","country_code":"FR"}},"subject2":{"name":"Jean Bernard","birth_data":{"year":1983,"month":11,"day":5,"hour":16,"minute":20,"second":0,"city":"Lyon","country_code":"FR"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":3},"report_options":{"tradition":"classical","language":"fr"}}}}}},"required":true},"responses":{"200":{"description":"Successful synastry report generation with comprehensive relationship analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryReportResponse"},"examples":{"successful_response":{"summary":"Synastry Report Response","description":"Comprehensive relationship analysis with sectioned interpretations","value":{"report_title":"Synastry Report: Emma Watson & James Smith","sections":[{"title":"Romantic Attraction & Chemistry","interpretations":[{"factor":"Venus conjunction Mars","text":"The Venus-Mars conjunction between your charts creates immediate and powerful romantic chemistry with strong intellectual and communicative attraction."},{"factor":"Sun trine Moon","text":"This harmonious aspect creates deep emotional understanding and intuitive connection between partners."}]},{"title":"Communication Patterns","interpretations":[{"factor":"Mercury square Mercury","text":"Different communication styles may require conscious effort to bridge, but also provide opportunities for growth."}]},{"title":"Long-term Potential","interpretations":[{"factor":"Sun trine Jupiter","text":"Shared philosophical outlooks and complementary life goals suggest strong potential for growth and success as a couple."},{"factor":"Saturn square Venus","text":"This aspect requires patience and understanding, teaching both partners about commitment and building solid foundations."}]}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/synastry-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"person1\": {\"name\": \"Alice\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"Paris\", \"country_code\": \"FR\"}}, \"person2\": {\"name\": \"Bob\", \"birth_data\": {\"year\": 1988, \"month\": 8, \"day\": 22, \"hour\": 18, \"minute\": 45, \"city\": \"Lisbon\", \"country_code\": \"PT\"}}, \"options\": {\"house_system\": \"P\", \"orb_set\": \"tight\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/synastry-report\";\n\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/synastry-report\";\nconst data = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/synastry-report\"\n\n# Request data\ndata = {\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/synastry-report\"\n \n data := map[string]interface{}{\n \"person1\": {\n \"name\": \"Alice\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"Paris\",\n \"country_code\": \"FR\"\n }\n },\n \"person2\": {\n \"name\": \"Bob\",\n \"birth_data\": {\n \"year\": 1988,\n \"month\": 8,\n \"day\": 22,\n \"hour\": 18,\n \"minute\": 45,\n \"city\": \"Lisbon\",\n \"country_code\": \"PT\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"orb_set\": \"tight\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/solar-return-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Solar Return Report","description":"Generates and returns a solar return report.","operationId":"get_solar_return_report_api_v3_analysis_solar_return_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnReportRequest"},"examples":{"birthday_2024":{"summary":"2024 Birthday Analysis","description":"Solar return for 2024 with current location (relocated chart)","value":{"subject":{"name":"Alexandra Smith","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_year":2024,"return_location":{"year":2024,"month":5,"day":15,"hour":12,"minute":0,"second":0,"city":"Paris","country_code":"FR"},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":2},"report_options":{"tradition":"psychological","language":"en"}}},"birth_location":{"summary":"Same Location Solar Return","description":"Solar return calculated for birth location (traditional approach)","value":{"subject":{"name":"Michael Johnson","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":40.7128,"longitude":-74.006}},"return_year":2025,"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron","Mean_Node"],"precision":3},"report_options":{"tradition":"universal","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful solar return report generation with yearly themes and predictions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnReportResponse"},"examples":{"successful_response":{"summary":"Successful analysis response","description":"Complete analysis with all requested information","value":{"subject_data":{"name":"Alexandra Smith","year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"tz_str":"Europe/London","city":"London","nation":"GB","lat":51.5074,"lng":-0.1278,"return_data":{"year":2024,"exact_return_time":"2024-05-15T11:42:33Z","location":{"city":"Paris","country_code":"FR","latitude":48.8566,"longitude":2.3522,"timezone":"Europe/Paris"}}},"chart_data":{"planetary_positions":[{"name":"Sun","sign":"Tau","degree":24.83,"absolute_longitude":54.83,"house":9,"is_retrograde":false,"speed":0.958},{"name":"Moon","sign":"Vir","degree":8.12,"absolute_longitude":158.12,"house":1,"is_retrograde":false,"speed":12.89},{"name":"Mercury","sign":"Tau","degree":12.45,"absolute_longitude":42.45,"house":8,"is_retrograde":false,"speed":1.123},{"name":"Venus","sign":"Gem","degree":2.78,"absolute_longitude":62.78,"house":9,"is_retrograde":false,"speed":1.205},{"name":"Mars","sign":"Ari","degree":16.34,"absolute_longitude":16.34,"house":7,"is_retrograde":false,"speed":0.612}]},"interpretations":[{"title":"Solar Return Overview - Year Ahead","text":"This solar return year emphasizes expansion, learning, and new horizons. With the return Sun in the 9th house, this is a year for broadening your perspective through travel, education, or philosophical exploration. Expect opportunities for growth that take you beyond your comfort zone and expand your understanding of the world."},{"title":"Moon in 1st House - Emotional Focus","text":"The Solar Return Moon in your 1st house indicates a year of emotional renewal and personal transformation. Your feelings and intuition will play a major role in the decisions you make this year. This placement suggests increased emotional sensitivity and a need to honor your authentic feelings as you navigate the year ahead."},{"title":"Mercury in 8th House - Deep Investigation","text":"Mercury in the 8th house of your Solar Return chart suggests a year of researching, investigating, and uncovering hidden truths. Your mental focus turns to subjects that require depth and intensity - psychology, finances, shared resources, or transformational healing. Expect important communications related to joint finances or intimate partnerships."},{"title":"Venus in 9th House - Love Through Learning","text":"Venus joining the Sun in the 9th house brings romance and beauty into your educational and travel experiences. You may meet someone special while traveling or studying, or find that relationships are enhanced through shared philosophical or cultural interests. Artistic inspiration comes from foreign sources or higher learning."},{"title":"Mars in 7th House - Relationship Dynamics","text":"Mars in the 7th house of partnerships indicates an active and potentially challenging year in relationships. You may be more assertive with partners or attract more dynamic individuals into your life. This placement can bring energy and passion to partnerships but requires conscious effort to avoid conflicts or power struggles."},{"title":"Key Themes for the Year","text":"The dominant theme is expansion through learning and relationships. The 9th house emphasis encourages you to think bigger, travel more, and embrace new philosophies. The 7th house Mars suggests that partnerships will be a catalyst for growth, though they may also present challenges that help you develop better negotiation skills and personal boundaries."},{"title":"Timing and Seasonal Influences","text":"The strongest manifestations of these themes will likely occur during Taurus season (late April - May) when transiting planets activate your Solar Return Sun position. Pay special attention to developments around the autumn equinox when the Sun opposes your return position, potentially bringing relationship or educational matters to a head."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/solar-return-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/solar-return-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/solar-return-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/solar-return-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/solar-return-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/lunar-return-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Lunar Return Report","description":"Generates and returns a lunar return report.","operationId":"get_lunar_return_report_api_v3_analysis_lunar_return_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnReportRequest"},"examples":{"monthly_lunar_report":{"summary":"Monthly Lunar Return Report","description":"Comprehensive lunar return report for monthly emotional and intuitive cycles","value":{"subject":{"name":"Luna Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_date":"2024-03-15","options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3},"report_options":{"tradition":"psychological","language":"en"}}},"relocated_lunar_report":{"summary":"Relocated Lunar Return","description":"Lunar return report calculated for current location (relocation astrology)","value":{"subject":{"name":"Lunar Traveler","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Sydney","country_code":"AU"}},"return_date":"2024-04-20","return_location":{"year":2024,"month":4,"day":20,"hour":12,"minute":0,"second":0,"city":"Paris","country_code":"FR"},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node"],"precision":2},"report_options":{"tradition":"universal","language":"fr"}}}}}},"required":true},"responses":{"200":{"description":"Successful lunar return report generation with monthly emotional cycles and timing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnReportResponse"},"examples":{"successful_response":{"summary":"Successful lunar return analysis","description":"Complete lunar return report with monthly emotional timing and chart interpretations","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"tz_str":"Europe/Kiev","city":"Kharkiv","nation":"UA","lat":49.9935,"lng":36.2304},"chart_data":{"return_date":"2024-03-15T10:30:00Z","chart_type":"lunar_return","location":"Kharkiv, UA"},"interpretations":[{"title":"Moon in Gemini - Monthly Focus","text":"This lunar return emphasizes communication, learning, and mental agility for the month ahead. Your emotional focus will be on gathering information, connecting with others, and exploring new ideas. This is an excellent time for writing, teaching, or any activities that involve mental stimulation and social interaction."},{"title":"Moon in 3rd House - Communication Theme","text":"With the lunar return Moon in the 3rd house, this month highlights your immediate environment, siblings, and daily communications. You may find yourself more involved in neighborhood activities, short trips, or local connections. Your emotional well-being will be tied to feeling mentally engaged and socially connected."},{"title":"Moon Sextile Mercury - Mental Harmony","text":"The harmonious aspect between the Moon and Mercury suggests this month will bring emotional clarity and excellent communication skills. Your intuition and logic will work together beautifully, making this an ideal time for important conversations, negotiations, or learning new subjects."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid date range for lunar return","description":"Validation error when date parameters are invalid","value":{"success":false,"error":{"error_code":"INVALID_DATE_RANGE","message":"Return year must be within reasonable range","field":"return_year","value":3000,"severity":"medium","suggestions":["Use a year between 1900 and 2050","Ensure return year is after birth year"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/lunar-return-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/lunar-return-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/lunar-return-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/lunar-return-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/lunar-return-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/solar-return-transit-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Solar Return Transit Report","description":"Generates and returns a transit report for a solar return chart.","operationId":"get_solar_return_transit_report_api_v3_analysis_solar_return_transit_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnTransitRequest"},"examples":{"birthday_transit_report":{"summary":"Birthday Year Transit Report","description":"Comprehensive transit analysis for solar return chart with interpretations","value":{"subject":{"name":"Birthday Analyst","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_year":2024,"date_range":{"start_date":{"year":2024,"month":5,"day":15},"end_date":{"year":2025,"month":5,"day":14}},"orb":2.0,"report_options":{"tradition":"psychological","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful solar return transit report generation with yearly timing analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnTransitReportResponse"},"examples":{"successful_response":{"summary":"Successful solar return transit analysis","description":"Complete solar return transit report with yearly timing and interpretations","value":{"events":[{"date":"2024-05-11","exact_time":"2024-05-11T15:30:00Z","transiting_planet":"Jupiter","stationed_planet":"Sun","aspect_type":"trine","orb":1.2,"aspect_direction":"applying","interpretation":"This harmonious Jupiter transit to your solar return Sun brings excellent opportunities for personal growth and expansion during your birthday year."},{"date":"2024-07-22","exact_time":"2024-07-22T09:15:00Z","transiting_planet":"Saturn","stationed_planet":"Moon","aspect_type":"square","orb":2.8,"aspect_direction":"exact","interpretation":"This challenging Saturn transit calls for emotional maturity and restructuring of your personal life."},{"date":"2024-09-18","exact_time":"2024-09-18T21:45:00Z","transiting_planet":"Venus","stationed_planet":"Venus","aspect_type":"conjunction","orb":0.5,"aspect_direction":"exact","interpretation":"The Venus return highlights themes of love, beauty, and personal values renewal."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid transit date range","description":"Validation error when transit calculation parameters are invalid","value":{"success":false,"error":{"error_code":"INVALID_DATE_RANGE","message":"Start date must be before end date","field":"date_range","value":{"start":"2024-12-31","end":"2024-01-01"},"severity":"medium","suggestions":["Ensure start_date comes before end_date","Use valid date format YYYY-MM-DD"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/solar-return-transit-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/solar-return-transit-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/solar-return-transit-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/solar-return-transit-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/solar-return-transit-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/lunar-return-transit-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Lunar Return Transit Report","description":"Generates and returns a transit report for a lunar return chart.","operationId":"get_lunar_return_transit_report_api_v3_analysis_lunar_return_transit_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnTransitRequest"},"examples":{"monthly_transit_report":{"summary":"Monthly Lunar Transit Report","description":"Lunar return transit analysis for monthly emotional cycles and timing","value":{"subject":{"name":"Lunar Transit Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"return_date":"2024-03-15","date_range":{"start_date":{"year":2024,"month":3,"day":15},"end_date":{"year":2024,"month":4,"day":14}},"orb":1.5,"report_options":{"tradition":"universal","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful lunar return transit report generation with monthly timing analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnTransitReportResponse"},"examples":{"successful_response":{"summary":"Successful lunar return transit analysis","description":"Complete lunar return transit report with monthly timing and interpretations","value":{"events":[{"date":"2024-03-15","exact_time":"2024-03-15T14:20:00Z","transiting_planet":"Mars","stationed_planet":"Moon","aspect_type":"conjunction","orb":0.8,"aspect_direction":"applying","interpretation":"This powerful Mars transit brings intense emotional energy and the drive to take action on personal matters."},{"date":"2024-03-22","exact_time":"2024-03-22T11:45:00Z","transiting_planet":"Mercury","stationed_planet":"Venus","aspect_type":"sextile","orb":1.5,"aspect_direction":"exact","interpretation":"This delightful Mercury-Venus aspect brings charm, diplomatic skills, and pleasant social interactions."},{"date":"2024-03-28","exact_time":"2024-03-28T18:30:00Z","transiting_planet":"Jupiter","stationed_planet":"Mercury","aspect_type":"trine","orb":2.1,"aspect_direction":"separating","interpretation":"Jupiter's harmonious aspect expands your mental horizons and brings optimistic thinking."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid lunar return calculation parameters","description":"Validation error when lunar return parameters are incorrect","value":{"success":false,"error":{"error_code":"INVALID_LOCATION","message":"Invalid geographic coordinates provided","field":"location","value":{"latitude":200,"longitude":400},"severity":"high","suggestions":["Latitude must be between -90 and 90 degrees","Longitude must be between -180 and 180 degrees","Use city name with country code for automatic resolution"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/lunar-return-transit-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/lunar-return-transit-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/lunar-return-transit-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/lunar-return-transit-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/lunar-return-transit-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/natal-transit-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Natal Transit Report","description":"Generates and returns a transit report for a natal chart.","operationId":"get_natal_transit_report_api_v3_analysis_natal_transit_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitRequest"},"examples":{"monthly_transits":{"summary":"Monthly Transit Analysis","description":"Current month's transits to natal chart with tight orbs","value":{"subject":{"name":"Jennifer Davis","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"transit_time":{"date_range":{"start_date":{"year":2024,"month":3,"day":1},"end_date":{"year":2024,"month":3,"day":31}}},"orb":1.0,"report_options":{"tradition":"psychological","language":"en"}}},"major_transits_year":{"summary":"Major Yearly Transits","description":"Outer planet transits for the year with wider orbs","value":{"subject":{"name":"Robert Wilson","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":48.8566,"longitude":2.3522}},"transit_time":{"date_range":{"start_date":{"year":2024,"month":1,"day":1},"end_date":{"year":2024,"month":12,"day":31}}},"orb":2.0,"report_options":{"tradition":"event_oriented","language":"en"}}},"precise_timing":{"summary":"Precise Timing - Weekly","description":"High-precision weekly transit analysis for exact timing","value":{"subject":{"name":"Lisa Chen","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Tokyo","country_code":"JP"}},"transit_time":{"date_range":{"start_date":{"year":2024,"month":4,"day":15},"end_date":{"year":2024,"month":4,"day":21}}},"orb":0.5,"report_options":{"tradition":"universal","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful natal transit report generation with timing predictions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitReportResponse"},"examples":{"successful_response":{"summary":"Successful natal transit analysis","description":"Complete natal transit report with timing predictions and interpretations","value":{"events":[{"date":"2024-08-15","exact_time":"2024-08-15T16:25:00Z","transiting_planet":"Saturn","stationed_planet":"Sun","aspect_type":"square","orb":1.3,"aspect_direction":"applying","interpretation":"This challenging Saturn transit tests your confidence and authority. Focus on discipline and building solid foundations."},{"date":"2024-10-03","exact_time":"2024-10-03T09:40:00Z","transiting_planet":"Jupiter","stationed_planet":"Venus","aspect_type":"trine","orb":0.7,"aspect_direction":"exact","interpretation":"This beautiful Jupiter transit brings opportunities for love, creativity, and financial gain."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid natal chart data","description":"Validation error when birth data is incomplete or invalid","value":{"success":false,"error":{"error_code":"INVALID_BIRTH_DATA","message":"Birth time is required for precise transit calculations","field":"birth_data.hour","severity":"high","suggestions":["Provide complete birth time including hour and minute","Use 24-hour format for time entry","Contact birth registry if exact time is unknown"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/natal-transit-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/natal-transit-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/natal-transit-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/natal-transit-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/natal-transit-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/progression-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Progression Report","description":"Generates and returns a progression report with interpretations.\n\nAnalyzes the progressed chart and provides interpretations for:\n- Progressed planets in signs and houses\n- Progressed aspects to natal positions\n- Key life themes for the progressed period","operationId":"get_progression_report_api_v3_analysis_progression_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionReportRequest"},"examples":{"secondary_progression_report":{"summary":"Secondary Progression Report","description":"Day-for-a-year progression analysis with detailed interpretations","value":{"subject":{"name":"Progression Explorer","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"target_date":"2024-03-15","progression_type":"secondary","options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3},"report_options":{"tradition":"psychological","language":"en"}}},"coordinates_progression_report":{"summary":"High Precision Progression","description":"Progression report with exact coordinates for maximum accuracy","value":{"subject":{"name":"Precise Progressor","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":30,"latitude":48.8566,"longitude":2.3522}},"target_date":"2024-08-22","progression_type":"secondary","options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Ascendant"],"precision":4},"report_options":{"tradition":"universal","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful progression report generation with life evolution analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionReportResponse"},"examples":{"successful_response":{"summary":"Successful progression analysis","description":"Complete progression report with life evolution and timing insights","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"tz_str":"Europe/Kiev","city":"Kharkiv","nation":"UA","lat":49.9935,"lng":36.2304},"progressed_data":{"progression_date":"2024-03-15","age_at_progression":38.84,"progression_type":"secondary"},"chart_data":{"calculation_time":"2024-03-15T14:30:00Z","progression_method":"secondary","location":"Kharkiv, UA"},"interpretations":[{"title":"Progressed Sun in Gemini","text":"Your progressed Sun has moved into Gemini, marking a period of increased curiosity, communication, and mental activity. Over the coming years, you'll find yourself drawn to learning, writing, teaching, or other intellectually stimulating pursuits. This progression supports networking, short trips, and diversifying your interests."},{"title":"Progressed Moon in Scorpio","text":"With your progressed Moon in Scorpio, you're entering a phase of emotional intensity and transformation. This two-and-a-half-year period will deepen your psychological insights and may bring powerful emotional experiences that fundamentally change your perspective on relationships and personal security."},{"title":"Progressed Venus Conjunct Natal Mars","text":"This powerful progression brings together love and passion in remarkable ways. You may experience a significant romantic relationship or find new passion in creative projects. This aspect enhances your magnetism and ability to attract what you desire, particularly in matters of the heart and artistic expression."}],"progression_type":"secondary"}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid progression parameters","description":"Validation error when progression calculation parameters are incorrect","value":{"success":false,"error":{"error_code":"INVALID_PROGRESSION_DATE","message":"Progression date must be after birth date","field":"progression_date","value":"1980-01-01","severity":"high","suggestions":["Use a date after the birth date for progression calculation","Ensure date format is YYYY-MM-DD","Consider reasonable timeframes for progression analysis"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/progression-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/progression-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/progression-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/progression-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/progression-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/direction-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Direction Report","description":"Generates and returns a direction report with interpretations.\n\nAnalyzes directed positions and provides insights on:\n- Directed planets forming aspects to natal positions\n- Timing of major life events\n- Themes activated by directions","operationId":"get_direction_report_api_v3_analysis_direction_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectionReportRequest"},"examples":{"primary_direction_report":{"summary":"Solar Arc Direction Report","description":"Solar arc directions analysis with detailed interpretations","value":{"subject":{"name":"Direction Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"target_date":"2024-03-15","direction_type":"solar_arc","options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3},"report_options":{"tradition":"classical","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful direction report generation with traditional primary directions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectionReportResponse"},"examples":{"successful_response":{"summary":"Successful primary directions analysis","description":"Complete direction report with traditional timing techniques","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"tz_str":"Europe/Kiev","city":"Kharkiv","nation":"UA","lat":49.9935,"lng":36.2304},"directed_data":{"direction_date":"2024-03-15","age_at_direction":38.84,"direction_key":"1_degree_per_year"},"chart_data":{"calculation_time":"2024-03-15T14:30:00Z","direction_method":"primary","location":"Kharkiv, UA"},"interpretations":[{"title":"Directed Sun Conjunct Natal Jupiter","text":"This powerful primary direction brings a period of expansion, growth, and good fortune. Your confidence and leadership abilities are enhanced, and you may receive recognition or advancement in your career. This is an excellent time for pursuing higher education, travel, or spiritual growth."},{"title":"Directed Moon Square Natal Saturn","text":"This challenging direction may bring emotional tests and the need for greater responsibility. You might experience delays or restrictions in personal matters, but these challenges will ultimately strengthen your emotional maturity and teach valuable lessons about patience and perseverance."}],"direction_type":"solar_arc","arc_used":38.84}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid direction calculation parameters","description":"Validation error when direction parameters are incorrect","value":{"success":false,"error":{"error_code":"INVALID_DIRECTION_METHOD","message":"Unsupported direction calculation method","field":"direction_method","value":"invalid_method","severity":"medium","suggestions":["Use supported methods: primary, secondary, symbolic","See /api/v3/glossary for available direction methods"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/direction-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/direction-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/direction-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/direction-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/direction-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/composite-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Composite Report","description":"🌟 **Composite Chart Report Generator** - Comprehensive relationship analysis with life area compatibility\n\n**Perfect for:**\n- 💑 Relationship counselors analyzing partnership dynamics\n- 📚 Astrology students learning composite chart interpretation\n- 🎓 Researchers studying relationship compatibility patterns\n- 📱 Dating apps providing compatibility insights\n\n**What you get:**\n- **Composite Chart Interpretations** - Planets in signs, houses, and aspects for the relationship itself\n- **Life Area Compatibility** - Detailed analysis across 12 key relationship areas\n- **Overall Compatibility Score** - Numerical assessment of relationship harmony\n- **Relationship Insights** - How the partnership functions as a unified entity\n\n**Available traditions:**\n- **Psychological** - Modern relationship psychology approach\n- **Universal** - Comprehensive life-area compatibility analysis\n- **Classical** - Traditional astrological relationship methods\n\n**Response time:** ~800ms | **Content:** 25-40 detailed interpretations + compatibility analysis","operationId":"get_composite_report_api_v3_analysis_composite_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeReportRequest"},"examples":{"psychological_composite":{"summary":"Psychological Composite Report - London & Paris","description":"Modern psychological astrology interpretation for a composite chart between two people","value":{"subject1":{"name":"Alice Johnson","birth_data":{"year":1990,"month":3,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"subject2":{"name":"Bob Smith","birth_data":{"year":1988,"month":7,"day":22,"hour":9,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2},"report_options":{"tradition":"psychological","language":"en"}}},"universal_composite":{"summary":"Universal Composite Report - New York & Tokyo","description":"Universal astrology approach for relationship analysis with life area compatibility","value":{"subject1":{"name":"Emma Wilson","birth_data":{"year":1992,"month":11,"day":8,"hour":16,"minute":20,"second":0,"city":"New York","country_code":"US"}},"subject2":{"name":"Hiroshi Tanaka","birth_data":{"year":1989,"month":4,"day":12,"hour":11,"minute":15,"second":0,"city":"Tokyo","country_code":"JP"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":2},"report_options":{"tradition":"universal","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful composite report generation with relationship analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeReportResponse"},"examples":{"successful_response":{"summary":"Successful composite chart analysis","description":"Complete composite report with relationship dynamics and compatibility insights","value":{"subject_data":{"subject1":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","nation":"UA"},"subject2":{"name":"Partner","year":1987,"month":8,"day":22,"hour":10,"minute":30,"second":0,"city":"Kiev","nation":"UA"},"composite_chart":{"calculation_method":"midpoint","chart_type":"composite"}},"interpretations":[{"title":"Composite Sun in Leo","text":"Your relationship radiates warmth, creativity, and confidence. Together, you shine brightly and inspire others through your dynamic partnership. This placement suggests a relationship built on mutual respect, shared creative interests, and a natural ability to lead and inspire as a couple."},{"title":"Composite Moon in Libra","text":"Emotional harmony and balance are central themes in your relationship. You naturally seek fairness and cooperation, working together to create beauty and peace in your shared life. Your partnership thrives on mutual understanding, aesthetic appreciation, and diplomatic communication."}],"life_area_compatibility":[{"area":"Communication","compatibility_score":0.85,"description":"Excellent communication compatibility with natural understanding and flowing conversations.","key_factors":["Mercury trine Mercury","Composite Mercury in 3rd house"]},{"area":"Love & Romance","compatibility_score":0.78,"description":"Strong romantic connection with shared values and emotional understanding.","key_factors":["Venus sextile Mars","Composite Venus in 5th house"]}],"overall_compatibility_score":0.82}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Missing second subject data","description":"Validation error when second subject data is incomplete for composite analysis","value":{"success":false,"error":{"error_code":"MISSING_SUBJECT_DATA","message":"Second subject birth data is required for composite chart","field":"subject2.birth_data","severity":"high","suggestions":["Provide complete birth data for both subjects","Ensure both subjects have valid dates and locations","Use synastry-report endpoint for single-subject analysis"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/composite-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/composite-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/composite-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/composite-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/composite-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/compatibility-score":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Compatibility Score","description":"💯 **Compatibility Score Calculator** - Quick numerical compatibility assessment\n\n**Perfect for:**\n- 💕 Dating apps and quick compatibility checks\n- 📊 Relationship scoring systems\n- 🎯 Business partnership assessment\n- 📱 Simple compatibility widgets\n\n**What you get:**\n- **Overall compatibility score** (0-100 scale)\n- **Category breakdowns** (Romance, Communication, Values, Goals, Conflict Resolution)\n- **Significant aspects** between the charts\n- **Compatibility description** and relationship potential\n- **Destiny sign indicator** for special connections\n\n**Scoring categories:**\n- **Romantic attraction** (Venus-Mars connections)\n- **Emotional compatibility** (Moon aspects)\n- **Communication harmony** (Mercury interactions)\n- **Life goals alignment** (Sun-Sun aspects)\n- **Conflict resolution** (Saturn connections)\n\n**Response time:** ~200ms | **Format:** Numerical scores with explanations","operationId":"get_compatibility_score_api_v3_analysis_compatibility_score_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryChartRequest"},"examples":{"romantic_couple":{"summary":"Romantic Couple - Different Cities","description":"Compatibility score analysis between partners from London and Paris","value":{"subject1":{"name":"Alice Johnson","birth_data":{"year":1990,"month":6,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"subject2":{"name":"Pierre Martin","birth_data":{"year":1988,"month":9,"day":22,"hour":18,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2},"report_options":{"include_details":true,"language":"en"}}},"business_partners":{"summary":"Business Partnership - Coordinates","description":"Professional compatibility using exact coordinates for precision","value":{"subject1":{"name":"Sarah Chen","birth_data":{"year":1985,"month":3,"day":10,"hour":9,"minute":15,"second":0,"latitude":40.7128,"longitude":-74.006}},"subject2":{"name":"Michael Brown","birth_data":{"year":1987,"month":11,"day":5,"hour":16,"minute":20,"second":0,"latitude":34.0522,"longitude":-118.2437}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node"],"precision":4}}}}}},"required":true},"responses":{"200":{"description":"Successful compatibility score calculation with detailed breakdown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationshipScoreResponse"},"examples":{"successful_response":{"summary":"Discepolo Method Score Response","description":"Complete analysis using Discepolo's relationship significance method. Note: Score measures relationship SIGNIFICANCE (intensity of connection), not harmony.","value":{"score":24.0,"score_description":"High significance - Strong karmic bond with balanced harmony/tension dynamics","is_destiny_sign":false,"aspects":[{"point1":"Sun","point2":"Sun","aspect_type":"trine","orb":6.91},{"point1":"Sun","point2":"Moon","aspect_type":"sextile","orb":-3.04},{"point1":"Moon","point2":"Sun","aspect_type":"conjunction","orb":4.17},{"point1":"Venus","point2":"Mars","aspect_type":"opposition","orb":-3.9}],"dynamics":{"harmony_percentage":40.0,"tension_percentage":40.0,"dynamic_type":"Dynamic Growth","key_strengths":["Sun trine Sun","Sun sextile Moon"],"growth_areas":["Venus opposition Mars (relationship dynamic)"],"summary":"This connection balances ease and growth opportunities."},"subject_data":{"subject1":{"name":"Person 1"},"subject2":{"name":"Person 2"}}}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/compatibility-score\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/compatibility-score\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/compatibility-score\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/compatibility-score\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/compatibility-score\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/compatibility":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Compatibility","description":"💯 **General Compatibility Analysis** - Comprehensive relationship compatibility assessment\n\n**Perfect for:**\n- 💕 Dating and relationship apps\n- 🤝 Business partnership analysis\n- 👥 Team building and HR applications\n\n**What you get:**\n- **Sectioned Report** with themed relationship areas\n- **Aspect Interpretations** for each compatibility factor\n- **Romantic Attraction** analysis\n- **Emotional Compatibility** insights\n- **Communication Patterns** assessment\n- **Growth Areas** for relationship development\n\n**Analysis includes:**\n- **Synastry aspects** between charts\n- **Element and modality harmony**\n- **Detailed interpretations** for each significant aspect\n\n**Response time:** ~300ms | **Format:** Sectioned synastry report\n\n**Note:** For numerical scoring, use `/compatibility-score` endpoint instead.","operationId":"get_compatibility_api_v3_analysis_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatibilityRequest"},"examples":{"romantic_compatibility":{"summary":"Romantic Compatibility - London & Berlin","description":"Comprehensive compatibility analysis between romantic partners","value":{"subjects":[{"name":"Sophie Williams","birth_data":{"year":1992,"month":6,"day":18,"hour":15,"minute":30,"second":0,"city":"London","country_code":"GB"}},{"name":"Andreas Mueller","birth_data":{"year":1988,"month":9,"day":25,"hour":11,"minute":45,"second":0,"city":"Berlin","country_code":"DE"}}]}},"friendship_compatibility":{"summary":"Friendship Compatibility - Tokyo & Sydney","description":"General compatibility analysis for friends or business partners","value":{"subjects":[{"name":"Yuki Tanaka","birth_data":{"year":1987,"month":3,"day":12,"hour":9,"minute":20,"second":0,"city":"Tokyo","country_code":"JP"}},{"name":"Emma Thompson","birth_data":{"year":1990,"month":11,"day":8,"hour":14,"minute":15,"second":0,"city":"Sydney","country_code":"AU"}}]}}}}},"required":true},"responses":{"200":{"description":"Successful compatibility analysis using synastry report format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryReportResponse"},"examples":{"successful_response":{"summary":"Compatibility Analysis Response","description":"Relationship compatibility presented as sectioned synastry report","value":{"report_title":"Compatibility Report: Sophie Williams & Andreas Mueller","sections":[{"title":"Romantic Attraction","interpretations":[{"factor":"Venus trine Mars","text":"Strong physical and emotional chemistry with natural romantic attraction."}]},{"title":"Emotional Compatibility","interpretations":[{"factor":"Moon sextile Moon","text":"Deep emotional understanding and supportive connection between partners."}]},{"title":"Communication","interpretations":[{"factor":"Mercury conjunction Mercury","text":"Similar communication styles create easy understanding and mental rapport."}]},{"title":"Growth Areas","interpretations":[{"factor":"Saturn square Venus","text":"Some tension around commitment approaches that requires patience and understanding."}]}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/compatibility\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/compatibility\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/compatibility\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/compatibility\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/compatibility\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/career":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Career Analysis","description":"💼 **Career & Vocational Analysis** - Professional guidance and timing insights\n\n**Perfect for:**\n- 🎯 Career counseling and guidance\n- 📈 Professional development planning\n- 🔄 Career transition timing\n- 💡 Entrepreneurship and business ventures\n\n**What you get:**\n- **Career Strengths** based on planetary positions\n- **Professional Talents** and natural abilities\n- **Optimal Career Paths** aligned with chart patterns\n- **Timing Guidance** for career moves and decisions\n- **Work Style Analysis** and ideal environments\n\n**Analysis focuses on:**\n- **10th House** (Career and reputation)\n- **Midheaven sign** and aspects\n- **6th House** (Work and service)\n- **Mars placement** (Drive and ambition)\n- **Saturn aspects** (Professional discipline)\n\n**Response time:** ~600ms | **Content:** Career-focused interpretations","operationId":"get_career_analysis_api_v3_analysis_career_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalReportRequest"},"examples":{"career_guidance":{"summary":"Career Guidance Report","description":"Comprehensive vocational astrology analysis with career timing","value":{"subject":{"name":"Career Seeker","birth_data":{"year":1995,"month":4,"day":22,"hour":10,"minute":30,"second":0,"city":"Chicago","country_code":"US"}},"tradition":"universal","language":"en"}},"vocational_timing":{"summary":"Vocational Timing Analysis","description":"Career analysis focused on optimal timing for professional decisions","value":{"subject":{"name":"Professional Advisor","birth_data":{"year":1985,"month":8,"day":15,"hour":16,"minute":45,"second":0,"city":"Toronto","country_code":"CA"}},"tradition":"psychological","language":"en"}}}}},"required":true},"responses":{"200":{"description":"Successful career analysis with vocational guidance and timing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v3__schemas__responses__NatalReportResponse"},"examples":{"successful_response":{"summary":"Successful career analysis","description":"Complete career report with vocational guidance and optimal timing insights","value":{"subject":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"tz_str":"Europe/Kiev","city":"Kharkiv","nation":"UA","lat":49.9935,"lng":36.2304},"interpretations":[{"title":"Sun in Taurus - Practical Leadership","text":"Your Taurus Sun suggests excellent potential in careers requiring patience, reliability, and practical skills. You're naturally suited for fields like finance, real estate, agriculture, luxury goods, or any industry where building lasting value is important. Your steady leadership style inspires confidence in colleagues and clients."},{"title":"Midheaven in Capricorn - Executive Potential","text":"With your Midheaven in Capricorn, you're destined for positions of authority and responsibility. Your public reputation will be built on competence, reliability, and achievement. You excel in traditional business structures, government, or any field where climbing the ladder of success is possible through dedicated effort."},{"title":"Saturn in 10th House - Career Mastery","text":"Saturn in your 10th house of career indicates that success comes through persistent effort and learning from challenges. You may start in humble positions but will eventually achieve recognition and authority. Your career path involves building expertise over time and becoming a respected master of your field."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Missing birth time for career analysis","description":"Validation error when birth time is required for accurate career timing","value":{"success":false,"error":{"error_code":"MISSING_BIRTH_TIME","message":"Birth time is required for Midheaven and house calculations","field":"birth_data.hour","severity":"high","suggestions":["Provide exact birth time for accurate career analysis","Contact birth registry if time is unknown","Use solar chart if exact time unavailable"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/career\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/career\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/career\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/career\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/career\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/relationship":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Relationship Analysis","description":"💕 **Relationship Analysis** - Comprehensive relationship dynamics and compatibility\n\n**Perfect for:**\n- 💑 Couples therapy and counseling\n- 💍 Pre-marital compatibility analysis\n- 🔄 Relationship troubleshooting\n- 📈 Relationship growth guidance\n\n**What you get:**\n- **Synastry Analysis** (how charts interact)\n- **Emotional Compatibility** (Moon connections)\n- **Communication Patterns** (Mercury interactions)\n- **Romantic Chemistry** (Venus-Mars aspects)\n- **Long-term Potential** (Saturn connections)\n\n**Response time:** ~700ms | **Content:** Detailed relationship interpretations","operationId":"get_relationship_analysis_api_v3_analysis_relationship_post","requestBody":{"content":{"application/json":{"schema":{"title":"Request"},"examples":{"relationship_dynamics":{"summary":"Relationship Dynamics Report","description":"Comprehensive relationship analysis with psychological insights","value":{"subjects":[{"name":"Partner One","birth_data":{"year":1990,"month":7,"day":12,"hour":14,"minute":20,"second":0,"city":"Seattle","country_code":"US"}},{"name":"Partner Two","birth_data":{"year":1988,"month":12,"day":3,"hour":18,"minute":45,"second":0,"city":"Portland","country_code":"US"}}],"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":2},"report_options":{"tradition":"psychological","language":"en"}}},"standardized_format":{"summary":"Standardized Format - Subjects Array","description":"Example using standardized subjects array format","value":{"subjects":[{"name":"Person 1","birth_data":{"year":1990,"month":7,"day":12,"hour":14,"minute":20,"city":"Seattle","country_code":"US"}},{"name":"Person 2","birth_data":{"year":1988,"month":12,"day":3,"hour":18,"minute":45,"city":"Portland","country_code":"US"}}],"options":{"house_system":"P","tradition":"psychological","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful relationship analysis with synastry and compatibility insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynastryReportResponse"},"examples":{"successful_response":{"summary":"Successful relationship analysis","description":"Complete relationship report with synastry aspects and compatibility insights","value":{"report_title":"Relationship Report: Oleg & Partner","sections":[{"title":"Emotional Compatibility","interpretations":[{"factor":"Sun trine Moon","text":"This beautiful aspect creates natural emotional understanding between you. Your core selves resonate harmoniously, making it easy to support each other's goals."}]},{"title":"Romantic Attraction","interpretations":[{"factor":"Venus conjunction Mars","text":"Intense romantic and sexual attraction with immediate chemistry and a strong magnetic pull between you."}]},{"title":"Communication Patterns","interpretations":[{"factor":"Mercury sextile Mercury","text":"Easy mental rapport and similar communication styles support understanding and productive dialogue."}]}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Incomplete relationship data","description":"Validation error when relationship analysis data is incomplete","value":{"success":false,"error":{"error_code":"MISSING_PARTNER_DATA","message":"Both subjects required for relationship analysis","field":"subjects","severity":"high","suggestions":["Provide complete birth data for both partners","Ensure both subjects have valid dates and locations","Use natal-report endpoint for single-person analysis"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/relationship\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/relationship\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/relationship\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/relationship\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/relationship\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/psychological":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Psychological Analysis","description":"🧠 **Psychological Analysis** - Deep psychological astrology insights\n\n**Perfect for:**\n- 🎭 Therapy and psychological counseling\n- 🔍 Self-discovery and personal growth\n- 🧘 Spiritual and psychological development\n- 📚 Jungian and depth psychology applications\n\n**What you get:**\n- **Psychological Patterns** and unconscious drives\n- **Shadow Work** opportunities (challenging aspects)\n- **Persona vs. True Self** analysis\n- **Growth Areas** and developmental themes\n- **Integration Guidance** for psychological wholeness\n\n**Response time:** ~600ms | **Tradition:** Psychological astrology focus","operationId":"get_psychological_analysis_api_v3_analysis_psychological_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalReportRequest"},"examples":{"depth_psychology":{"summary":"Depth Psychology Analysis","description":"Psychological astrology report focusing on unconscious patterns","value":{"subject":{"name":"Inner Explorer","birth_data":{"year":1987,"month":10,"day":31,"hour":21,"minute":15,"second":0,"city":"Vienna","country_code":"AT"}},"tradition":"psychological","language":"en"}}}}},"required":true},"responses":{"200":{"description":"Successful psychological analysis with depth psychology insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v3__schemas__responses__NatalReportResponse"},"examples":{"successful_response":{"summary":"Successful psychological analysis","description":"Complete psychological report with depth psychology and personality insights","value":{"subject":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"tz_str":"Europe/Kiev","city":"Kharkiv","nation":"UA","lat":49.9935,"lng":36.2304},"interpretations":[{"title":"Sun in Taurus - Core Identity","text":"Your psychological foundation rests on the need for security, stability, and sensual pleasure. You approach life with patience and determination, building your identity through consistent effort and tangible achievements. Your core self seeks comfort, beauty, and material security as expressions of self-worth."},{"title":"Moon in Scorpio - Emotional Depths","text":"Your unconscious mind operates through intense emotional depths and psychological transformation. You're drawn to explore hidden motivations and psychological undercurrents, both in yourself and others. This placement suggests powerful intuitive abilities and a tendency to experience emotional extremes."},{"title":"Saturn Aspects - Shadow Integration","text":"Your Saturn aspects reveal areas where you've developed compensatory mechanisms and defense patterns. These represent both your greatest challenges and your potential for psychological growth. Working with these energies consciously can lead to profound personal transformation and wisdom."}]}}}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid psychological analysis parameters","description":"Validation error when psychological analysis parameters are incorrect","value":{"success":false,"error":{"error_code":"INVALID_TRADITION","message":"Psychological tradition requires specific interpretation framework","field":"tradition","value":"invalid_tradition","severity":"medium","suggestions":["Use 'psychological' tradition for depth psychology insights","See /api/v3/glossary for available traditions"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/psychological\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/psychological\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/psychological\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/psychological\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/psychological\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/karmic":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Karmic Analysis","description":"🔄 **Karmic Analysis** - Past-life patterns and evolutionary astrology\n\n**Perfect for:**\n- 🌟 Soul purpose and life mission guidance\n- 🔄 Understanding karmic patterns\n- 📿 Spiritual development and growth\n- 🎯 Evolutionary astrology consultations\n\n**What you get:**\n- **North/South Node** analysis (karmic path)\n- **Past-Life Indicators** from planetary positions\n- **Soul Purpose** and evolutionary goals\n- **Karmic Lessons** and growth opportunities\n- **Spiritual Guidance** for this lifetime\n\n**Focus areas:**\n- **Lunar Nodes** (karmic axis)\n- **Saturn aspects** (karmic lessons)\n- **Pluto placements** (transformation)\n- **12th House** themes (past-life karma)\n\n**Response time:** ~650ms | **Content:** Karmic and evolutionary interpretations","operationId":"get_karmic_analysis_api_v3_analysis_karmic_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalReportRequest"},"examples":{"soul_evolution":{"summary":"Soul Evolution Analysis","description":"Karmic astrology focusing on evolutionary growth and soul purpose","value":{"subject":{"name":"Soul Seeker","birth_data":{"year":1991,"month":2,"day":14,"hour":7,"minute":30,"second":0,"city":"Sedona","country_code":"US"}},"tradition":"universal","language":"en"}}}}},"required":true},"responses":{"200":{"description":"Successful karmic analysis with past-life and evolutionary insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v3__schemas__responses__NatalReportResponse"}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/karmic\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/karmic\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/karmic\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/karmic\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/karmic\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/health":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Health Analysis","description":"🏥 **Health Analysis** - Medical astrology and wellness guidance\n\n**Perfect for:**\n- 🌿 Holistic health practitioners\n- 💊 Complementary medical approaches\n- 🧘 Wellness and preventive care\n- 📊 Health pattern recognition\n\n**What you get:**\n- **Constitutional Analysis** based on chart patterns\n- **Health Tendencies** and potential vulnerabilities\n- **Wellness Timing** for health activities\n- **Nutritional Guidance** based on elemental balance\n- **Exercise Recommendations** aligned with chart energies\n\n**Analysis includes:**\n- **6th House** (health and daily routines)\n- **Mars placement** (energy and vitality)\n- **Moon sign** (nutritional needs)\n- **Saturn aspects** (structural health)\n\n**Note:** For informational purposes only, not medical advice\n**Response time:** ~550ms | **Content:** Health-focused interpretations","operationId":"get_health_analysis_api_v3_analysis_health_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalReportRequest"},"examples":{"holistic_health":{"summary":"Holistic Health Analysis","description":"Medical astrology analysis for health and wellness guidance","value":{"subject":{"name":"Wellness Seeker","birth_data":{"year":1989,"month":6,"day":21,"hour":12,"minute":0,"second":0,"city":"Boulder","country_code":"US"}},"tradition":"universal","language":"en"}}}}},"required":true},"responses":{"200":{"description":"Successful health analysis with medical astrology insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v3__schemas__responses__NatalReportResponse"}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/health\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/health\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/health\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/health\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/health\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/spiritual":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Spiritual Analysis","description":"🙏 **Spiritual Analysis** - Esoteric astrology and spiritual development\n\n**Perfect for:**\n- ✨ Spiritual counseling and guidance\n- 🔮 Metaphysical and esoteric studies\n- 🧘 Meditation and consciousness development\n- 📿 Religious and spiritual communities\n\n**What you get:**\n- **Spiritual Purpose** and higher calling\n- **Psychic Abilities** and intuitive gifts\n- **Meditation Practices** suited to your chart\n- **Spiritual Challenges** and growth opportunities\n- **Higher Consciousness** development paths\n\n**Focus areas:**\n- **12th House** (spirituality and transcendence)\n- **Neptune aspects** (spiritual sensitivity)\n- **9th House** (higher philosophy)\n- **Jupiter placement** (spiritual growth)\n\n**Response time:** ~600ms | **Content:** Spiritually-focused interpretations","operationId":"get_spiritual_analysis_api_v3_analysis_spiritual_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalReportRequest"},"examples":{"esoteric_analysis":{"summary":"Esoteric Spiritual Analysis","description":"Spiritual astrology focusing on soul development and higher consciousness","value":{"subject":{"name":"Spiritual Explorer","birth_data":{"year":1986,"month":11,"day":11,"hour":11,"minute":11,"second":0,"city":"Glastonbury","country_code":"GB"}},"tradition":"universal","language":"en"}}}}},"required":true},"responses":{"200":{"description":"Successful spiritual analysis with esoteric and metaphysical insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v3__schemas__responses__NatalReportResponse"}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/spiritual\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/spiritual\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/spiritual\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/spiritual\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/spiritual\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/predictive":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Predictive Analysis","description":"🔮 **Predictive Analysis** - Timing and forecasting with transit insights\n\n**Perfect for:**\n- 📅 Life planning and decision timing\n- 🎯 Goal achievement and milestone planning\n- 📈 Business and investment timing\n- 🔄 Life transition guidance\n\n**What you get:**\n- **Major Transit Themes** for the period\n- **Optimal Timing** for important decisions\n- **Challenge Periods** and how to navigate them\n- **Opportunity Windows** and favorable timing\n- **Life Area Forecasts** (career, relationships, health)\n\n**Analysis methods:**\n- **Transits to natal planets**\n- **Progressive aspects**\n- **Solar/Lunar return themes**\n- **Eclipses and major configurations**\n\n**Response time:** ~800ms | **Content:** Predictive timing interpretations","operationId":"get_predictive_analysis_api_v3_analysis_predictive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitRequest"},"examples":{"future_trends":{"summary":"Future Trends Analysis","description":"Predictive astrology focusing on upcoming trends and timing","value":{"subject":{"name":"Future Planner","birth_data":{"year":1992,"month":3,"day":20,"hour":15,"minute":45,"second":0,"city":"Los Angeles","country_code":"US"}},"transit_time":{"date_range":{"start_date":{"year":2024,"month":1,"day":1},"end_date":{"year":2024,"month":12,"day":31}}},"orb":2.0,"report_options":{"tradition":"event_oriented","language":"en"}}},"quarterly_forecast":{"summary":"Quarterly Forecast","description":"Three-month predictive analysis for near-term planning","value":{"subject":{"name":"Future Planner","birth_data":{"year":1992,"month":3,"day":20,"hour":15,"minute":45,"city":"Los Angeles","country_code":"US"}},"transit_time":{"date_range":{"start_date":{"year":2024,"month":1,"day":1},"end_date":{"year":2024,"month":3,"day":31}}},"orb":1.5,"report_options":{"tradition":"event_oriented","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful predictive analysis with timing and forecasting insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitReportResponse"}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/predictive\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/predictive\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/predictive\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/predictive\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/predictive\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/vocational":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Vocational Analysis","description":"🎯 **Vocational Analysis** - Career talents and professional path guidance\n\n**Perfect for:**\n- 🎓 Career counseling and guidance\n- 💡 Talent identification and development\n- 🔄 Career change and transition planning\n- 🏢 Professional development programs\n\n**What you get:**\n- **Natural Talents** based on planetary strengths\n- **Career Paths** aligned with chart patterns\n- **Work Environment** preferences and needs\n- **Professional Skills** and areas of expertise\n- **Leadership Style** and management approach\n\n**Key indicators:**\n- **Midheaven sign** (career image)\n- **10th House** planets and aspects\n- **Mars placement** (drive and ambition)\n- **Mercury position** (communication skills)\n\n**Response time:** ~600ms | **Content:** Career-focused talent analysis","operationId":"get_vocational_analysis_api_v3_analysis_vocational_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalReportRequest"},"examples":{"career_talents":{"summary":"Career Talents Analysis","description":"Vocational astrology focusing on natural talents and career paths","value":{"subject":{"name":"Talent Explorer","birth_data":{"year":1994,"month":8,"day":12,"hour":10,"minute":30,"second":0,"city":"Austin","country_code":"US"}},"tradition":"universal","language":"en"}}}}},"required":true},"responses":{"200":{"description":"Successful vocational analysis with career path and talent insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v3__schemas__responses__NatalReportResponse"}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/vocational\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/vocational\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/vocational\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/vocational\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/vocational\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/relocation":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Relocation Analysis","description":"🗺️ **Relocation Analysis** - See how your chart changes at a new location\n\n**Perfect for:**\n- ✈️ International relocation planning\n- 🏡 Choosing optimal living locations\n- 💼 Business location selection\n- 🌍 Understanding life changes at different places\n\n**What you get:**\n- **House Shifts** - Which planets change houses at the new location\n- **Angular Planets** - Planets that become prominent (ASC/MC/DSC/IC)\n- **Life Area Changes** - How career, relationships, home life are affected\n- **Angle Comparison** - Ascendant and Midheaven changes\n\n**Key concept:** Same birth moment, different location = different house cusps.\nPlanetary positions stay the same, but the *life areas* they activate change.\n\n**Response time:** ~500ms | **Content:** Natal vs relocated chart comparison","operationId":"get_relocation_analysis_api_v3_analysis_relocation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelocationChartRequest"},"examples":{"kharkiv_to_nyc":{"summary":"Kharkiv to New York Relocation","description":"Analyze how houses and life areas change when relocating","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"target_location":{"city":"New York","country_code":"US"},"show_changes":true,"highlight_angular_changes":true}}},"london_to_tokyo":{"summary":"London to Tokyo Relocation","description":"Major relocation across hemispheres","value":{"subject":{"name":"Sarah","birth_data":{"year":1992,"month":8,"day":22,"hour":10,"minute":30,"city":"London","country_code":"GB"}},"options":{"target_location":{"city":"Tokyo","country_code":"JP"}}}}}}},"required":true},"responses":{"200":{"description":"Successful relocation analysis with house shifts and angular planets","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/relocation\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/relocation\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/relocation\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/relocation\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/relocation\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/analysis/transit-report":{"post":{"tags":["📖 Reports & Interpretations"],"summary":"Get Transit Report","description":"🌟 **Transit Report** - Comprehensive transit analysis with timing predictions\n\n**Perfect for:**\n- 📅 Personal timing and planning\n- 🎯 Decision-making guidance\n- 📈 Life cycle understanding\n- 🔄 Transition navigation\n\n**What you get:**\n- **Active Transits** during the specified period\n- **Timing Interpretations** for each transit\n- **Life Area Impacts** (career, relationships, health)\n- **Opportunity Windows** and favorable periods\n- **Challenge Navigation** guidance\n\n**Response time:** ~700ms | **Content:** Detailed transit interpretations","operationId":"get_transit_report_api_v3_analysis_transit_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitRequest"},"examples":{"monthly_transits":{"summary":"Monthly Transit Report","description":"Current month's transits with tight orbs for precise timing","value":{"subject":{"name":"Transit Tracker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"transit_time":{"date_range":{"start_date":{"year":2024,"month":3,"day":1},"end_date":{"year":2024,"month":3,"day":31}}},"orb":1.0,"report_options":{"tradition":"universal","language":"en"}}},"yearly_transits":{"summary":"Yearly Transit Report","description":"Full year transit analysis with wider orbs","value":{"subject":{"name":"Transit Tracker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"transit_time":{"date_range":{"start_date":{"year":2024,"month":1,"day":1},"end_date":{"year":2024,"month":12,"day":31}}},"orb":2.0,"report_options":{"tradition":"universal","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful transit report generation with timing predictions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalTransitReportResponse"}}}},"400":{"description":"Invalid analysis parameters"},"422":{"description":"Validation error - check report options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/analysis/transit-report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"transit_date\": {\"year\": 2024, \"month\": 12, \"day\": 25, \"hour\": 12, \"minute\": 0}, \"options\": {\"house_system\": \"P\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\"], \"orb_set\": \"medium\"}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/analysis/transit-report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/analysis/transit-report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/analysis/transit-report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/analysis/transit-report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"transit_date\": {\n \"year\": 2024,\n \"month\": 12,\n \"day\": 25,\n \"hour\": 12,\n \"minute\": 0\n },\n \"options\": {\n \"house_system\": \"P\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\"\n ],\n \"orb_set\": \"medium\"\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/analysis/annual-profection":{"post":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Annual Profection","description":"🏛️ **Calculate Annual Profection (Lord of the Year)**\n\nReturns the activated house, sign, and planetary ruler for any given age using traditional\nHellenistic methods. Essential for traditional timing techniques.\n\n**Traditional Method:**\n- Each year of life activates a different house (age mod 12)\n- The ruler of the activated sign becomes the \"Lord of the Year\" (Chronocrator)\n- Provides insights into the year's main themes and planetary influences\n\n**Example:** At age 25, the 2nd house is activated (25 mod 12 = 1, +1 = 2nd house).\nIf Ascendant is Aries, the activated sign is Taurus, ruled by Venus.\n\n**Use Cases:**\n- Annual planning and timing\n- Understanding yearly themes\n- Traditional predictive astrology\n- Life cycle analysis","operationId":"get_annual_profection_api_v3_traditional_analysis_annual_profection_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnualProfectionRequest"},"examples":{"current_year":{"summary":"Current Year Profection","description":"Calculate Lord of the Year for current age","value":{"subject":{"name":"Traditional Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}}}},"specific_age":{"summary":"Specific Age Analysis","description":"Profection analysis for a specific date and age","value":{"subject":{"name":"Marcus Aurelius","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Athens","country_code":"GR"}},"current_date":"2024-08-22"}},"coordinates_based":{"summary":"Coordinates-based Profection","description":"Using exact coordinates for precise ascendant calculation","value":{"subject":{"name":"Precision Astrologer","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":30,"latitude":41.9028,"longitude":12.4964}},"current_date":"2025-01-01"}}}}},"required":true},"responses":{"200":{"description":"Successful Annual Profection Calculation","content":{"application/json":{"schema":{},"examples":{"age_36_saturn_year":{"summary":"Age 36 - Saturn Year (9th House)","description":"Saturn as Lord of the Year ruling philosophy and higher learning","value":{"method":"Annual Profection","current_age":36,"profected_house":9,"profected_sign":"Sag","traditional_ruler":"Jupiter","house_themes":["philosophy","higher_learning","travel","teaching","publishing","foreign_cultures"]}},"age_25_venus_year":{"summary":"Age 25 - Venus Year (2nd House)","description":"Venus as Lord of the Year ruling money and resources","value":{"method":"Annual Profection","current_age":25,"profected_house":2,"profected_sign":"Tau","traditional_ruler":"Venus","house_themes":["money","resources","possessions","values","earning_capacity","material_security"]}},"age_42_mars_year":{"summary":"Age 42 - Mars Year (7th House)","description":"Mars as Lord of the Year ruling partnerships and open enemies","value":{"method":"Annual Profection","current_age":42,"profected_house":7,"profected_sign":"Ari","traditional_ruler":"Mars","house_themes":["marriage","partnerships","open_enemies","contracts","lawsuits","cooperation"]}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/traditional/analysis/annual-profection\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/analysis/annual-profection\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/analysis/annual-profection\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/analysis/annual-profection\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/analysis/annual-profection\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/analysis":{"post":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Traditional Analysis","description":"🏛️ **Comprehensive Traditional Astrology Analysis**\n\nGenerates complete traditional astrology analysis using Hellenistic techniques including:\n\n**Perfect for:**\n- 🎯 Professional traditional astrology consultations\n- 📚 Hellenistic astrology research and study\n- 🔮 Traditional timing and electional astrology\n- 📊 Complete dignity and reception analysis\n\n**Dignity Analysis:**\n- **Essential dignities** - domicile, exaltation, triplicity, term, decan\n- **Essential debilities** - exile and fall\n- **Sect analysis** - day/night chart preferences and planetary conditions\n\n**Reception Analysis:**\n- **Mutual receptions** - traditional planetary relationships\n- **Dispositor chains** - complete rulership sequences and final dispositors\n- **Reception quality** - dignity-based aspect interpretation\n\n**Traditional Points:**\n- **Part of Fortune** - calculated with proper day/night formulas\n- **Part of Spirit** - complementary to Part of Fortune\n- **Additional Arabic Parts/Lots** - traditional calculation methods\n\n**Special Conditions:**\n- **Combustion** - planets too close to the Sun (within 8.5°)\n- **Cazimi** - planets in the heart of the Sun (within 17 minutes)\n- **Under the beams** - planets weakened by solar proximity\n- **Houses of joy** - planetary jubilation in traditional houses\n- **About to change sign** - planets near sign boundaries\n\n**Input Parameters:**\n- **subject** - Birth data including name and DateTimeLocation\n- **options** - Chart calculation options (house system, active points, etc.)\n- **orbs** - Aspect orb settings for traditional conditions\n\n**Response time:** ~400ms | **Accuracy:** Swiss Ephemeris + Traditional calculations","operationId":"get_traditional_analysis_api_v3_traditional_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraditionalAnalysisRequest"},"examples":{"hellenistic_analysis":{"summary":"Hellenistic Traditional Analysis","description":"Complete traditional astrology analysis with Whole Sign houses","value":{"subject":{"name":"Hellenistic Scholar","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"Athens","country_code":"GR"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Part_of_Fortune","Part_of_Spirit"],"precision":4},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"dignity_focus":{"summary":"Essential Dignities Focus","description":"Analysis emphasizing planetary dignities and debilities","value":{"subject":{"name":"Dignity Master","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":48.8566,"longitude":2.3522}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3},"orbs":{"major_aspects_deg":1.5,"minor_aspects_deg":0.5}}},"reception_analysis":{"summary":"Mutual Reception Analysis","description":"Focus on planetary receptions and dispositor chains","value":{"subject":{"name":"Reception Expert","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Alexandria","country_code":"EG"}},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","Part_of_Fortune"],"precision":2},"orbs":{"major_aspects_deg":3.0,"minor_aspects_deg":1.5}}}}}},"required":true},"responses":{"200":{"description":"Comprehensive Traditional Astrology Analysis","content":{"application/json":{"schema":{},"examples":{"dignified_jupiter_chart":{"summary":"Chart with Jupiter in Domicile","description":"Traditional analysis showing Jupiter in Sagittarius with strong dignities","value":{"success":true,"chart_data":{"house_system":"W","ascendant_sign":"Ari"},"traditional_analysis":{"chart_ruler":"Mars","sect":"night","overall_dignity_score":8.5,"strongest_planet":"Jupiter","most_afflicted":"Saturn"},"dignities":{"Jupiter":{"domicile":true,"exaltation":false,"triplicity":{"ruler":true,"participating":false,"cooperating":false},"term":"Jupiter","decan":"Jupiter","dignity_score":9.0},"Sun":{"domicile":false,"exaltation":false,"triplicity":{"ruler":false,"participating":true,"cooperating":false},"term":"Jupiter","decan":"Sun","dignity_score":3.5},"Mars":{"domicile":false,"exaltation":true,"triplicity":{"ruler":false,"participating":false,"cooperating":true},"term":"Mars","decan":"Venus","dignity_score":6.0}},"conditions":{"combustion":{"Mercury":{"combust":true,"distance_from_sun":3.2,"cazimi":false}},"houses_of_joy":{"Jupiter":{"in_joy":false,"joy_house":11,"current_house":9},"Mars":{"in_joy":false,"joy_house":6,"current_house":5}},"about_to_change_sign":{"Venus":{"changing":true,"degrees_to_boundary":1.3,"next_sign":"Lib"}}},"receptions":{"mutual_receptions":[{"planets":["Venus","Mars"],"type":"domicile","strength":"strong"}],"dispositor_chains":{"Sun":["Sun","Sun"],"Moon":["Moon","Venus","Mars","Mars"],"Mercury":["Mercury","Sun","Sun"],"Venus":["Venus","Mars","Mars"],"Mars":["Mars","Venus","Mars"]},"final_dispositors":["Sun","Mars"]},"traditional_points":{"Part_of_Fortune":{"longitude":127.45,"sign":"Leo","house":5,"formula":"Ascendant + Moon - Sun (night chart)","traditional_meaning":"Body, health, material fortune"},"Part_of_Spirit":{"longitude":89.23,"sign":"Gem","house":3,"formula":"Ascendant + Sun - Moon (night chart)","traditional_meaning":"Soul, spiritual development, reputation"}},"sect_analysis":{"chart_sect":"night","sect_light":"Moon","benefic_in_sect":"Venus","malefic_in_sect":"Mars","benefic_out_of_sect":"Jupiter","malefic_out_of_sect":"Saturn","sect_quality":"well_integrated"},"calculation_time":"2024-01-15T12:00:00Z","chart_type":"traditional","house_system":"W"}},"afflicted_mercury_chart":{"summary":"Chart with Combust Mercury","description":"Analysis showing Mercury combust and Saturn in fall","value":{"success":true,"chart_data":{"house_system":"W","ascendant_sign":"Vir"},"traditional_analysis":{"chart_ruler":"Mercury","sect":"day","overall_dignity_score":4.2,"strongest_planet":"Venus","most_afflicted":"Mercury"},"dignities":{"Mercury":{"domicile":true,"exaltation":false,"triplicity":{"ruler":false,"participating":false,"cooperating":true},"term":"Mercury","decan":"Mercury","dignity_score":6.0,"debilities":{"combust":true}},"Saturn":{"domicile":false,"exaltation":false,"triplicity":{"ruler":false,"participating":false,"cooperating":false},"term":"Venus","decan":"Mars","dignity_score":1.0,"debilities":{"fall":true,"in_aries":true}}},"conditions":{"combustion":{"Mercury":{"combust":true,"distance_from_sun":2.8,"cazimi":false,"under_beams":true}},"houses_of_joy":{"Mercury":{"in_joy":true,"joy_house":1,"current_house":1,"strength_bonus":1.0}},"planetary_conditions":{"Saturn":{"condition":"fall","severity":"major_debility","sign":"Ari"}}},"receptions":{"mutual_receptions":[],"dispositor_chains":{"Sun":["Sun","Sun"],"Moon":["Moon","Venus","Venus"],"Mercury":["Mercury","Mercury"],"Venus":["Venus","Venus"],"Mars":["Mars","Mercury","Mercury"]},"final_dispositors":["Sun","Venus","Mercury"]},"traditional_points":{"Part_of_Fortune":{"longitude":45.67,"sign":"Tau","house":9,"formula":"Ascendant + Moon - Sun (day chart)","traditional_meaning":"Material fortune and bodily health"}},"sect_analysis":{"chart_sect":"day","sect_light":"Sun","benefic_in_sect":"Jupiter","malefic_in_sect":"Saturn","benefic_out_of_sect":"Venus","malefic_out_of_sect":"Mars","sect_quality":"moderately_integrated"},"calculation_time":"2024-01-15T12:00:00Z","chart_type":"traditional","house_system":"W"}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/traditional/analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/analysis/profection-timeline":{"post":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Profection Timeline","description":"📅 **Calculate Profection Timeline**\n\nShows which houses and rulers are activated for each year of life within the\nspecified age range. Essential for long-term planning and life theme analysis.\n\n**Timeline Features:**\n- Year-by-year house activation\n- Planetary rulers for each year\n- House themes and life areas\n- 12-year cycle patterns\n\n**Traditional Insights:**\n- Repeating 12-year cycles\n- Planetary period emphasis\n- Life theme progression\n- Timing for major decisions\n\n**Query Parameters:**\n- `start_age`: Starting age (default: 0)\n- `end_age`: Ending age (default: 84)\n\n**Perfect for:**\n- Life planning and timing\n- Understanding personal cycles\n- Traditional predictive work\n- Counseling and guidance","operationId":"get_profection_timeline_api_v3_traditional_analysis_profection_timeline_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfectionTimelineRequest"},"examples":{"life_overview":{"summary":"Complete Life Overview","description":"Full 84-year profection timeline from birth to old age","value":{"subject":{"name":"Life Planner","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"start_age":0,"end_age":84}},"career_years":{"summary":"Career Development Years","description":"Focus on career-building years (25-45)","value":{"subject":{"name":"Career Focused","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"city":"Paris","country_code":"FR"}},"start_age":25,"end_age":45}},"retirement_planning":{"summary":"Retirement & Elder Years","description":"Traditional timing for later life transitions","value":{"subject":{"name":"Elder Wisdom","birth_data":{"year":1950,"month":3,"day":25,"hour":12,"minute":0,"second":0,"latitude":35.6762,"longitude":139.6503}},"start_age":60,"end_age":84}},"current_cycle":{"summary":"Current 12-Year Cycle","description":"Focus on current and next 12-year cycle","value":{"subject":{"name":"Cycle Tracker","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Athens","country_code":"GR"}},"start_age":30,"end_age":42}}}}},"required":true},"responses":{"200":{"description":"Profection Timeline with Chronocrator Analysis","content":{"application/json":{"schema":{},"examples":{"career_development_timeline":{"summary":"Career Years Timeline (Ages 25-35)","description":"Traditional timing for career development with planetary rulers","value":{"timeline":[{"age":25,"profected_house":2,"profected_sign":"Tau","traditional_ruler":"Venus","house_themes":["money","resources","earning_capacity"],"interpretation":"Venus year emphasizing financial foundation and values"},{"age":26,"profected_house":3,"profected_sign":"Gem","traditional_ruler":"Mercury","house_themes":["communication","learning","siblings"],"interpretation":"Mercury year for skill development and networking"},{"age":27,"profected_house":4,"profected_sign":"Can","traditional_ruler":"Moon","house_themes":["home","family","foundations"],"interpretation":"Moon year for establishing roots and domestic matters"},{"age":28,"profected_house":5,"profected_sign":"Leo","traditional_ruler":"Sun","house_themes":["creativity","self-expression","children"],"interpretation":"Sun year for creative projects and personal recognition"},{"age":29,"profected_house":6,"profected_sign":"Vir","traditional_ruler":"Mercury","house_themes":["work","health","service"],"interpretation":"Mercury year for work optimization and health routines"},{"age":30,"profected_house":7,"profected_sign":"Lib","traditional_ruler":"Venus","house_themes":["partnerships","marriage","cooperation"],"interpretation":"Venus year for significant partnerships and collaboration"}],"summary":{"total_years":6,"cycles_covered":1,"most_active_rulers":{"Mercury":2,"Venus":2,"Moon":1,"Sun":1},"key_transition_years":[24,36],"dominant_elements":{"earth":2,"air":2,"water":1,"fire":1}},"current_profection":{"age":29,"profected_house":6,"profected_sign":"Vir","traditional_ruler":"Mercury","house_themes":["work","health","service"],"interpretation":"Current Mercury year emphasizing work refinement and health"}}},"complete_cycle_timeline":{"summary":"Complete 12-Year Cycle (Ages 24-35)","description":"Full traditional profection cycle showing all house activations","value":{"timeline":[{"age":24,"profected_house":1,"profected_sign":"Ari","traditional_ruler":"Mars","house_themes":["self","identity","new_beginnings"],"cycle_phase":"initiation"},{"age":25,"profected_house":2,"profected_sign":"Tau","traditional_ruler":"Venus","house_themes":["resources","values","stability"],"cycle_phase":"establishment"},{"age":26,"profected_house":3,"profected_sign":"Gem","traditional_ruler":"Mercury","house_themes":["communication","learning","connections"],"cycle_phase":"expansion"},{"age":27,"profected_house":4,"profected_sign":"Can","traditional_ruler":"Moon","house_themes":["home","roots","security"],"cycle_phase":"foundation"},{"age":28,"profected_house":5,"profected_sign":"Leo","traditional_ruler":"Sun","house_themes":["creativity","self-expression","joy"],"cycle_phase":"manifestation"},{"age":29,"profected_house":6,"profected_sign":"Vir","traditional_ruler":"Mercury","house_themes":["work","health","refinement"],"cycle_phase":"optimization"},{"age":30,"profected_house":7,"profected_sign":"Lib","traditional_ruler":"Venus","house_themes":["relationships","partnerships","balance"],"cycle_phase":"cooperation"},{"age":31,"profected_house":8,"profected_sign":"Sco","traditional_ruler":"Mars","house_themes":["transformation","shared_resources","depth"],"cycle_phase":"transformation"},{"age":32,"profected_house":9,"profected_sign":"Sag","traditional_ruler":"Jupiter","house_themes":["philosophy","higher_learning","expansion"],"cycle_phase":"understanding"},{"age":33,"profected_house":10,"profected_sign":"Cap","traditional_ruler":"Saturn","house_themes":["career","reputation","achievement"],"cycle_phase":"mastery"},{"age":34,"profected_house":11,"profected_sign":"Aqu","traditional_ruler":"Saturn","house_themes":["friends","hopes","community"],"cycle_phase":"integration"},{"age":35,"profected_house":12,"profected_sign":"Pis","traditional_ruler":"Jupiter","house_themes":["spirituality","endings","transcendence"],"cycle_phase":"completion"}],"summary":{"total_years":12,"cycles_covered":1,"most_active_rulers":{"Saturn":2,"Venus":2,"Mercury":2,"Mars":2,"Jupiter":2,"Sun":1,"Moon":1},"key_transition_years":[24,36],"planetary_emphasis_periods":{"Mercury_years":[26,29],"Venus_years":[25,30],"Mars_years":[24,31],"Jupiter_years":[32,35],"Saturn_years":[33,34]}}}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/traditional/analysis/profection-timeline\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/analysis/profection-timeline\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/analysis/profection-timeline\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/analysis/profection-timeline\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/analysis/profection-timeline\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/glossary/traditional-points":{"get":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Traditional Points Glossary","description":"📚 **Traditional Points Glossary**\n\nComplete reference for traditional astrological points (Arabic Parts/Lots)\nwith descriptions, formulas, and meanings.\n\n**Includes:**\n- Part of Fortune (Pars Fortunae)\n- Part of Spirit (Pars Spiritus)\n- Part of Love, Necessity, Courage\n- Calculation formulas (day/night variations)\n- Traditional meanings and keywords\n- Usage guidelines\n\n**Categories:**\n- Essential Parts (Fortune, Spirit)\n- Planetary Parts (Love, Courage, etc.)\n- Specialized Parts (advanced techniques)\n\n**Perfect for:**\n- Learning traditional techniques\n- API integration reference\n- Educational applications","operationId":"get_traditional_points_glossary_api_v3_traditional_glossary_traditional_points_get","responses":{"200":{"description":"Traditional Points (Arabic Parts/Lots) Glossary","content":{"application/json":{"schema":{},"examples":{"complete_traditional_points":{"summary":"Complete Traditional Points Reference","description":"All supported traditional points with formulas and meanings","value":{"points":{"Part_of_Fortune":{"name":"Part of Fortune","symbol":"⊕","arabic_name":"Sahm al-Sa'adah","day_formula":"Ascendant + Moon - Sun","night_formula":"Ascendant + Sun - Moon","traditional_meaning":"Material fortune, bodily health, wealth accumulation","hellenistic_keywords":["body","fortune","material_success","health","prosperity"],"house_significance":"Shows area of greatest material fortune and bodily well-being","planetary_associations":["Moon","Sun","Ascendant_ruler"]},"Part_of_Spirit":{"name":"Part of Spirit","symbol":"☉","arabic_name":"Sahm al-Ruh","day_formula":"Ascendant + Sun - Moon","night_formula":"Ascendant + Moon - Sun","traditional_meaning":"Soul development, spiritual fortune, reputation","hellenistic_keywords":["soul","reputation","spiritual_development","honor","recognition"],"house_significance":"Shows area of spiritual development and reputation building","planetary_associations":["Sun","Moon","Ascendant_ruler"]},"Part_of_Love":{"name":"Part of Love","symbol":"♀","arabic_name":"Sahm al-Mahabbah","day_formula":"Ascendant + Venus - Sun","night_formula":"Ascendant + Venus - Sun","traditional_meaning":"Love relationships, affection, romantic fortune","hellenistic_keywords":["love","relationships","affection","marriage","romantic_fortune"],"house_significance":"Shows area where love and relationships flourish","planetary_associations":["Venus","Sun"]},"Part_of_Courage":{"name":"Part of Courage","symbol":"♂","arabic_name":"Sahm al-Jara'ah","day_formula":"Ascendant + Fortune - Mars","night_formula":"Ascendant + Fortune - Mars","traditional_meaning":"Courage, bravery, military success, conflict resolution","hellenistic_keywords":["courage","bravery","conflict","strength","victory"],"house_significance":"Shows area where courage and strength are most needed/expressed","planetary_associations":["Mars","Part_of_Fortune"]},"Part_of_Necessity":{"name":"Part of Necessity","symbol":"♄","arabic_name":"Sahm al-Ghayb","day_formula":"Ascendant + Fortune - Mercury","night_formula":"Ascendant + Fortune - Mercury","traditional_meaning":"Necessity, obligation, what cannot be avoided","hellenistic_keywords":["necessity","obligation","fate","unavoidable_circumstances","duty"],"house_significance":"Shows area of necessary obligations and fated circumstances","planetary_associations":["Mercury","Part_of_Fortune"]}},"categories":{"essential":["Part_of_Fortune","Part_of_Spirit"],"planetary":["Part_of_Love","Part_of_Courage","Part_of_Necessity"],"specialized":[],"by_planetary_ruler":{"Venus_parts":["Part_of_Love"],"Mars_parts":["Part_of_Courage"],"Mercury_parts":["Part_of_Necessity"],"Luminaries_parts":["Part_of_Fortune","Part_of_Spirit"]}},"calculation_notes":["Day/night formulas differ for Part of Fortune and Part of Spirit - they are complementary","All calculations use absolute longitude (0-360°) then reduce to zodiacal position","House placement calculated from house cusps using selected house system","Traditional sources: Ptolemy (Tetrabiblos), Valens (Anthologies), Abu Ma'shar (Great Introduction)","Some parts use other parts in their formulas (e.g., Part of Courage uses Part of Fortune)","Sect considerations apply - day/night chart status affects interpretation emphasis"],"historical_context":{"origins":"Hellenistic astrology (1st-7th centuries CE)","peak_usage":"Islamic Golden Age (8th-13th centuries)","key_authors":["Ptolemy","Vettius Valens","Abu Ma'shar","Al-Biruni","Guido Bonatti"],"modern_revival":"Project Hindsight translations (1990s-present)"}}},"essential_parts_only":{"summary":"Essential Parts (Fortune & Spirit)","description":"Core traditional points with complementary day/night formulas","value":{"points":{"Part_of_Fortune":{"name":"Part of Fortune","symbol":"⊕","day_formula":"Ascendant + Moon - Sun","night_formula":"Ascendant + Sun - Moon","traditional_meaning":"Material fortune, bodily health, wealth","complementary_to":"Part_of_Spirit"},"Part_of_Spirit":{"name":"Part of Spirit","symbol":"☉","day_formula":"Ascendant + Sun - Moon","night_formula":"Ascendant + Moon - Sun","traditional_meaning":"Spiritual fortune, reputation, soul development","complementary_to":"Part_of_Fortune"}},"categories":{"essential":["Part_of_Fortune","Part_of_Spirit"]},"calculation_notes":["These are complementary points - when one uses Asc+Moon-Sun, the other uses Asc+Sun-Moon","Day charts emphasize Part of Spirit (soul), night charts emphasize Part of Fortune (body)"]}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/traditional/glossary/traditional-points\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/glossary/traditional-points\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/glossary/traditional-points\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/glossary/traditional-points\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/glossary/traditional-points\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/glossary/dignities":{"get":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Dignities Glossary","description":"👑 **Essential Dignities System Glossary**\n\nComplete explanation of the traditional dignity system with rulers,\nmeanings, and hierarchical importance.\n\n**Dignities Explained:**\n- **Domicile**: Planet in own sign (strongest)\n- **Exaltation**: Planet in exaltation sign\n- **Triplicity**: Elemental rulership (sect-dependent)\n- **Term/Bounds**: Egyptian terms system\n- **Decan/Face**: 10-degree rulerships\n\n**Debilities:**\n- **Exile/Detriment**: Opposite of domicile\n- **Fall**: Opposite of exaltation\n\n**Traditional Rulers:**\n- Pre-modern planetary rulers only\n- Sect-based triplicity rulers\n- Historical sources and variations\n\n**Sect System:**\n- Day vs night chart determination\n- Planetary sect preferences\n- Triplicity ruler activation","operationId":"get_dignities_glossary_api_v3_traditional_glossary_dignities_get","responses":{"200":{"description":"Essential Dignities System Complete Reference","content":{"application/json":{"schema":{},"examples":{"complete_dignity_system":{"summary":"Complete Essential Dignities System","description":"Full traditional dignity system with rulers, meanings, and sect analysis","value":{"dignities":{"domicile":{"name":"Domicile","description":"Planet in its own sign - strongest essential dignity","strength":5,"traditional_name":"House/Oikos","analogy":"Planet at home, in full control of resources","rulers":{"Ari":"Mars","Tau":"Venus","Gem":"Mercury","Can":"Moon","Leo":"Sun","Vir":"Mercury","Lib":"Venus","Sco":"Mars","Sag":"Jupiter","Cap":"Saturn","Aqu":"Saturn","Pis":"Jupiter"},"effect":"Planet expresses its nature most purely and powerfully"},"exaltation":{"name":"Exaltation","description":"Planet in its exaltation sign - second strongest dignity","strength":4,"traditional_name":"Hypsoma","analogy":"Planet honored as guest, given special status","rulers":{"Ari":"Sun","Tau":"Moon","Gem":"None","Can":"Jupiter","Leo":"None","Vir":"Mercury","Lib":"Saturn","Sco":"None","Sag":"None","Cap":"Mars","Aqu":"None","Pis":"Venus"},"specific_degrees":{"Sun":"Aries 19°","Moon":"Taurus 3°","Mercury":"Virgo 15°","Venus":"Pisces 27°","Mars":"Capricorn 28°","Jupiter":"Cancer 15°","Saturn":"Libra 21°"},"effect":"Planet performs at its highest potential, elevated expression"},"triplicity":{"name":"Triplicity","description":"Elemental rulership - varies by sect (day/night)","strength":3,"traditional_name":"Trigon","analogy":"Planet comfortable in familiar elemental environment","rulers":{"fire_signs":{"day_ruler":"Sun","night_ruler":"Jupiter","participating_ruler":"Saturn","signs":["Ari","Leo","Sag"]},"earth_signs":{"day_ruler":"Venus","night_ruler":"Moon","participating_ruler":"Mars","signs":["Tau","Vir","Cap"]},"air_signs":{"day_ruler":"Saturn","night_ruler":"Mercury","participating_ruler":"Jupiter","signs":["Gem","Lib","Aqu"]},"water_signs":{"day_ruler":"Venus","night_ruler":"Mars","participating_ruler":"Moon","signs":["Can","Sco","Pis"]}},"effect":"Planet operates harmoniously within elemental context"},"term":{"name":"Term/Bounds","description":"Egyptian terms - 5-degree divisions within signs","strength":2,"traditional_name":"Horia/Bounds","system":"Ptolemaic Egyptian Terms","analogy":"Planet has limited authority in specific degree ranges","calculation":"Each sign divided into 5 unequal segments ruled by different planets","effect":"Moderate dignity, planet has some authority but limited scope","example_terms":{"Ari":"Jupiter 0-6°, Venus 6-12°, Mercury 12-20°, Mars 20-25°, Saturn 25-30°","Tau":"Venus 0-8°, Mercury 8-14°, Jupiter 14-22°, Saturn 22-27°, Mars 27-30°"}},"decan":{"name":"Decan/Face","description":"10-degree divisions - Chaldean order","strength":1,"traditional_name":"Face/Decan","system":"Traditional Chaldean Order","analogy":"Planet has minimal authority, like a messenger or representative","order":"Mars, Sun, Venus, Mercury, Moon, Saturn, Jupiter (repeating)","calculation":"Each sign has three 10° decans following Chaldean planetary order","effect":"Weakest dignity, provides subtle influence and coloration","example_decans":{"Ari":"Mars 0-10°, Sun 10-20°, Venus 20-30°","Tau":"Mercury 0-10°, Moon 10-20°, Saturn 20-30°"}}},"debilities":{"exile":{"name":"Exile/Detriment","description":"Planet in sign opposite its domicile","weakness":-4,"traditional_name":"Exile","analogy":"Planet banished from home, operating in hostile territory","rulers":{"Sun":"Aqu","Moon":"Cap","Mercury":"Sag and Pis","Venus":"Sco and Ari","Mars":"Lib and Tau","Jupiter":"Gem and Vir","Saturn":"Can and Leo"},"effect":"Significantly weakened, contrary to planetary nature, struggles to function"},"fall":{"name":"Fall","description":"Planet in sign opposite its exaltation","weakness":-3,"traditional_name":"Fall/Depression","analogy":"Planet fallen from grace, unable to achieve highest potential","rulers":{"Sun":"Lib","Moon":"Sco","Mercury":"Pis","Venus":"Vir","Mars":"Can","Jupiter":"Cap","Saturn":"Ari"},"effect":"Weakened expression, difficulty accessing highest potentials"}},"traditional_rulers":{"Ari":"Mars","Tau":"Venus","Gem":"Mercury","Can":"Moon","Leo":"Sun","Vir":"Mercury","Lib":"Venus","Sco":"Mars","Sag":"Jupiter","Cap":"Saturn","Aqu":"Saturn","Pis":"Jupiter"},"sect_system":{"determination":"Sun above horizon = day chart, Sun below horizon = night chart","day_chart":"Sun above horizon at birth","night_chart":"Sun below horizon at birth","day_planets":{"planets":["Sun","Jupiter","Saturn"],"sect_light":"Sun","benefic_in_sect":"Jupiter","malefic_in_sect":"Saturn","effect":"These planets function better in day charts"},"night_planets":{"planets":["Moon","Venus","Mars"],"sect_light":"Moon","benefic_in_sect":"Venus","malefic_in_sect":"Mars","effect":"These planets function better in night charts"},"neutral":{"planets":["Mercury"],"effect":"Mercury adapts to chart sect, no strong preference"},"triplicity_activation":"Day/night rulers activate based on chart sect","sect_bonuses":{"in_sect":"+1 to dignity score","out_of_sect":"-1 to dignity score (malefics get -2)"}},"dignity_scoring":{"domicile":5,"exaltation":4,"triplicity_ruler":3,"triplicity_participating":2,"term":2,"decan":1,"exile":-4,"fall":-3,"sect_bonus":1,"sect_penalty":-1,"malefic_out_of_sect":-2}}},"sect_focus":{"summary":"Sect System Analysis","description":"Day/night chart determination and planetary sect preferences","value":{"sect_system":{"day_chart":"Sun above horizon at birth","night_chart":"Sun below horizon at birth","day_planets":["Sun","Jupiter","Saturn"],"night_planets":["Moon","Venus","Mars"],"neutral":["Mercury"],"triplicity_activation":"Day/night rulers activate based on chart sect"},"traditional_rulers":{"fire_triplicity":{"day":"Sun","night":"Jupiter"},"earth_triplicity":{"day":"Venus","night":"Moon"},"air_triplicity":{"day":"Saturn","night":"Mercury"},"water_triplicity":{"day":"Venus","night":"Mars"}}}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/traditional/glossary/dignities\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/glossary/dignities\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/glossary/dignities\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/glossary/dignities\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/glossary/dignities\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/glossary/profection-houses":{"get":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Profection Houses Glossary","description":"🏠 **Profection House Meanings Glossary**\n\nTraditional interpretations of what each house represents when activated\nin annual profections, with examples and timing guidance.\n\n**House Meanings:**\n- Each house's life themes and areas\n- Traditional keywords and associations\n- Modern applications and interpretations\n\n**Profection System:**\n- How annual profections work\n- Age calculation method\n- Ruler activation principles\n- 12-year cycle patterns\n\n**Examples:**\n- Sample profection calculations\n- Real-world timing applications\n- Integration with other techniques","operationId":"get_profection_houses_glossary_api_v3_traditional_glossary_profection_houses_get","responses":{"200":{"description":"Profection House Meanings and System Explanation","content":{"application/json":{"schema":{},"examples":{"complete_profection_houses":{"summary":"Complete Profection Houses Reference","description":"All 12 houses with meanings, themes, and activation examples","value":{"houses":{"1":{"themes":["self","identity","new_beginnings","appearance","health","vitality"],"traditional_meaning":"House 1 governs self, identity, new_beginnings","life_areas":["self_development","personal_identity","physical_appearance"],"activation_ages":[0,12,24,36,48,60,72]},"2":{"themes":["money","possessions","resources","values","earning_capacity","material_security"],"traditional_meaning":"House 2 governs money, possessions, resources","life_areas":["financial_stability","material_resources","personal_values"],"activation_ages":[1,13,25,37,49,61,73]},"3":{"themes":["communication","learning","siblings","short_journeys","neighbors","writing"],"traditional_meaning":"House 3 governs communication, learning, siblings","life_areas":["communication_skills","learning_opportunities","local_community"],"activation_ages":[2,14,26,38,50,62,74]},"7":{"themes":["marriage","partnerships","open_enemies","contracts","lawsuits","cooperation"],"traditional_meaning":"House 7 governs marriage, partnerships, open_enemies","life_areas":["romantic_relationships","business_partnerships","legal_matters"],"activation_ages":[6,18,30,42,54,66,78]},"10":{"themes":["career","reputation","public_status","authority","government","fame"],"traditional_meaning":"House 10 governs career, reputation, public_status","life_areas":["career_success","public_recognition","professional_achievements"],"activation_ages":[9,21,33,45,57,69,81]}},"profection_system":{"method":"Annual Profection","calculation":"Age mod 12 determines activated house","ruler":"Traditional ruler of activated sign becomes Lord of Year","cycle_length":"12 years per complete cycle","sources":["Valens","Abu Ma'shar","Bonatti"]},"examples":[{"age":25,"calculation":"25 mod 12 = 1, +1 = 2nd house","house":2,"themes":["money","possessions","resources"],"interpretation":"Year focused on financial matters and material security"},{"age":30,"calculation":"30 mod 12 = 6, +1 = 7th house","house":7,"themes":["partnerships","marriage","contracts"],"interpretation":"Year emphasized relationships and partnerships"}]}},"house_themes_focus":{"summary":"House Themes and Traditional Meanings","description":"Focus on traditional house meanings and life themes","value":{"houses":{"1":{"themes":["self","identity","appearance","vitality"],"traditional_meaning":"The native, their body, health, and general approach to life","hellenistic_significance":"The Helm - steering wheel of the chart","profection_emphasis":"Years of new beginnings and self-focus"},"4":{"themes":["home","family","roots","land","father"],"traditional_meaning":"Foundation, family origins, real estate, and paternal influences","hellenistic_significance":"The Subterranean - hidden foundations","profection_emphasis":"Years of establishing security and roots"},"7":{"themes":["marriage","partnerships","open_enemies","lawsuits"],"traditional_meaning":"Marriage partner, business partnerships, open conflicts","hellenistic_significance":"The Setting - where things culminate","profection_emphasis":"Years of relationship focus and partnerships"},"10":{"themes":["career","reputation","mother","public_status"],"traditional_meaning":"Public reputation, career achievements, maternal influences","hellenistic_significance":"The Culminating - highest point of achievement","profection_emphasis":"Years of career advancement and recognition"}},"profection_system":{"calculation_method":"Current age mod 12 + 1 = activated house","cycle_pattern":"Each 12-year cycle repeats the same house sequence","lord_of_year":"Traditional ruler of the sign on activated house cusp","timing_principle":"Activated house themes become prominent for that year"}}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/traditional/glossary/profection-houses\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/glossary/profection-houses\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/glossary/profection-houses\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/glossary/profection-houses\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/glossary/profection-houses\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/capabilities":{"get":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Traditional Capabilities","description":"🔍 **Traditional Astrology Capabilities**\n\nOverview of all traditional astrology features, techniques, and data sources\nsupported by this API version.\n\n**Returns:**\n- Supported traditional techniques\n- Available traditional points\n- Dignity systems implemented\n- Calculation methods used\n- Historical sources referenced","operationId":"get_traditional_capabilities_api_v3_traditional_capabilities_get","responses":{"200":{"description":"Traditional Astrology Features and Capabilities Overview","content":{"application/json":{"schema":{},"examples":{"complete_capabilities":{"summary":"Complete Traditional Astrology Capabilities","description":"All supported traditional techniques, points, and calculation methods","value":{"supported_techniques":["Essential Dignities & Debilities","Annual Profections","Arabic Parts/Lots","Sect Analysis (Day/Night)","Mutual Receptions","Dispositor Chains","Planetary Conditions (Combustion, Cazimi)","Houses of Joy","Fixed Star Conjunctions","Traditional Aspect Analysis"],"supported_points":["Part_of_Fortune","Part_of_Spirit","Part_of_Love","Part_of_Necessity","Part_of_Courage","True_Lilith"],"dignity_systems":["Traditional Domicile Rulers","Classical Exaltations","Sect-based Triplicities","Egyptian Terms (Ptolemaic)","Chaldean Decans"],"calculation_methods":{"dignities":"Traditional Hellenistic methods","profections":"Age mod 12 house activation","arabic_parts":"Day/night formula variations","sect":"Sun above/below horizon","orbs":"Traditional 2-degree major aspects"},"data_sources":["Claudius Ptolemy - Tetrabiblos","Vettius Valens - Anthologies","Abu Ma'shar - Great Introduction","Guido Bonatti - Book of Astronomy","William Lilly - Christian Astrology"]}},"technique_focus":{"summary":"Core Traditional Techniques","description":"Focus on the most important traditional astrology methods","value":{"essential_techniques":["Essential Dignities & Debilities","Annual Profections","Arabic Parts/Lots","Sect Analysis"],"dignity_analysis":{"dignities":["domicile","exaltation","triplicity","term","decan"],"debilities":["exile","fall"],"special_conditions":["combustion","cazimi","under_beams"],"sect_considerations":"Day/night chart planetary preferences"},"timing_methods":{"annual_profections":"12-year house activation cycles","planetary_periods":"Ruler-based sub-periods","monthly_profections":"Monthly house activation within the year","solar_returns":"Annual chart interpretation"},"calculation_precision":{"ephemeris":"Swiss Ephemeris for maximum accuracy","coordinate_precision":"Up to 6 decimal places","time_zone_handling":"Automatic UTC conversion with historical adjustments","house_systems":"Traditional whole sign and quadrant systems"}}},"historical_context":{"summary":"Historical Sources and Context","description":"Traditional astrology sources and historical development","value":{"historical_periods":{"hellenistic":{"period":"1st-7th centuries CE","key_figures":["Ptolemy","Vettius Valens","Firmicus Maternus"],"innovations":["Essential dignities","Sect theory","Annual profections"],"geographical_center":"Alexandria, Egypt"},"islamic_golden_age":{"period":"8th-13th centuries CE","key_figures":["Abu Ma'shar","Al-Biruni","Omar Khayyam"],"innovations":["Arabic Parts expansion","Fixed star catalogs","Electional methods"],"geographical_center":"Baghdad, Cordoba, Cairo"},"medieval_latin":{"period":"12th-15th centuries CE","key_figures":["Guido Bonatti","John of Seville","William of Moerbeke"],"innovations":["Synthesis of traditions","Practical applications","Medical astrology"],"geographical_center":"Paris, Bologna, Oxford"}},"modern_revival":{"project_hindsight":"1990s translation project","key_translators":["Robert Schmidt","Robert Hand","James Holden"],"impact":"Return to source texts and authentic methods"},"supported_languages":["en","fr","pt","it","zh","es","ru","tr","de","hi","uk","ar","en-US","en-GB","en-ARCHAIC","pt-BR","pt-PT","es-MX","es-ES","fr-FR","fr-CA","zh-CN","zh-TW"],"cultural_adaptations":"Methods adapted for modern use while preserving authenticity"}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/traditional/capabilities\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/capabilities\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/capabilities\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/capabilities\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/capabilities\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/dignities":{"post":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Dignities Analysis","description":"🏛️ **Essential Dignities Analysis** - Complete traditional dignity assessment\n\n**Perfect for:**\n- 👑 Essential dignity evaluation (domicile, exaltation, fall, detriment)\n- 🎯 Planetary strength assessment\n- 📚 Traditional astrology practice\n- 🎓 Academic astrological research\n\n**What you get:**\n- **Dignity Scores** - Numerical strength ratings for each planet\n- **Dignity Conditions** - Domicile, exaltation, fall, detriment status\n- **Sect Analysis** - Day/night chart considerations\n- **Mutual Receptions** - Planets in each other's signs\n- **Special Conditions** - Combustion, cazimi, under beams\n\n**Traditional Systems:**\n- Ptolemaic essential dignities\n- Sect-based triplicity rulers\n- Egyptian terms and bounds\n- Chaldean face rulers\n\n**Response time:** ~200ms | **Accuracy:** Traditional Hellenistic methods","operationId":"get_dignities_analysis_api_v3_traditional_dignities_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraditionalAnalysisRequest"},"examples":{"dignity_analysis":{"summary":"Complete Dignity Analysis","description":"Essential dignities analysis for birth chart with all planetary conditions","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"include_asteroids":false,"include_fixed_stars":true,"dignity_system":"traditional"}}}}}},"required":true},"responses":{"200":{"description":"Essential Dignities Analysis Result","content":{"application/json":{"schema":{},"examples":{"dignified_chart":{"summary":"Chart with Strong Dignities","description":"Analysis showing planets in dignified positions","value":{"dignities":{"Sun":{"domicile":false,"exaltation":false,"triplicity":{"is_ruler":true,"type":"day"},"term":"Jupiter","decan":"Saturn","exile":false,"fall":false},"Moon":{"domicile":true,"exaltation":false,"triplicity":{"is_ruler":false},"term":"Venus","decan":"Venus","exile":false,"fall":false},"Jupiter":{"domicile":true,"exaltation":false,"triplicity":{"is_ruler":true,"type":"night"},"term":"Jupiter","decan":"Jupiter","exile":false,"fall":false}},"planetary_conditions":{"Mercury":{"combust":true,"cazimi":false,"under_beams":true,"distance_from_sun":4.5},"Venus":{"combust":false,"cazimi":false,"under_beams":false}},"sect_analysis":{"chart_sect":"day","sect_light":"Sun","benefic_in_sect":"Jupiter","malefic_in_sect":"Saturn","benefic_out_of_sect":"Venus","malefic_out_of_sect":"Mars"},"mutual_receptions":[{"planet1":"Venus","planet2":"Mars","type":"domicile","strength":"strong"}],"dignity_scores":{"Sun":3.5,"Moon":5.0,"Mercury":-2.0,"Venus":4.0,"Mars":2.5,"Jupiter":7.0,"Saturn":1.0}}},"debilitated_chart":{"summary":"Chart with Debilitated Planets","description":"Analysis showing planets in exile or fall","value":{"dignities":{"Saturn":{"domicile":false,"exaltation":false,"triplicity":{"is_ruler":false},"term":"Mars","decan":"Mars","exile":false,"fall":true},"Mars":{"domicile":false,"exaltation":false,"triplicity":{"is_ruler":false},"term":"Venus","decan":"Moon","exile":true,"fall":false}},"planetary_conditions":{"Mercury":{"combust":false,"cazimi":false,"under_beams":false}},"sect_analysis":{"chart_sect":"night","sect_light":"Moon","benefic_in_sect":"Venus","malefic_in_sect":"Mars"},"mutual_receptions":[],"dignity_scores":{"Sun":2.0,"Moon":3.0,"Mercury":1.5,"Venus":2.0,"Mars":-4.0,"Jupiter":0.5,"Saturn":-3.0}}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/traditional/dignities\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/dignities\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/dignities\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/dignities\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/dignities\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/lots":{"post":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Lots Analysis","description":"🌙 **Arabic Parts/Lots Analysis** - Traditional Arabian astrological points\n\n**Perfect for:**\n- 🔮 Arabic Parts calculations (Part of Fortune, Spirit, etc.)\n- 📊 Lot-based predictions and analysis\n- 🏛️ Traditional Hellenistic astrology practice\n- 📚 Academic research on medieval astrology\n\n**What you get:**\n- **Major Lots** - Part of Fortune, Spirit, Love, Victory\n- **Positional Data** - Exact degrees, signs, and houses for each lot\n- **Sect Considerations** - Day/night formula variations\n- **Interpretation Keys** - Traditional meanings and applications\n- **Arabic Sources** - Historical context and calculation methods\n\n**Available Lots:**\n- Part of Fortune (Pars Fortunae)\n- Part of Spirit (Pars Spirituum)\n- Part of Love (Pars Veneris)\n- Part of Necessity (Pars Necessitatis)\n- Part of Courage (Pars Martis)\n\n**Response time:** ~150ms | **Accuracy:** Traditional medieval formulas","operationId":"get_lots_analysis_api_v3_traditional_lots_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraditionalAnalysisRequest"},"examples":{"lots_calculation":{"summary":"Arabic Parts/Lots Calculation","description":"Complete calculation of traditional Arabic Parts for natal chart","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"include_major_lots":true,"include_minor_lots":false,"sect_aware":true}}}}}},"required":true},"responses":{"200":{"description":"Arabic Parts/Lots Analysis Result","content":{"application/json":{"schema":{},"examples":{"major_lots":{"summary":"Major Arabic Parts Analysis","description":"Part of Fortune, Spirit, and other major lots","value":{"arabic_parts":{"Part_of_Fortune":{"longitude":127.45,"sign":"Leo","degree_in_sign":7.45,"house":5,"formula":"Ascendant + Moon - Sun"},"Part_of_Spirit":{"longitude":89.23,"sign":"Gem","degree_in_sign":29.23,"house":3,"formula":"Ascendant + Sun - Moon"},"Part_of_Love":{"longitude":234.67,"sign":"Sco","degree_in_sign":24.67,"house":8,"formula":"Ascendant + Venus - Sun"}},"major_lots":{"fortune":{"sign":"Leo","house":5,"ruler":"Sun","condition":"dignified"},"spirit":{"sign":"Gem","house":3,"ruler":"Mercury","condition":"peregrine"}},"lot_positions":[{"name":"Part_of_Fortune","longitude":127.45,"sign":"Leo","house":5},{"name":"Part_of_Spirit","longitude":89.23,"sign":"Gem","house":3}],"sect_based_formulas":{"chart_sect":"day","fortune_formula":"Asc + Moon - Sun","spirit_formula":"Asc + Sun - Moon","note":"Day chart uses standard formulas"},"traditional_meanings":{"Part_of_Fortune":"Material fortune, bodily health, wealth","Part_of_Spirit":"Spiritual fortune, reputation, soul","Part_of_Love":"Romantic relationships, attraction"}}},"night_chart_lots":{"summary":"Night Chart Arabic Parts","description":"Lots calculated with reversed sect formulas","value":{"arabic_parts":{"Part_of_Fortune":{"longitude":245.12,"sign":"Sag","degree_in_sign":5.12,"house":9,"formula":"Ascendant + Sun - Moon (night)"},"Part_of_Spirit":{"longitude":167.89,"sign":"Vir","degree_in_sign":17.89,"house":6,"formula":"Ascendant + Moon - Sun (night)"}},"major_lots":{"fortune":{"sign":"Sag","house":9,"ruler":"Jupiter","condition":"domicile"},"spirit":{"sign":"Vir","house":6,"ruler":"Mercury","condition":"domicile"}},"lot_positions":[],"sect_based_formulas":{"chart_sect":"night","fortune_formula":"Asc + Sun - Moon","spirit_formula":"Asc + Moon - Sun","note":"Night chart reverses Fortune/Spirit formulas"},"traditional_meanings":{"Part_of_Fortune":"Material fortune, bodily health, wealth","Part_of_Spirit":"Spiritual fortune, reputation, soul"}}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/traditional/lots\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/lots\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/lots\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/lots\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/lots\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/traditional/profections":{"post":{"tags":["🏛️ Traditional & Hellenistic Astrology"],"summary":"Get Profections Analysis","description":"⏰ **Annual Profections Analysis** - Traditional timing technique\n\n**Perfect for:**\n- 📅 Annual timing and life cycle analysis\n- 🎯 Current year themes and challenges\n- 📈 Multi-year planning and prediction\n- 🏛️ Traditional Hellenistic timing methods\n\n**What you get:**\n- **Current Profection** - Active house and ruling planet for current age\n- **Timeline View** - Past and future profection years\n- **Lord of the Year** - Current planetary ruler and its conditions\n- **House Themes** - Life areas activated by current profection\n- **Planetary Periods** - Sub-periods within the profection year\n\n**Traditional Method:**\n- Age mod 12 house activation\n- Sign-based planetary rulers\n- Hellenistic timing principles\n- Multi-level period analysis\n\n**Response time:** ~180ms | **Accuracy:** Classical profection methods","operationId":"get_profections_analysis_api_v3_traditional_profections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraditionalAnalysisRequest"},"examples":{"profections_analysis":{"summary":"General Profections Analysis","description":"Multi-year profections analysis with timeline and current activation","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"years_ahead":5,"include_timeline":true,"current_year_focus":true}}}}}},"required":true},"responses":{"200":{"description":"Annual Profections Analysis Result","content":{"application/json":{"schema":{},"examples":{"current_profection":{"summary":"Current Year Profection Analysis","description":"Shows current profection with Lord of the Year","value":{"current_profection":{"age":39,"profected_house":4,"profected_sign":"Can","traditional_ruler":"Moon","house_themes":["home","family","roots","foundations","real_estate"]},"profection_timeline":[{"age":39,"profected_house":4,"profected_sign":"Can","traditional_ruler":"Moon"},{"age":40,"profected_house":5,"profected_sign":"Leo","traditional_ruler":"Sun"},{"age":41,"profected_house":6,"profected_sign":"Vir","traditional_ruler":"Mercury"}],"lord_of_year":{"planet":"Moon","natal_sign":"Sco","natal_house":8,"condition":"peregrine","aspects_to_profected":["trine from Jupiter"]},"activated_house":{"house_number":4,"sign_on_cusp":"Can","planets_in_house":["Mars"],"themes":["home","family","foundations"]},"planetary_periods":[{"period":"Moon period","duration":"Full year","emphasis":"Domestic matters, emotional security"}]}},"career_year_profection":{"summary":"10th House Profection Year","description":"Career-focused profection analysis","value":{"current_profection":{"age":33,"profected_house":10,"profected_sign":"Cap","traditional_ruler":"Saturn","house_themes":["career","reputation","public_status","authority","achievement"]},"profection_timeline":[{"age":33,"profected_house":10,"profected_sign":"Cap","traditional_ruler":"Saturn"},{"age":34,"profected_house":11,"profected_sign":"Aqu","traditional_ruler":"Saturn"},{"age":35,"profected_house":12,"profected_sign":"Pis","traditional_ruler":"Jupiter"}],"lord_of_year":{"planet":"Saturn","natal_sign":"Sco","natal_house":8,"condition":"peregrine","aspects_to_profected":[]},"activated_house":{"house_number":10,"sign_on_cusp":"Cap","planets_in_house":[],"themes":["career","reputation","achievement"]},"planetary_periods":[{"period":"Saturn period","duration":"Full year","emphasis":"Career structure, long-term goals, discipline"}]}}}}}},"400":{"description":"Invalid traditional astrology parameters"},"422":{"description":"Validation error - check traditional options"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/traditional/profections\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/traditional/profections\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/traditional/profections\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/traditional/profections\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/traditional/profections\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horary/glossary/considerations":{"get":{"tags":["🔮 Horary Astrology"],"summary":"Get Considerations Glossary","description":"📚 **Horary Considerations Reference** - The 8 traditional tests of chart radicality\n\n**Perfect for:**\n- 🎓 Learning traditional horary astrology\n- 🔍 Understanding chart radicality (fitness for judgment)\n- 📖 Reference for William Lilly's considerations before judgment\n- 🎯 Educational applications and horary study\n\n**What you get:**\n- **All 8 Considerations** - Complete list with traditional meanings\n- **Thresholds** - Exact criteria for each consideration\n- **Severity Levels** - Importance weighting (low/medium/high)\n- **Practical Descriptions** - Clear explanations of each consideration\n- **Historical Context** - Based on William Lilly's \"Christian Astrology\"\n\n**The 8 Considerations:**\n1. **Early Ascendant** (< 3°) - Question premature, not fully understood\n2. **Late Ascendant** (> 27°) - Question too late, outcome decided\n3. **Moon Void of Course** - Nothing will come of the matter\n4. **Saturn in 1st House** - Querent fear or anxiety\n5. **Saturn in 7th House** - Astrologer uncertainty\n6. **Moon in Via Combusta** - Unfortunate outcomes\n7. **Ascendant in Via Combusta** - Chart difficult to judge\n8. **Lord of Ascendant Combust** - Querent's judgment clouded\n\n**Usage:**\nUse this endpoint to understand what makes a horary chart \"radical\" (fit to be judged).\nCharts with multiple considerations present should be judged with extra caution or not at all.\n\n**Response time:** < 10ms | **Content:** Complete considerations reference data","operationId":"get_considerations_glossary_api_v3_horary_glossary_considerations_get","responses":{"200":{"description":"Comprehensive reference for the 8 traditional considerations before judgment","content":{"application/json":{"schema":{},"examples":{"all_considerations":{"summary":"All 8 Considerations","description":"Complete list of traditional radicality considerations from William Lilly","value":{"considerations":[{"name":"early_ascendant","display_name":"Early Ascendant","traditional_meaning":"Question is premature or not yet fully formed","threshold":"Less than 3° of sign","severity":"medium","weight":15,"description":"Ascendant in early degrees of sign (question premature)"},{"name":"late_ascendant","display_name":"Late Ascendant","traditional_meaning":"Question comes too late, outcome already decided","threshold":"Greater than 27° of sign","severity":"medium","weight":15,"description":"Ascendant in late degrees of sign (question too late)"},{"name":"moon_void_of_course","display_name":"Moon Void of Course","traditional_meaning":"Nothing will come of the matter","threshold":"Moon makes no aspects before leaving sign","severity":"high","weight":20,"exception":"Less severe in Cancer, Taurus, Sagittarius, Pisces","description":"Moon void of course (nothing will come of the matter)"}],"total":8,"source":"William Lilly's 'Christian Astrology' and classical horary texts"}}}}}},"400":{"description":"Invalid horary parameters"},"422":{"description":"Validation error - check question format"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/horary/glossary/considerations\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horary/glossary/considerations\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horary/glossary/considerations\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horary/glossary/considerations\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horary/glossary/considerations\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horary/glossary/categories":{"get":{"tags":["🔮 Horary Astrology"],"summary":"Get Categories Glossary","description":"🎯 **Horary Question Categories Reference** - Complete guide to matters and questions\n\n**Traditional Terminology:**\n- **category** = \"Matter\" (lat. *materia*) — the subject matter of the question\n- **subcategory** = \"Question\" (lat. *quaestio*) — the specific question being asked\n\nBased on William Lilly's \"Christian Astrology\" chapter organization by house matters.\n\n**Perfect for:**\n- 🎓 Learning traditional horary significator rules\n- 🔍 Understanding which planets/houses represent what\n- 📖 Reference for William Lilly's house-to-matter correspondences\n- 🎯 Educational applications and horary study\n- 🏗️ Building horary chart interpretation interfaces\n\n**What you get:**\n- **All 11 Question Categories (Matters)** - Complete significator mappings\n- **Subcategories (Questions)** - Specific question types within each matter\n- **House Assignments** - Which houses govern each matter\n- **Natural Significators** - Planets with inherent meaning for each topic\n- **Detailed Explanations** - Traditional reasoning behind each assignment\n- **Lord Notation** - Understanding L1, L5, L7, L10 etc. (house lords)\n\n**Understanding Significators:**\nIn horary astrology, significators are the planets that represent the people,\nthings, or matters involved in the question. There are two types:\n\n1. **House Lords (L1, L5, L7, etc.)** - The planet ruling the sign on a house cusp\n - L1 = Lord of Ascendant (querent, the person asking)\n - L5 = Lord of 5th House (children, pregnancy, creativity)\n - L7 = Lord of 7th House (partners, relationships, opponents)\n - L10 = Lord of 10th House (career, reputation, authority)\n\n2. **Natural Significators** - Planets with inherent meaning\n - Moon: Fertility, body, emotions, change\n - Venus: Love, beauty, harmony, desire\n - Jupiter: Growth, expansion, wealth, success\n - Sun: Authority, vitality, success, recognition\n\n**Question Categories:**\n- **Pregnancy/Fertility** - 5th house, Moon, Jupiter\n- **Love** - 7th house, Venus\n- **Marriage** - 7th house, Venus\n- **Career** - 10th house, Sun\n- **Job** - 6th house\n- **Money** - 2nd house, Jupiter\n- **Health** - 6th house, Moon\n- **Missing Item** - 2nd & 4th houses, Moon\n- **Travel** - 9th house, Jupiter\n- **General** - 1st house, Moon\n\n**Traditional Rulerships (Used for House Lords):**\n- Aries & Scorpio: Mars\n- Taurus & Libra: Venus\n- Gemini & Virgo: Mercury\n- Cancer: Moon\n- Leo: Sun\n- Sagittarius & Pisces: Jupiter\n- Capricorn & Aquarius: Saturn\n\nNote: Horary uses traditional (pre-modern) rulerships only.\nNo Uranus, Neptune, or Pluto.\n\n**Response time:** < 10ms | **Content:** Complete significator reference for all categories","operationId":"get_categories_glossary_api_v3_horary_glossary_categories_get","parameters":[{"name":"language","in":"query","required":false,"schema":{"type":"string","description":"Language code for significator meanings (en, ru, de, fr, es, etc.)","default":"en","title":"Language"},"description":"Language code for significator meanings (en, ru, de, fr, es, etc.)"}],"responses":{"200":{"description":"Complete reference of horary question categories, subcategories, and significators","content":{"application/json":{"schema":{},"examples":{"all_significators":{"summary":"All Question Categories","description":"Complete reference showing significators for each question category","value":{"categories":[{"category":"pregnancy","display_name":"Pregnancy & Conception","houses":[5],"house_names":["5th House of Children"],"significators":["L5","Moon","Jupiter"],"significator_meanings":{"L5":"Lord of 5th House (planet ruling sign on 5th cusp)","Moon":"Natural significator for fertility and conception","Jupiter":"Natural significator for growth and expansion"},"description":"5th house of children, Moon for fertility, Jupiter for growth"},{"category":"love","display_name":"Love & Romance","houses":[7],"house_names":["7th House of Relationships"],"significators":["L7","Venus"],"significator_meanings":{"L7":"Lord of 7th House (planet ruling sign on 7th cusp)","Venus":"Natural significator for love and affection"},"description":"7th house of relationships, Venus for love"},{"category":"career","display_name":"Career & Profession","houses":[10],"house_names":["10th House of Career"],"significators":["L10","Sun"],"significator_meanings":{"L10":"Lord of 10th House (planet ruling sign on 10th cusp)","Sun":"Natural significator for success and recognition"},"description":"10th house of career, Sun for success"}],"total":11}},"pregnancy_example":{"summary":"Pregnancy Question Significators","description":"Detailed breakdown for pregnancy/fertility questions","value":{"categories":[{"category":"pregnancy","display_name":"Pregnancy & Conception","houses":[5],"house_names":["5th House of Children"],"significators":["L5","Moon","Jupiter"],"significator_meanings":{"L5":"Lord of 5th House (planet ruling sign on 5th cusp)","Moon":"Natural significator for fertility and conception","Jupiter":"Natural significator for growth and expansion"},"description":"5th house of children, Moon for fertility, Jupiter for growth","traditional_notes":"The 5th house represents children and pregnancy. Moon shows fertility and the body's receptivity. Jupiter expands and brings increase."}]}}}}}},"400":{"description":"Invalid horary parameters"},"422":{"description":"Validation error - check question format"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/horary/glossary/categories\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horary/glossary/categories\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horary/glossary/categories\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horary/glossary/categories\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horary/glossary/categories\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horary/chart":{"post":{"tags":["🔮 Horary Astrology"],"summary":"Generate Horary Chart","description":"🔮 **Generate Horary Chart**\n\nCalculate a complete horary chart for the moment a question was understood by the astrologer.\nUses Regiomontanus house system (traditional for horary) and includes full dignity analysis\nand Arabic Parts.\n\n**Perfect for:**\n- 🎯 Question-based divination and prediction\n- 📚 Traditional horary astrology practice\n- 🎓 Learning horary techniques\n- 📱 Building horary astrology applications\n\n**What you get:**\n- **Complete Chart Data** - Planetary positions, houses, aspects with Regiomontanus houses\n- **Essential Dignities** - Full dignity analysis for all planets (domicile, exaltation, etc.)\n- **Arabic Parts** - Part of Fortune and other relevant lots\n- **Horary-specific Calculations** - Ready for radicality checking and judgment\n\n**Traditional Method:**\n- Chart is cast for the exact moment the astrologer understood the question\n- Regiomontanus houses are used (traditional standard for horary)\n- Time accuracy is critical - use the precise moment of question comprehension\n- Location should be where the astrologer is located when understanding the question\n\n**House Systems:**\n- Default: Regiomontanus ('R') - traditional horary standard\n- Alternative: Placidus ('P'), Whole Sign ('W'), Koch ('K'), Equal ('A')\n- Note: Most traditional horary texts use Regiomontanus\n\n**Use Cases:**\n- Yes/no questions about concrete outcomes\n- Timing predictions (\"When will X happen?\")\n- Missing item recovery (\"Where is my lost ring?\")\n- Relationship questions (\"Will we get married?\")\n- Career and financial questions\n- Health inquiries\n\n**Response time:** ~200ms | **Content:** Full horary chart with dignities and Arabic Parts","operationId":"generate_horary_chart_api_v3_horary_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoraryChartRequest"},"examples":{"pregnancy_question":{"summary":"Pregnancy Question","description":"Generate horary chart for fertility question","value":{"question":"Will I get pregnant this year?","question_time":{"year":2026,"month":1,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}}},"career_question":{"summary":"Career Question","description":"Generate horary chart for job/career question","value":{"question":"Will I get the job I interviewed for?","question_time":{"year":2026,"month":2,"day":10,"hour":9,"minute":15,"second":0,"city":"New York","country_code":"US"}}},"coordinates_based":{"summary":"Using Coordinates","description":"Generate horary chart using exact coordinates","value":{"question":"Should I accept the business partnership offer?","question_time":{"year":2026,"month":3,"day":5,"hour":16,"minute":45,"second":0,"latitude":51.5074,"longitude":-0.1278}}}}}},"required":true},"responses":{"200":{"description":"Successful Horary Chart Generation","content":{"application/json":{"schema":{},"examples":{"pregnancy_question":{"summary":"Pregnancy Question Chart","description":"Horary chart for 'Will I get pregnant this year?' with Regiomontanus houses","value":{"question":"Will I get pregnant this year?","chart_data":{"subject_data":{"name":"Horary Question","year":2026,"month":1,"day":15},"house_system":"R","ascendant_sign":"Can"},"dignities":[{"planet":"Moon","sign":"Tau","domicile_ruler":"Venus","essential_dignity":"exaltation","dignity_score":4,"accidental_conditions":["angular"]}],"arabic_parts":[{"name":"Part of Fortune","sign":"Sag","degree":15.23,"absolute_longitude":255.23,"house":6}],"house_system":"R"}},"career_question":{"summary":"Career Question Chart","description":"Horary chart for 'Will I get the job I interviewed for?'","value":{"question":"Will I get the job I interviewed for?","chart_data":{"subject_data":{"name":"Horary Question","year":2026,"month":2,"day":10},"house_system":"R","ascendant_sign":"Ari"},"dignities":[{"planet":"Mars","sign":"Ari","domicile_ruler":"Mars","essential_dignity":"domicile","dignity_score":5,"accidental_conditions":["angular"]}],"arabic_parts":[{"name":"Part of Fortune","sign":"Leo","degree":22.45,"absolute_longitude":142.45,"house":5}],"house_system":"R"}},"coordinates_based":{"summary":"Coordinates-based Horary","description":"Using exact coordinates for precise calculation","value":{"question":"Should I accept the business partnership offer?","chart_data":{"subject_data":{"name":"Horary Question","year":2026,"month":3,"day":5},"house_system":"R","ascendant_sign":"Gem"},"dignities":[{"planet":"Mercury","sign":"Pis","domicile_ruler":"Jupiter","essential_dignity":"detriment","dignity_score":-5,"accidental_conditions":[]}],"arabic_parts":[{"name":"Part of Fortune","sign":"Vir","degree":8.91,"absolute_longitude":158.91,"house":4}],"house_system":"R"}}}}}},"400":{"description":"Invalid horary parameters"},"422":{"description":"Validation error - check question format"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horary/chart\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horary/chart\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horary/chart\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horary/chart\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horary/chart\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horary/fertility-analysis":{"post":{"tags":["🔮 Horary Astrology"],"summary":"Analyze Fertility Question","description":"🤰 **Fertility & Pregnancy Analysis** - Specialized horary analysis for conception questions\n\n**Perfect for:**\n- 🎯 Natural conception potential assessment\n- 🧬 IVF/ART treatment success indicators\n- ⏰ Conception timing predictions\n- 📚 Traditional horary fertility techniques\n- 💉 Medical astrology applications\n\n**What you get:**\n- **Fertility Score** - Overall indication (0-100) based on traditional factors\n- **Sign Fertility Analysis** - Fruitful/barren classification for Moon, 5th house, Jupiter, Ascendant\n- **Arabic Parts** - Part of Children (ASC + Saturn - Jupiter), Part of Pregnancy (ASC + L5 - Moon)\n- **5th House Analysis** - Detailed examination of the pregnancy/children house and its ruler\n- **Timing Windows** - Favorable conception periods based on applying aspects (if include_timing=True)\n - ⚠️ **Note**: May be empty if Moon is Void of Course (VOC) - when Moon makes no more aspects before leaving its sign, traditional horary cannot reliably predict timing\n- **Radicality Check** - Chart fitness for judgment\n- **Comprehensive Interpretation** - Plain language analysis and recommendations\n\n**Traditional Method:**\nBased on William Lilly's \"Christian Astrology\" and classical horary techniques:\n- **Moon** (35% weight) - Primary fertility significator\n- **5th House** (25% weight) - House of children and procreation\n- **5th House Ruler** (20% weight) - Condition shows potential\n- **Jupiter** (15% weight) - Natural significator of growth/expansion\n- **Ascendant** (5% weight) - Querent's overall condition\n\n**Sign Fertility Classifications:**\n- **Fruitful Signs** (Cancer, Scorpio, Pisces) - Water signs, highly supportive\n- **Semi-fruitful Signs** (Taurus, Sagittarius) - Moderately supportive\n- **Barren Signs** (Aries, Gemini, Leo, Virgo, Libra, Capricorn, Aquarius) - Less favorable\n\n**Scoring Guide:**\n- **70-100**: Favorable - Strong fertility indicators\n- **55-69**: Mixed - Some positive, some challenging factors\n- **40-54**: Mixed - Balanced factors\n- **0-39**: Challenging - Significant obstacles or delays\n\n**Customer Priority Feature**: This endpoint provides specialized fertility analysis\ncombining traditional horary techniques with modern astrological practice.\n\n**Response time:** ~200ms | **Content:** Complete fertility analysis with timing and interpretation","operationId":"analyze_fertility_question_api_v3_horary_fertility_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FertilityAnalysisRequest"},"examples":{"pregnancy_question":{"summary":"Pregnancy Question","description":"Analyze fertility potential for natural conception","value":{"question":"Will I get pregnant this year?","question_time":{"year":2026,"month":1,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"},"include_timing":true}},"ivf_question":{"summary":"IVF Success Question","description":"Analyze fertility indicators for assisted reproduction","value":{"question":"Will the IVF treatment be successful?","question_time":{"year":2026,"month":2,"day":20,"hour":10,"minute":0,"second":0,"city":"New York","country_code":"US"},"include_timing":false}},"conception_timing":{"summary":"Conception Timing","description":"When is the best time to conceive?","value":{"question":"When will I be able to conceive?","question_time":{"year":2026,"month":3,"day":10,"hour":16,"minute":15,"second":0,"latitude":40.7128,"longitude":-74.006},"include_timing":true}},"russian_language":{"summary":"Russian Language Response","description":"Fertility analysis with interpretations in Russian","value":{"question":"Забеременею ли я в этом году?","question_time":{"year":2026,"month":4,"day":5,"hour":11,"minute":30,"second":0,"city":"Moscow","country_code":"RU"},"include_timing":true,"options":{"language":"ru"}}},"german_language":{"summary":"German Language Response","description":"Fertility analysis with interpretations in German","value":{"question":"Werde ich dieses Jahr schwanger?","question_time":{"year":2026,"month":5,"day":12,"hour":14,"minute":0,"second":0,"city":"Berlin","country_code":"DE"},"include_timing":true,"options":{"language":"de"}}},"voc_moon_no_timing":{"summary":"VOC Moon - No Timing Available","description":"Chart where Moon is Void of Course (makes no more aspects before leaving sign). Traditional horary blocks timing predictions in this case as matter may not come to perfection. timing_windows will be empty array, VOC status shown in lunar_analysis.","value":{"question":"When will I conceive?","question_time":{"year":2025,"month":10,"day":11,"hour":7,"minute":43,"second":0,"city":"Kazan","country_code":"RU"},"include_timing":true,"options":{"language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful Fertility Analysis","content":{"application/json":{"schema":{},"examples":{"favorable_pregnancy":{"summary":"Favorable Pregnancy Indication","description":"Chart showing strong fertility indicators with Moon in Cancer","value":{"question":"Will I get pregnant this year?","fertility_score":78.5,"answer":"favorable","sign_fertility_analysis":{"moon":{"sign":"Can","fertility":"fruitful","weight":1.0,"importance":"primary"},"fifth_house":{"sign":"Pis","fertility":"fruitful","weight":1.0,"importance":"high"}},"arabic_parts":[{"name":"Part of Children","sign":"Tau","degree":12.5,"absolute_longitude":42.5,"house":5}],"fifth_house_analysis":{"cusp_sign":"Pis","ruler":"Jupiter","ruler_sign":"Sag","ruler_dignity":"domicile"},"interpretation":"Strong fertility indications. The chart shows highly favorable conditions for conception and pregnancy.","radicality":{"is_radical":true,"score":87.5,"recommendation":"proceed"}}},"challenging_pregnancy":{"summary":"Challenging Pregnancy Indication","description":"Chart showing difficult fertility indicators","value":{"question":"Can I conceive naturally?","fertility_score":35.0,"answer":"challenging","sign_fertility_analysis":{"moon":{"sign":"Vir","fertility":"barren","weight":-1.0,"importance":"primary"},"fifth_house":{"sign":"Gem","fertility":"barren","weight":-1.0,"importance":"high"}},"interpretation":"Challenging fertility indications. The chart shows significant obstacles or delays to conception."}},"mixed_indicators":{"summary":"Mixed Fertility Indicators","description":"Chart with both favorable and challenging factors","value":{"question":"Will the IVF treatment be successful?","fertility_score":52.0,"answer":"mixed","sign_fertility_analysis":{"moon":{"sign":"Tau","fertility":"semi_fruitful","weight":0.5,"importance":"primary"},"fifth_house":{"sign":"Leo","fertility":"barren","weight":-1.0,"importance":"high"}},"interpretation":"Mixed fertility indications. The chart shows both favorable and challenging factors."}}}}}},"400":{"description":"Invalid horary parameters"},"422":{"description":"Validation error - check question format"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horary/fertility-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horary/fertility-analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horary/fertility-analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horary/fertility-analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horary/fertility-analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horary/analyze":{"post":{"tags":["🔮 Horary Astrology"],"summary":"Analyze Horary Question","description":"🔮 **Complete Horary Analysis with Judgment**\n\nReturns full horary analysis including radicality check, significator identification,\naspect perfection analysis, reception, and final judgment (yes/no/unclear).\n\n**Traditional Terminology:**\n- **category** = \"Matter\" (lat. *materia*) — the subject matter of the question\n- **subcategory** = \"Question\" (lat. *quaestio*) — the specific question being asked\n\n**Perfect for:**\n- 🎯 Yes/no question divination\n- 📊 Traditional horary astrology practice\n- 🔍 Detailed analysis with reasoning\n- ⏱️ Optional timing predictions\n- 📚 Learning traditional techniques\n\n**What you get:**\n- **Radicality Check** - Chart fitness for judgment (8 traditional considerations)\n- **Significator Identification** - Querent, quesited, and additional planets\n- **Aspect Perfection** - Applying vs separating aspects between significators\n- **Lunar Analysis** - Moon's aspects as co-significator with degrees_to_perfection\n- **Secondary Perfection** - Translation, Collection of Light, Prohibition, Frustration\n- **Reception Analysis** - Mutual reception and dispositorship\n- **Final Judgment** - Yes/No/Unclear with confidence score and detailed reasoning\n- **Timing Predictions** - Optional timing estimates based on perfecting aspects\n\n**Note:** For comprehensive planetary aspects (all 21 planet pairs), use `/api/v3/data/aspects`\nwith the same chart time. This endpoint focuses on traditional horary testimonies.\n\n**Question Categories (required):**\nSee `GET /api/v3/horary/glossary/categories` for complete list with subcategories.\n\nMain categories: pregnancy, fertility, love, marriage, career, job, money, health, missing_item, travel, general\n\n**Traditional Methods:**\n- William Lilly's \"Christian Astrology\" principles\n- Aspect perfection as primary testimony\n- Reception strengthens weak aspects\n- Translation and collection of light\n- Prohibition and frustration checks\n\n**Response time:** ~500-800ms | **Content:** Comprehensive analysis with judgment and reasoning","operationId":"analyze_horary_question_api_v3_horary_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoraryAnalysisRequest"},"examples":{"career_question":{"summary":"Career Question","description":"Complete analysis for job/career question with judgment","value":{"question":"Will I get the job I interviewed for?","category":"career","subcategory":"get_position","question_time":{"year":2026,"month":1,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"},"include_timing":true}},"love_fidelity":{"summary":"Love - Fidelity Question","description":"Analysis for partner faithfulness question using subtype","value":{"question":"Is my partner faithful to me?","category":"love","subcategory":"fidelity","question_time":{"year":2026,"month":2,"day":14,"hour":20,"minute":0,"second":0,"city":"Paris","country_code":"FR"},"include_timing":false}},"love_marriage":{"summary":"Love - Marriage Question","description":"Analysis for marriage question","value":{"question":"Will we get married?","category":"love","subcategory":"marriage","question_time":{"year":2026,"month":3,"day":1,"hour":15,"minute":30,"second":0,"city":"Milan","country_code":"IT"},"include_timing":true}},"missing_item":{"summary":"Lost Item Question","description":"Analysis for finding a lost or missing item","value":{"question":"Where is my lost wallet?","category":"missing_item","question_time":{"year":2026,"month":3,"day":10,"hour":9,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006},"include_timing":true}},"russian_language":{"summary":"Russian Language Response","description":"Horary analysis with judgment interpretations in Russian","value":{"question":"Получу ли я эту работу?","category":"career","subcategory":"get_position","question_time":{"year":2026,"month":4,"day":20,"hour":10,"minute":0,"second":0,"city":"Moscow","country_code":"RU"},"include_timing":true,"options":{"language":"ru"}}},"german_language":{"summary":"German Language Response","description":"Horary analysis with judgment interpretations in German","value":{"question":"Werden wir heiraten?","category":"love","subcategory":"marriage","question_time":{"year":2026,"month":6,"day":15,"hour":18,"minute":30,"second":0,"city":"Vienna","country_code":"AT"},"include_timing":true,"options":{"language":"de"}}}}}},"required":true},"responses":{"200":{"description":"Successful Horary Analysis with Judgment","content":{"application/json":{"schema":{},"examples":{"career_yes":{"summary":"Career Question - Affirmative Judgment","description":"Will I get the job? Yes - applying aspect between significators","value":{"question":"Will I get the job I interviewed for?","category":"career","subcategory":"get_position","radicality":{"is_radical":true,"score":85.0,"recommendation":"proceed"},"significators":[{"role":"querent","planet":"Mars","reason":"Lord of 1st house (Ascendant ruler)","house":1},{"role":"quesited","planet":"Sun","reason":"Lord of 10th house (career)","house":10}],"judgment":{"answer":"yes","confidence":75.0,"reasoning":"Applying trine between querent's lord and quesited shows favorable outcome","key_factors":["Applying trine aspect","Both planets in essential dignity"],"testimony_score":{"positive":75.0,"negative":15.0,"neutral":10.0}},"timing":[{"time_unit":"weeks","value":3.0,"confidence":"medium","based_on":"Mars-Sun trine perfection"}]}},"love_unclear":{"summary":"Love Question - Unclear Judgment","description":"Will we get back together? Mixed testimonies","value":{"question":"Will my ex and I get back together?","category":"love","subcategory":"breakup","radicality":{"is_radical":true,"score":72.0,"recommendation":"proceed"},"significators":[{"role":"querent","planet":"Venus","reason":"Lord of 1st house","house":1},{"role":"quesited","planet":"Mars","reason":"Lord of 7th house (partnerships)","house":7}],"judgment":{"answer":"unclear","confidence":40.0,"reasoning":"Mixed testimonies with both affirmative and negative factors","key_factors":["Separating aspect (negative)","Mutual reception (positive)"],"testimony_score":{"positive":45.0,"negative":45.0,"neutral":10.0}}}},"pregnancy_favorable":{"summary":"Pregnancy Question - Favorable","description":"Pregnancy question with strong affirmative judgment","value":{"question":"Will I get pregnant this year?","category":"pregnancy","subcategory":"will_conceive","radicality":{"is_radical":true,"score":90.0,"recommendation":"proceed"},"significators":[{"role":"querent","planet":"Moon","reason":"Lord of 1st house","house":1},{"role":"quesited","planet":"Venus","reason":"Lord of 5th house (children)","house":5},{"role":"additional","planet":"Jupiter","reason":"Natural significator of growth","house":5}],"judgment":{"answer":"yes","confidence":82.0,"reasoning":"Strong affirmative testimonies from dignified planets","key_factors":["Moon exalted in Taurus","Jupiter in 5th house","Applying conjunction"],"testimony_score":{"positive":82.0,"negative":10.0,"neutral":8.0}},"timing":[{"time_unit":"months","value":6.0,"confidence":"medium","based_on":"Moon-Jupiter conjunction in fixed sign"}]}}}}}},"400":{"description":"Invalid horary parameters"},"422":{"description":"Validation error - check question format"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horary/analyze\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horary/analyze\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horary/analyze\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horary/analyze\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horary/analyze\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/fixed-stars/positions":{"post":{"tags":["⭐ Fixed Stars Analysis"],"summary":"Fixed Stars Positions","description":"🌟 **Fixed Stars Positions** - Calculate current positions of fixed stars\n\n**Perfect for:**\n- 🎯 Finding current star positions in the zodiac\n- 📊 Tracking precession over time\n- 🔭 Research and astronomical calculations\n\n**What you get:**\n- **Precise positions** - Longitude, sign, and degree\n- **Traditional names** - Historical star names and meanings\n- **Astronomical data** - Magnitude, constellation, nature\n\n**Preset options:**\n- **essential** - 10 most important stars (Royal Stars + primary)\n- **traditional** - 13 additional Hellenistic/Medieval stars\n- **behenian** - 15 magical stars with correspondences\n- **extended** - 20+ additional stars for research\n\n**Response time:** ~50-200ms depending on preset combination","operationId":"get_fixed_stars_positions_api_v3_fixed_stars_positions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FixedStarsPositionsRequest"},"examples":{"essential_positions":{"summary":"Get essential star positions","description":"Calculate positions for 10 essential fixed stars","value":{"subject":{"name":"Example","birth_data":{"year":2024,"month":3,"day":15,"hour":12,"minute":0,"city":"London","country_code":"GB"}},"fixed_stars":{"presets":["essential"]}}},"comprehensive_positions":{"summary":"All star positions","description":"Get positions for 50+ stars","value":{"subject":{"name":"Research Subject","birth_data":{"year":2024,"month":3,"day":15,"hour":12,"minute":0,"latitude":51.5074,"longitude":-0.1278,"timezone":"Europe/London"}},"fixed_stars":{"presets":["essential","traditional","extended"]}}}}}},"required":true},"responses":{"200":{"description":"Fixed star positions calculated successfully","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Fixed Stars Positions Api V3 Fixed Stars Positions Post"},"examples":{"essential_stars":{"summary":"Essential stars positions","description":"Positions of 10 essential fixed stars","value":{"configuration":{"presets_used":["essential"],"total_stars":10},"positions":[{"name":"Regulus","traditional_name":"The Heart of the Lion","constellation":"Leo","longitude":150.32,"sign":"Vir","degree":0.32,"magnitude":1.35,"nature":"Mars-Jupiter"}]}}}}}},"400":{"description":"Invalid fixed stars parameters"},"422":{"description":"Validation error - check configuration"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/fixed-stars/positions\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/positions\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/positions\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/fixed-stars/positions\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/fixed-stars/positions\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/fixed-stars/conjunctions":{"post":{"tags":["⭐ Fixed Stars Analysis"],"summary":"Fixed Stars Conjunctions","description":"🌟 **Fixed Stars Conjunctions** - Find planetary conjunctions to fixed stars\n\n**Perfect for:**\n- 🎯 Identifying prominent fixed star influences\n- ✨ Finding special star connections in natal charts\n- 🔮 Magical timing with Behenian stars\n- 📊 Research on star-planet combinations\n\n**What you get:**\n- **Conjunctions list** - All planets conjunct fixed stars\n- **Orb and strength** - Exact orb and influence strength\n- **Interpretations** - Traditional meanings (optional)\n- **Oppositions** - Opposition aspects (optional)\n\n**Orb defaults:**\n- **Essential preset** - 2.5° conjunction\n- **Traditional preset** - 2.0° conjunction\n- **Behenian preset** - 1.0° conjunction (tight for magic)\n- **Custom orbs** - Override with your preference\n\n**Response time:** ~100-300ms depending on stars checked","operationId":"get_fixed_stars_conjunctions_api_v3_fixed_stars_conjunctions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FixedStarsConjunctionsRequest"},"examples":{"essential_conjunctions":{"summary":"Essential stars conjunctions","description":"Check conjunctions with 10 essential stars","value":{"subject":{"name":"Example Person","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"London","country_code":"GB"}},"fixed_stars":{"presets":["essential"],"custom_orbs":{"conjunction":2.0}}}},"magical_timing":{"summary":"Behenian stars for magic","description":"Find conjunctions with magical Behenian stars","value":{"subject":{"name":"Magical Timing","birth_data":{"year":2024,"month":3,"day":15,"hour":3,"minute":0,"latitude":51.5074,"longitude":-0.1278,"timezone":"Europe/London"}},"fixed_stars":{"presets":["behenian"],"custom_orbs":{"conjunction":1.0},"include_interpretations":true},"include_oppositions":false}}}}},"required":true},"responses":{"200":{"description":"Fixed star conjunctions calculated successfully","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Fixed Stars Conjunctions Api V3 Fixed Stars Conjunctions Post"},"examples":{"natal_conjunctions":{"summary":"Natal conjunctions to fixed stars","description":"Find which planets conjunct fixed stars in natal chart","value":{"configuration":{"presets_used":["essential"],"total_stars_checked":10,"stars_with_aspects":3},"conjunctions":[{"planet":"Sun","star":"Regulus","orb":0.45,"strength":82.0,"interpretation":"Sun conjunct Regulus brings leadership and nobility"}],"oppositions":[]}}}}}},"400":{"description":"Invalid fixed stars parameters"},"422":{"description":"Validation error - check configuration"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/fixed-stars/conjunctions\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/conjunctions\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/conjunctions\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/fixed-stars/conjunctions\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/fixed-stars/conjunctions\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/fixed-stars/report":{"post":{"tags":["⭐ Fixed Stars Analysis"],"summary":"Fixed Stars Report","description":"📜 **Fixed Stars Report** - Comprehensive fixed stars analysis\n\n**Perfect for:**\n- 🎯 Complete fixed star assessment\n- 👑 Identifying Royal Star connections\n- 🔮 Behenian star magical timing\n- 📊 Research and detailed analysis\n\n**What you get:**\n- **Configuration summary** - Stars checked and found\n- **Conjunctions & oppositions** - All aspects with orbs\n- **Interpretations** - Traditional meanings\n- **Special features** - Royal stars, Behenian stars\n- **Summary** - Strongest influences and patterns\n\n**Optional features:**\n- **Parans** - Co-rising/culminating stars (planned)\n- **Heliacal events** - Rising/setting phenomena (planned)\n\n**Preset combinations:**\n- **[\"essential\"]** - Quick 10-star analysis\n- **[\"essential\", \"traditional\"]** - Standard 23-star report\n- **[\"behenian\"]** - Magical timing focus\n- **[\"essential\", \"traditional\", \"extended\"]** - Full 40+ star research\n\n**Response time:** ~200-500ms depending on configuration","operationId":"generate_fixed_stars_report_api_v3_fixed_stars_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FixedStarsReportRequest"},"examples":{"traditional_report":{"summary":"Traditional stars report","description":"Analysis with essential and traditional stars (23 total)","value":{"subject":{"name":"Example Person","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"fixed_stars":{"presets":["essential","traditional"],"include_interpretations":true}}},"magical_report":{"summary":"Behenian magical report","description":"Report focused on magical Behenian stars","value":{"subject":{"name":"Magical Analysis","birth_data":{"year":2000,"month":1,"day":1,"hour":0,"minute":0,"latitude":51.5074,"longitude":-0.1278,"timezone":"Europe/London"}},"fixed_stars":{"presets":["behenian"],"include_parans":true,"include_heliacal":true}}},"research_report":{"summary":"Comprehensive research report","description":"Full analysis with 40+ stars for research","value":{"subject":{"name":"Research Subject","birth_data":{"year":1990,"month":6,"day":15,"hour":12,"minute":30,"city":"New York","country_code":"US"}},"fixed_stars":{"presets":["essential","traditional","extended"],"custom_orbs":{"conjunction":1.5,"opposition":1.0},"include_interpretations":true}}}}}},"required":true},"responses":{"200":{"description":"Comprehensive fixed stars report generated","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Generate Fixed Stars Report Api V3 Fixed Stars Report Post"},"examples":{"comprehensive_report":{"summary":"Full fixed stars analysis","description":"Complete analysis with conjunctions, oppositions, and summary","value":{"configuration":{"presets_used":["essential","traditional"],"total_stars_checked":23,"stars_with_aspects":5},"summary":{"strongest_influence":{"star":"Spica","planet":"Moon","orb":0.32,"nature":"Venus-Mars"},"royal_star_contacts":2,"royal_stars":["Regulus","Antares"]},"conjunctions":[],"oppositions":[]}}}}}},"400":{"description":"Invalid fixed stars parameters"},"422":{"description":"Validation error - check configuration"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/fixed-stars/report\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/report\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/report\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/fixed-stars/report\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/fixed-stars/report\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/fixed-stars/presets":{"get":{"tags":["⭐ Fixed Stars Analysis"],"summary":"Fixed Stars Presets Info","description":"📚 **Fixed Stars Presets** - Information about available star presets\n\n**Learn about:**\n- Available preset options\n- Number of stars in each preset\n- Use cases for each preset\n- Default orbs and special features\n\n**Response time:** ~10ms","operationId":"get_presets_info_api_v3_fixed_stars_presets_get","responses":{"200":{"description":"Information about available fixed star presets","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Presets Info Api V3 Fixed Stars Presets Get"}}}},"400":{"description":"Invalid fixed stars parameters"},"422":{"description":"Validation error - check configuration"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/fixed-stars/presets\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/presets\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/fixed-stars/presets\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/fixed-stars/presets\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/fixed-stars/presets\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/cities":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Cities","description":"🌍 **City Database Search** - Find cities for astrological calculations\n\n**Perfect for:**\n- 🔍 Location autocompletion in astrology apps\n- 🌎 Browsing cities by country for chart calculations\n- 📍 Finding exact city names and country codes\n- 🎯 Location validation for birth data\n\n**Search Examples:**\n- `search=Lon` → Returns London, Long Beach, etc.\n- `country_code=GB` → All UK cities\n- `search=Par&country_code=FR` → Paris and other French cities starting with \"Par\"\n- `sort_by=name&sort_order=asc` → Alphabetical order\n- `limit=10&offset=0` → First 10 results for pagination\n\n**Use Cases:**\n- **Autocomplete**: Use `search` parameter for real-time suggestions\n- **Country Browse**: Use `country_code` to show all cities in a country\n- **Validation**: Verify city names exist before chart calculations\n- **Popular Cities**: Sort by `population` desc to show major cities first\n\n**Response includes:**\n- City name, country code, population\n- Coordinates (latitude, longitude) for calculations\n- Timezone information where available\n\n**Response time:** ~50ms | **Database:** GeoNames (15,000+ cities)","operationId":"get_cities_api_v3_glossary_cities_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string","description":"Case-insensitive search string to filter cities by name (matches from the start).","title":"Search"},"description":"Case-insensitive search string to filter cities by name (matches from the start)."},{"name":"country_code","in":"query","required":false,"schema":{"type":"string","description":"Filter cities by country using ISO 3166-1 alpha-2 code.","title":"Country Code"},"description":"Filter cities by country using ISO 3166-1 alpha-2 code."},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","description":"Field to sort by.","enum":["population","name"],"default":"population","title":"Sort By"},"description":"Field to sort by."},{"name":"sort_order","in":"query","required":false,"schema":{"type":"string","description":"Sort order.","enum":["asc","desc"],"default":"desc","title":"Sort Order"},"description":"Sort order."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of items to return.","default":100,"title":"Limit"},"description":"Number of items to return."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination.","default":0,"title":"Offset"},"description":"Offset for pagination."}],"responses":{"200":{"description":"Comprehensive city database with geographic and demographic data","content":{"application/json":{"schema":{},"examples":{"basic_search":{"summary":"Basic city search results","description":"Default search showing major cities with geographic coordinates and population data","value":{"items":[{"name":"London","country_code":"GB","latitude":51.5074,"longitude":-0.1278,"population":8982000},{"name":"Los Angeles","country_code":"US","latitude":34.0522,"longitude":-118.2437,"population":3971883},{"name":"Kyiv","country_code":"UA","latitude":50.4501,"longitude":30.5234,"population":2797553},{"name":"Berlin","country_code":"DE","latitude":52.52,"longitude":13.405,"population":3669491},{"name":"Tokyo","country_code":"JP","latitude":35.6762,"longitude":139.6503,"population":13929286}],"total":15432,"limit":100,"offset":0}},"filtered_search":{"summary":"Filtered search by country and name","description":"Search for cities starting with 'Lon' in Great Britain, sorted by population","value":{"items":[{"name":"London","country_code":"GB","latitude":51.5074,"longitude":-0.1278,"population":8982000},{"name":"Londonderry","country_code":"GB","latitude":54.9958,"longitude":-7.3074,"population":85016}],"total":2,"limit":10,"offset":0}},"ukraine_cities":{"summary":"Ukrainian cities for birth data","description":"Cities in Ukraine commonly used for astrological calculations","value":{"items":[{"name":"Kyiv","country_code":"UA","latitude":50.4501,"longitude":30.5234,"population":2797553},{"name":"Kharkiv","country_code":"UA","latitude":49.9935,"longitude":36.2304,"population":1430885},{"name":"Odesa","country_code":"UA","latitude":46.4825,"longitude":30.7233,"population":1017699},{"name":"Dnipro","country_code":"UA","latitude":48.4647,"longitude":35.0462,"population":984423}],"total":47,"limit":100,"offset":0}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/cities\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/cities\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/cities\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/cities\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/cities\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/countries":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Countries","description":"🌍 **Countries Database** - Complete reference of world countries\n\n**Perfect for:**\n- 🎯 Country code validation for location data\n- 📱 Building country selection dropdowns\n- 🌎 Geographic reference for birth data\n- 📊 Population and demographic information\n- 💱 Currency and continent data\n\n**What you get:**\n- **247 countries** with complete ISO codes\n- **Geographic data** - continent codes, capitals\n- **Demographic data** - population figures\n- **Economic data** - currency codes\n\n**Use Cases:**\n- **Validation**: Verify country codes before location lookups\n- **UI Components**: Populate country selection interfaces\n- **Regional Analysis**: Group countries by continent codes\n- **Data Enrichment**: Add country context to astrological calculations\n\n**Response time:** ~30ms | **Database:** GeoNames (247 countries)","operationId":"get_countries_api_v3_glossary_countries_get","responses":{"200":{"description":"Complete list of countries with geographic and demographic data","content":{"application/json":{"schema":{},"examples":{"sample_countries":{"summary":"Sample of available countries","description":"Representative sample showing country data format with major nations","value":{"items":[{"name":"United States","iso":"US","capital":"Washington","population":310232863,"continent":"NA","currency":"USD"},{"name":"United Kingdom","iso":"GB","capital":"London","population":62348447,"continent":"EU","currency":"GBP"},{"name":"Germany","iso":"DE","capital":"Berlin","population":81802257,"continent":"EU","currency":"EUR"},{"name":"Ukraine","iso":"UA","capital":"Kiev","population":45415596,"continent":"EU","currency":"UAH"},{"name":"India","iso":"IN","capital":"New Delhi","population":1173108018,"continent":"AS","currency":"INR"},{"name":"Japan","iso":"JP","capital":"Tokyo","population":127288000,"continent":"AS","currency":"JPY"},{"name":"Australia","iso":"AU","capital":"Canberra","population":21515754,"continent":"OC","currency":"AUD"},{"name":"Brazil","iso":"BR","capital":"Brasília","population":201103330,"continent":"SA","currency":"BRL"}],"total":247}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/countries\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/countries\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/countries\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/countries\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/countries\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/house-systems":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get House Systems","description":"Returns a dictionary of available house systems.","operationId":"get_house_systems_api_v3_glossary_house_systems_get","responses":{"200":{"description":"Complete list of available astrological house systems with descriptions","content":{"application/json":{"schema":{},"examples":{"house_systems_list":{"summary":"Available house systems","description":"Complete reference of all 23+ supported house systems with descriptions and usage notes","value":{"items":[{"id":"P","description":"Placidus - Most popular quadrant system using time proportions"},{"id":"W","description":"Whole Sign - Ancient system using entire signs as houses"},{"id":"K","description":"Koch - Birthplace system popular in Europe"},{"id":"A","description":"Equal Ascendant - 30° houses starting from Ascendant"},{"id":"R","description":"Regiomontanus - Medieval system using equator divisions"},{"id":"C","description":"Campanus - Space-based system using prime vertical"},{"id":"B","description":"Alcabitus - Arabian system using seasonal hours"},{"id":"M","description":"Morinus - Equatorial system using rational methods"},{"id":"O","description":"Porphyrius - Rational system using space divisions"},{"id":"E","description":"Equal MC - 30° houses starting from Midheaven"}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/house-systems\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/house-systems\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/house-systems\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/house-systems\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/house-systems\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/zodiac-types":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Zodiac Types","description":"Returns a dictionary of available zodiac types.","operationId":"get_zodiac_types_api_v3_glossary_zodiac_types_get","responses":{"200":{"description":"Available zodiac types for astrological calculations","content":{"application/json":{"schema":{},"examples":{"zodiac_types":{"summary":"Zodiac calculation types","description":"Tropical (Western) and Sidereal (Vedic) zodiac systems available for calculations","value":{"items":[{"id":"Tropic","description":"Tropical Zodiac (Western) - Based on Earth's seasons and equinoxes"},{"id":"Sidereal","description":"Sidereal Zodiac (Vedic) - Based on fixed star positions"}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/zodiac-types\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/zodiac-types\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/zodiac-types\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/zodiac-types\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/zodiac-types\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/active-points":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Active Points","description":"📚 **Complete Celestial Bodies Reference** - All supported points with descriptions and types\n\n**Perfect for:**\n- 🎯 Discovering all available celestial bodies\n- 📱 Building dynamic UI selectors with categories\n- 🎓 Learning about different astrological points\n- 🔍 Finding exact names for API requests\n- 🏷️ Filtering by celestial body types\n\n**Available types:**\n- **planet** - Planets including Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto\n- **lunar-node** - Mean_Node, True_Node, Mean_South_Node, True_South_Node\n- **angle** - Ascendant, Medium_Coeli, Descendant, Imum_Coeli, Vertex\n- **special-point** - Mean_Lilith, True_Lilith, Pars_Fortunae\n- **asteroid** - Chiron, Ceres, Pallas, Juno, Vesta, Aphrodite, Persephone, Artemis\n- **fixed-star** - 23 major stars including Royal Stars\n\n**Each entry includes:**\n- **id** - Exact name to use in API requests\n- **description** - Detailed astrological meaning\n- **type** - Category for filtering and grouping\n- **strength** - Relative importance (0.0-2.0, higher = more important)\n\n**Strength scale:**\n- **2.0** - Core luminaries (Sun, Moon) and Ascendant\n- **1.8** - Personal planets (Mercury, Venus, Mars) and Midheaven\n- **1.6** - Social planets (Jupiter, Saturn) and major nodes\n- **1.4** - Outer planets and healing points (Chiron)\n- **1.0-1.2** - Special points and asteroids\n- **0.8** - Most fixed stars (1.2 for Royal Stars)\n\n**Filtering examples:**\n- `?type=planet` - Get only planets\n- `?type=angle` - Get only angles (ASC, MC, DSC, IC)\n- No filter - Get all celestial bodies\n\n**🌟 Start here to explore all available celestial bodies for your calculations!**","operationId":"get_active_points_api_v3_glossary_active_points_get","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"Filter by celestial body type: planet, lunar-node, angle, special-point, asteroid, fixed-star","title":"Type"},"description":"Filter by celestial body type: planet, lunar-node, angle, special-point, asteroid, fixed-star"}],"responses":{"200":{"description":"Complete reference of all supported celestial bodies with types and strength ratings","content":{"application/json":{"schema":{},"examples":{"all_active_points":{"summary":"Complete celestial bodies reference","description":"All supported planets, angles, nodes, asteroids, and fixed stars with descriptions and types","value":{"items":[{"id":"Sun","description":"The Sun - Core identity, ego, vitality, and life purpose","type":"planet","strength":2.0},{"id":"Moon","description":"The Moon - Emotions, instincts, subconscious patterns","type":"planet","strength":2.0},{"id":"Mercury","description":"Mercury - Communication, thinking, learning, short journeys","type":"planet","strength":1.8},{"id":"Ascendant","description":"Ascendant - Rising sign, personality mask, first impressions","type":"angle","strength":2.0},{"id":"Medium_Coeli","description":"Medium Coeli (Midheaven) - Career, reputation, public image","type":"angle","strength":1.8},{"id":"Mean_Node","description":"Mean North Node - Life path, karmic direction, soul's purpose","type":"lunar-node","strength":1.6},{"id":"Chiron","description":"Chiron - The wounded healer, deep healing, wisdom through pain","type":"asteroid","strength":1.4},{"id":"Regulus","description":"Regulus - Royal Star of the Lion, leadership, nobility, success","type":"fixed-star","strength":1.2},{"id":"Pars_Fortunae","description":"Part of Fortune - Material fortune, physical vitality, integration","type":"special-point","strength":1.0}]}},"planets_only":{"summary":"Planets filter example","description":"Filtering celestial bodies by type 'planet' to get only planetary bodies","value":{"items":[{"id":"Sun","description":"The Sun - Core identity, ego, vitality, and life purpose","type":"planet","strength":2.0},{"id":"Moon","description":"The Moon - Emotions, instincts, subconscious patterns","type":"planet","strength":2.0},{"id":"Mercury","description":"Mercury - Communication, thinking, learning, short journeys","type":"planet","strength":1.8},{"id":"Venus","description":"Venus - Love, beauty, values, artistic expression, relationships","type":"planet","strength":1.8},{"id":"Mars","description":"Mars - Action, energy, desire, courage, physical drive","type":"planet","strength":1.8},{"id":"Jupiter","description":"Jupiter - Expansion, wisdom, philosophy, higher learning, luck","type":"planet","strength":1.6},{"id":"Saturn","description":"Saturn - Structure, responsibility, limitations, life lessons","type":"planet","strength":1.6}]}},"angles_only":{"summary":"Angles filter example","description":"Filtering celestial bodies by type 'angle' to get chart angles only","value":{"items":[{"id":"Ascendant","description":"Ascendant - Rising sign, personality mask, first impressions","type":"angle","strength":2.0},{"id":"Medium_Coeli","description":"Medium Coeli (Midheaven) - Career, reputation, public image","type":"angle","strength":1.8},{"id":"Descendant","description":"Descendant - Partnerships, relationships, open enemies","type":"angle","strength":1.6},{"id":"Imum_Coeli","description":"Imum Coeli (IC) - Home, family, roots, emotional foundation","type":"angle","strength":1.6}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/active-points\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/active-points\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/active-points\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/active-points\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/active-points\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/active-points/primary":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Primary Active Points","description":"🌟 **Primary Active Points** - Essential celestial bodies for core astrological interpretation\n\nReturns only the most important active points with strength ≥ 1.4, representing the\nfundamental elements every astrologer uses for chart interpretation.\n\n**Perfect for:**\n- 🎯 Essential chart analysis with core elements only\n- 📱 Simplified UI for beginners focusing on primary factors\n- ⚡ Fast calculations with most impactful points\n- 🎓 Educational applications teaching fundamental astrology\n- 📊 Priority-based chart interpretation systems\n\n**Primary celestial bodies included:**\n- **All Traditional Planets** (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn)\n- **Modern Planets** (Uranus, Neptune, Pluto)\n- **Major Angles** (Ascendant, Medium_Coeli, Descendant, Imum_Coeli)\n- **Lunar Nodes** (Mean_Node, True_Node, Mean_South_Node, True_South_Node)\n- **Chiron** (The Wounded Healer)\n\n**Strength threshold:** ≥ 1.4 (excludes minor asteroids, most fixed stars, Arabic parts)\n\n**Each entry includes:**\n- **id** - Standard name for API requests\n- **description** - Detailed astrological meaning\n- **type** - Category (planet, lunar-node, angle, special-point)\n- **strength** - Importance rating (1.4-2.0 range)\n\n**Filtering examples:**\n- `?type=planet` - Get primary planets only (Sun through Pluto)\n- `?type=angle` - Get major angles only (ASC, MC, DSC, IC)\n- `?type=lunar-node` - Get lunar nodes only\n- No filter - Get all 19 primary active points\n\n**Use this when you need:**\n- Essential points for beginner-friendly interfaces\n- Core elements for fundamental chart interpretation\n- High-impact factors for quick analysis\n- Priority-based celestial body selection\n\n**🔥 Perfect starting point for essential astrological calculations!**","operationId":"get_primary_active_points_api_v3_glossary_active_points_primary_get","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"Filter by celestial body type: planet, lunar-node, angle, special-point, asteroid","title":"Type"},"description":"Filter by celestial body type: planet, lunar-node, angle, special-point, asteroid"}],"responses":{"200":{"description":"Essential celestial bodies with strength ≥ 1.4 for core astrological interpretation","content":{"application/json":{"schema":{},"examples":{"primary_active_points":{"summary":"Primary celestial bodies","description":"Essential active points with strength ≥ 1.4 for fundamental chart interpretation","value":{"items":[{"id":"Sun","description":"The Sun - Core identity, ego, vitality, and life purpose","type":"planet","strength":2.0},{"id":"Moon","description":"The Moon - Emotions, instincts, subconscious patterns","type":"planet","strength":2.0},{"id":"Ascendant","description":"Ascendant - Rising sign, personality mask, first impressions","type":"angle","strength":2.0},{"id":"Mercury","description":"Mercury - Communication, thinking, learning, short journeys","type":"planet","strength":1.8},{"id":"Venus","description":"Venus - Love, beauty, values, artistic expression, relationships","type":"planet","strength":1.8},{"id":"Mars","description":"Mars - Action, energy, desire, courage, physical drive","type":"planet","strength":1.8},{"id":"Medium_Coeli","description":"Medium Coeli (Midheaven) - Career, reputation, public image","type":"angle","strength":1.8},{"id":"Jupiter","description":"Jupiter - Expansion, wisdom, philosophy, higher learning, luck","type":"planet","strength":1.6},{"id":"Saturn","description":"Saturn - Structure, responsibility, limitations, life lessons","type":"planet","strength":1.6},{"id":"Mean_Node","description":"Mean North Node - Life path, karmic direction, soul's purpose","type":"lunar-node","strength":1.6},{"id":"Chiron","description":"Chiron - The wounded healer, deep healing, wisdom through pain","type":"asteroid","strength":1.4}]}},"primary_planets_only":{"summary":"Primary planets filter","description":"Essential planets only (excluding angles and nodes) with strength ≥ 1.4","value":{"items":[{"id":"Sun","description":"The Sun - Core identity, ego, vitality, and life purpose","type":"planet","strength":2.0},{"id":"Moon","description":"The Moon - Emotions, instincts, subconscious patterns","type":"planet","strength":2.0},{"id":"Mercury","description":"Mercury - Communication, thinking, learning, short journeys","type":"planet","strength":1.8},{"id":"Venus","description":"Venus - Love, beauty, values, artistic expression, relationships","type":"planet","strength":1.8},{"id":"Mars","description":"Mars - Action, energy, desire, courage, physical drive","type":"planet","strength":1.8},{"id":"Jupiter","description":"Jupiter - Expansion, wisdom, philosophy, higher learning, luck","type":"planet","strength":1.6},{"id":"Saturn","description":"Saturn - Structure, responsibility, limitations, life lessons","type":"planet","strength":1.6}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/active-points/primary\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/active-points/primary\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/active-points/primary\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/active-points/primary\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/active-points/primary\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/themes":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Themes","description":"Returns a list of available SVG themes.","operationId":"get_themes_api_v3_glossary_themes_get","responses":{"200":{"description":"Available SVG chart themes for visual chart generation","content":{"application/json":{"schema":{},"examples":{"svg_themes":{"summary":"Available chart themes","description":"Visual themes available for SVG chart generation with different color schemes and styles","value":{"items":[{"id":"light","description":"Light - Clean white background with dark text and colorful symbols"},{"id":"dark","description":"Dark - Dark background with light text and vibrant symbols"},{"id":"classic","description":"Classic - Traditional astrological chart styling"},{"id":"modern","description":"Modern - Contemporary design with clean lines"},{"id":"colorful","description":"Colorful - Rich color palette with enhanced visual elements"}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/themes\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/themes\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/themes\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/themes\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/themes\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/languages":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Languages","description":"Returns a list of available languages for SVG charts.","operationId":"get_languages_api_v3_glossary_languages_get","responses":{"200":{"description":"Available languages for SVG chart labels and multilingual content","content":{"application/json":{"schema":{},"examples":{"chart_languages":{"summary":"Supported languages","description":"Languages available for SVG chart generation and multilingual astrological content","value":{"items":[{"id":"en","description":"EN - English language labels and content"},{"id":"de","description":"DE - German language labels and content"},{"id":"fr","description":"FR - French language labels and content"},{"id":"es","description":"ES - Spanish language labels and content"},{"id":"it","description":"IT - Italian language labels and content"},{"id":"pt","description":"PT - Portuguese language labels and content"},{"id":"ru","description":"RU - Russian language labels and content"},{"id":"zh","description":"ZH - Chinese language labels and content"}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/languages\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/languages\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/languages\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/languages\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/languages\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/fixed-stars":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Fixed Stars","description":"Returns a detailed list of available fixed stars with their traditional meanings,\nnatures, and keywords for astrological interpretation.","operationId":"get_fixed_stars_api_v3_glossary_fixed_stars_get","responses":{"200":{"description":"Complete reference of available fixed stars with traditional meanings and natures","content":{"application/json":{"schema":{},"examples":{"fixed_stars_reference":{"summary":"Available fixed stars","description":"Traditional fixed stars with their astrological meanings, natures, and keywords for interpretation","value":{"items":[{"id":"Regulus","description":"Royal Star of the Lion, Heart of the Lion | Nature: Mars-Jupiter | Keywords: leadership, nobility, success, royal nature"},{"id":"Spica","description":"The Wheat Sheaf, Gift of Harvest | Nature: Venus-Mars | Keywords: protection, artistry, talent, spiritual gifts"},{"id":"Antares","description":"Rival of Mars, Heart of the Scorpion | Nature: Mars-Jupiter | Keywords: courage, war, conflict, intensity"},{"id":"Fomalhaut","description":"The Lonely One, Royal Star of the South | Nature: Venus-Mercury | Keywords: idealism, dreams, spirituality, solitude"},{"id":"Aldebaran","description":"The Follower, Royal Star of the East | Nature: Mars | Keywords: courage, military honors, integrity, steadfastness"},{"id":"Algol","description":"The Demon Star, Head of Medusa | Nature: Saturn-Jupiter | Keywords: transformation, danger, powerful changes"},{"id":"Sirius","description":"The Dog Star, brightest star in sky | Nature: Jupiter-Mars | Keywords: fame, honors, success, spiritual power"},{"id":"Vega","description":"The Falling Vulture, Harp Star | Nature: Venus-Mercury | Keywords: charisma, refinement, artistic ability"},{"id":"Procyon","description":"The Little Dog Star | Nature: Mercury-Mars | Keywords: activity, violence, sudden fame or loss"},{"id":"Capella","description":"The Little Goat, Driver | Nature: Mars-Mercury | Keywords: learning, research, military honors"}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/fixed-stars\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/fixed-stars\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/fixed-stars\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/fixed-stars\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/fixed-stars\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/life-areas":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Life Areas","description":"📚 **Life Areas Glossary** - Complete reference of astrological life areas\n\nReturns comprehensive information about all standardized life areas used\nthroughout the Astrology API, including their meanings, keywords, emoji,\nand planetary/house associations.\n\n**Perfect for:**\n- 🎯 Understanding available life area options for astrocartography\n- 📚 Educational content about astrological life themes\n- 🔍 API integration reference\n- 🌍 Multilingual astrological applications\n- 🎨 Building UI with emoji representations\n\n**What you get:**\n- **12 standardized life areas** with complete definitions\n- **Translated names** in your preferred language\n- **Representative emojis** for visual interfaces (💼, ❤️, 🏥, etc.)\n- **Keywords and themes** for each area\n- **Planetary associations** (primary and secondary planets)\n- **House correspondences** (traditional astrological houses)\n- **Astrocartography line preferences** (AC, MC, DS, IC)\n- **Strength weights** for relative importance scoring\n\n**Available languages:** English (en), German (de), French (fr), Spanish (es), Russian (ru)\n\n**Response time:** ~50ms | **Content:** Complete life areas reference with emojis","operationId":"get_life_areas_api_v3_glossary_life_areas_get","parameters":[{"name":"language","in":"query","required":false,"schema":{"enum":["en","de","fr","es","ru","ar","tr","hi","uk","pt","it","zh"],"type":"string","description":"Language for translations","default":"en","title":"Language"},"description":"Language for translations"}],"responses":{"200":{"description":"Complete life areas reference with multilingual support and astrological associations","content":{"application/json":{"schema":{},"examples":{"english_life_areas":{"summary":"Life areas in English","description":"Complete life areas reference with English names, emojis, and astrological associations","value":{"language":"en","total_areas":12,"life_areas":[{"id":"career_success","name":"Career & Success","description":"Professional achievement, career advancement, and public recognition","keywords":["career","profession","achievement","success","recognition","ambition"],"category":"professional","emoji":"💼","primary_planets":["Sun","Saturn","Mars"],"secondary_planets":["Jupiter","Mercury"],"primary_houses":[10,6],"secondary_houses":[2,8],"preferred_lines":["MC","AC"],"strength_weight":1.0},{"id":"love_relationships","name":"Love & Relationships","description":"Romantic partnerships, marriage, and intimate connections","keywords":["love","romance","marriage","partnership","intimacy","relationships"],"category":"social","emoji":"❤️","primary_planets":["Venus","Moon","Mars"],"secondary_planets":["Jupiter","Sun"],"primary_houses":[7,5],"secondary_houses":[8,11],"preferred_lines":["DS","AC","Venus"],"strength_weight":0.9},{"id":"health_vitality","name":"Health & Vitality","description":"Physical health, wellness, and energetic vitality","keywords":["health","wellness","vitality","energy","healing","medicine"],"category":"personal","emoji":"🌱","primary_planets":["Sun","Moon","Mars"],"secondary_planets":["Mercury","Jupiter"],"primary_houses":[6,1],"secondary_houses":[8,12],"preferred_lines":["AC","MC"],"strength_weight":0.95},{"id":"creativity_arts","name":"Creativity & Arts","description":"Artistic expression, creative pursuits, and entertainment","keywords":["creativity","art","entertainment","self-expression","pleasure","games"],"category":"personal","emoji":"🎨","primary_planets":["Venus","Moon","Neptune"],"secondary_planets":["Sun","Mercury"],"primary_houses":[5,3],"secondary_houses":[12,11],"preferred_lines":["Venus","AC","Neptune"],"strength_weight":0.8}]}},"german_life_areas":{"summary":"Life areas in German","description":"Life areas with German translations while maintaining English IDs for API consistency","value":{"language":"de","total_areas":12,"life_areas":[{"id":"career_success","name":"Karriere & Erfolg","description":"Professional achievement, career advancement, and public recognition","keywords":["career","profession","achievement","success","recognition","ambition"],"category":"professional","emoji":"💼","primary_planets":["Sun","Saturn","Mars"],"secondary_planets":["Jupiter","Mercury"],"primary_houses":[10,6],"secondary_houses":[2,8],"preferred_lines":["MC","AC"],"strength_weight":1.0},{"id":"love_relationships","name":"Liebe & Beziehungen","description":"Romantic partnerships, marriage, and intimate connections","keywords":["love","romance","marriage","partnership","intimacy","relationships"],"category":"social","emoji":"❤️","primary_planets":["Venus","Moon","Mars"],"secondary_planets":["Jupiter","Sun"],"primary_houses":[7,5],"secondary_houses":[8,11],"preferred_lines":["DS","AC","Venus"],"strength_weight":0.9}]}},"russian_life_areas":{"summary":"Life areas in Russian","description":"Life areas with Russian translations demonstrating multilingual support","value":{"language":"ru","total_areas":12,"life_areas":[{"id":"career_success","name":"Карьера и Успех","description":"Professional achievement, career advancement, and public recognition","keywords":["career","profession","achievement","success","recognition","ambition"],"category":"professional","emoji":"💼","primary_planets":["Sun","Saturn","Mars"],"secondary_planets":["Jupiter","Mercury"],"primary_houses":[10,6],"secondary_houses":[2,8],"preferred_lines":["MC","AC"],"strength_weight":1.0}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/life-areas\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/life-areas\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/life-areas\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/life-areas\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/life-areas\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/keywords":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Astrological Keywords","description":"🔤 **Astrological Keywords Glossary** - Complete keyword reference\n\nReturns comprehensive keyword collections for different astrological concepts.\nThese keywords are used throughout the API for interpretations and descriptions.\n\n**Perfect for:**\n- 🎯 Understanding keyword meanings and associations\n- 📚 Building astrological interpretation systems\n- 🔍 API integration and content generation\n- 🎨 Creating astrological content and descriptions\n\n**Available categories:**\n- **planets** - Keywords for Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto\n- **lines** - Keywords for astrocartography lines (AC, MC, DS, IC)\n- **houses** - Keywords for the 12 astrological houses\n- **aspects** - Keywords for planetary aspects (conjunction, opposition, trine, etc.)\n- **themes** - Thematic keyword collections (success, love, health, etc.)\n\n**Response time:** ~30ms | **Content:** Complete keyword collections","operationId":"get_astrological_keywords_api_v3_glossary_keywords_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","description":"Keyword category: planets, lines, houses, aspects, themes","default":"planets","title":"Category"},"description":"Keyword category: planets, lines, houses, aspects, themes"}],"responses":{"200":{"description":"Comprehensive astrological keywords organized by category with concept-specific collections","content":{"application/json":{"schema":{},"examples":{"planets_keywords":{"summary":"Planetary keywords","description":"Keywords for planets used in interpretations and descriptions throughout the API","value":{"category":"planets","total_concepts":10,"keywords":[{"id":"Sun","name":"Sun","keywords":["identity","ego","vitality","consciousness","father","authority","creativity","leadership","pride","confidence"],"total_keywords":10},{"id":"Moon","name":"Moon","keywords":["emotions","instincts","subconscious","mother","nurturing","intuition","memory","habits","home","comfort"],"total_keywords":10},{"id":"Mercury","name":"Mercury","keywords":["communication","thinking","learning","writing","travel","adaptability","curiosity","logic","analysis","commerce"],"total_keywords":10},{"id":"Venus","name":"Venus","keywords":["love","beauty","harmony","relationships","art","pleasure","values","attraction","diplomacy","luxury"],"total_keywords":10},{"id":"Mars","name":"Mars","keywords":["action","energy","desire","courage","war","competition","passion","anger","sports","drive"],"total_keywords":10}]}},"houses_keywords":{"summary":"House keywords","description":"Keywords for the 12 astrological houses with traditional and modern meanings","value":{"category":"houses","total_concepts":12,"keywords":[{"id":"1","name":"1","keywords":["identity","appearance","personality","first impressions","independence","new beginnings","self-image","physical body","initiative"],"total_keywords":9},{"id":"7","name":"7","keywords":["partnerships","marriage","relationships","cooperation","open enemies","contracts","balance","others","projection"],"total_keywords":9},{"id":"10","name":"10","keywords":["career","reputation","public image","authority","achievement","status","recognition","ambition","legacy"],"total_keywords":9}]}},"lines_keywords":{"summary":"Astrocartography lines keywords","description":"Keywords for astrocartography lines (AC, MC, DS, IC) used in location analysis","value":{"category":"lines","total_concepts":4,"keywords":[{"id":"AC","name":"AC","keywords":["identity","self-expression","new beginnings","personal energy","first impressions","independence","leadership"],"total_keywords":7},{"id":"MC","name":"MC","keywords":["career","reputation","public recognition","achievement","authority","status","professional success"],"total_keywords":7},{"id":"DS","name":"DS","keywords":["partnerships","relationships","cooperation","balance","others","marriage","open enemies"],"total_keywords":7},{"id":"IC","name":"IC","keywords":["home","family","roots","emotional foundation","private life","endings","ancestry"],"total_keywords":7}]}},"aspects_keywords":{"summary":"Aspect keywords","description":"Keywords for planetary aspects describing their energetic qualities","value":{"category":"aspects","total_concepts":6,"keywords":[{"id":"conjunction","name":"Conjunction","keywords":["unity","fusion","intensity","new beginnings","focus","concentration","synthesis"],"total_keywords":7},{"id":"opposition","name":"Opposition","keywords":["polarity","tension","awareness","projection","balance","culmination","relationships"],"total_keywords":7},{"id":"trine","name":"Trine","keywords":["harmony","flow","ease","talent","natural ability","good fortune","creativity"],"total_keywords":7},{"id":"square","name":"Square","keywords":["challenge","tension","growth","dynamic energy","action","crisis","development"],"total_keywords":7}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/keywords\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/keywords\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/keywords\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/keywords\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/keywords\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/houses":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Houses Glossary","description":"🏠 **Houses Glossary** - Complete astrological houses reference\n\nReturns comprehensive information about the 12 astrological houses,\ntheir traditional meanings, themes, and associated life areas.\n\n**Perfect for:**\n- 📚 Learning traditional house meanings\n- 🎯 Understanding house themes and keywords\n- 📱 Building house interpretation features\n- 🎓 Educational astrology applications\n\n**What you get:**\n- **Traditional themes** for each house (1-12)\n- **Life area associations** based on standardized data\n- **Modern keywords** and interpretations\n- **House system information** and alternatives\n- **Usage recommendations** for different systems\n\n**Available house systems:**\n- **P** - Placidus (Default, most common)\n- **W** - Whole Sign (Ancient, gaining popularity)\n- **K** - Koch (Popular in Europe)\n- **A** - Equal Ascendant (30° houses from ASC)\n- **R** - Regiomontanus (Medieval, horary)\n- **C** - Campanus (Space-based)\n- And 17 more specialized systems\n\n**Response time:** ~30ms | **Content:** Complete houses reference","operationId":"get_houses_glossary_api_v3_glossary_houses_get","parameters":[{"name":"house_system","in":"query","required":false,"schema":{"enum":["P","W","K","A","R","C","B","M","O","E","V","X","H","T","G"],"type":"string","description":"House system code (P=Placidus, W=Whole Sign, K=Koch, A=Equal, R=Regiomontanus, C=Campanus)","default":"P","title":"House System"},"description":"House system code (P=Placidus, W=Whole Sign, K=Koch, A=Equal, R=Regiomontanus, C=Campanus)"}],"responses":{"200":{"description":"Complete astrological houses reference with themes, meanings, and house system information","content":{"application/json":{"schema":{},"examples":{"placidus_houses":{"summary":"Houses with Placidus system","description":"Complete houses information using the default Placidus house system with traditional meanings","value":{"house_system":"P","houses":[{"number":1,"name":"1st House","themes":["identity","appearance","personality","new beginnings","independence"],"primary_theme":"identity","life_areas":["personal_identity","health_vitality"],"traditional_meaning":"House 1 governs identity, appearance, personality","modern_keywords":["self-image","first impressions","physical body","initiative","leadership style"]},{"number":2,"name":"2nd House","themes":["resources","values","possessions","self-worth","material security"],"primary_theme":"resources","life_areas":["wealth_prosperity","career_success"],"traditional_meaning":"House 2 governs resources, values, possessions","modern_keywords":["money","talents","self-esteem","earning ability","material comfort"]},{"number":7,"name":"7th House","themes":["partnerships","marriage","relationships","cooperation","open enemies"],"primary_theme":"partnerships","life_areas":["love_relationships","business_partnerships"],"traditional_meaning":"House 7 governs partnerships, marriage, relationships","modern_keywords":["spouse","business partners","contracts","balance","projection"]},{"number":10,"name":"10th House","themes":["career","reputation","public image","authority","achievement"],"primary_theme":"career","life_areas":["career_success","public_recognition"],"traditional_meaning":"House 10 governs career, reputation, public image","modern_keywords":["profession","status","ambition","legacy","social standing"]}],"available_systems":[{"code":"P","name":"Placidus","description":"Placidus - Most popular quadrant system using time proportions","category":"quadrant","usage":"General natal astrology, psychological interpretation","is_default":true},{"code":"W","name":"Whole Sign","description":"Whole Sign - Ancient system using entire signs as houses","category":"whole_sign","usage":"Traditional astrology, Hellenistic techniques","is_default":false},{"code":"K","name":"Koch","description":"Koch - Birthplace system popular in Europe","category":"quadrant","usage":"European astrology, birth time rectification","is_default":false},{"code":"A","name":"Equal Ascendant","description":"Equal Ascendant - 30° houses starting from Ascendant","category":"equal","usage":"Modern psychological astrology","is_default":false}]}},"whole_sign_houses":{"summary":"Houses with Whole Sign system","description":"Houses information using the ancient Whole Sign house system","value":{"house_system":"W","houses":[{"number":1,"name":"1st House","themes":["identity","appearance","personality","new beginnings","independence"],"primary_theme":"identity","life_areas":["personal_identity","health_vitality"],"traditional_meaning":"House 1 governs identity, appearance, personality","modern_keywords":["self-image","first impressions","physical body","initiative","leadership style"]}],"available_systems":[{"code":"P","name":"Placidus","description":"Placidus - Most popular quadrant system using time proportions","category":"quadrant","usage":"General natal astrology, psychological interpretation","is_default":true},{"code":"W","name":"Whole Sign","description":"Whole Sign - Ancient system using entire signs as houses","category":"whole_sign","usage":"Traditional astrology, Hellenistic techniques","is_default":false}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/houses\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/houses\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/houses\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/houses\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/houses\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/elements":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Elements Glossary Endpoint","description":"🔥💧💨🌍 **Elements Glossary** - Classical elements reference for astrology and tarot\n\nReturns comprehensive information about the four classical elements (Fire, Water, Air, Earth)\nand their correspondences in both astrological and tarot systems.\n\n**Perfect for:**\n- 🎴 Tarot elemental dignities calculations\n- ♈ Understanding zodiac sign elements\n- 🌟 Planetary elemental associations\n- 🎯 Life area elemental connections\n- 📚 Educational applications\n\n**What you get for each element:**\n- **Keywords** - Core qualities and attributes\n- **Colors** - Associated color correspondences\n- **Zodiac signs** - Three signs per element\n- **Planets** - Planetary associations\n- **Tarot suit** - Minor Arcana suit correspondence\n- **Season** - Seasonal association\n- **Direction** - Cardinal direction\n- **Temperament** - Classical temperament\n- **Life areas** - Related life themes\n\n**Element relationships:**\n- **Friendly** - Supportive elements (strength 1.5x)\n- **Neutral** - Balanced interaction (strength 1.0x)\n- **Opposing** - Challenging elements (strength 0.5x)\n\n**Use cases:**\n- Calculate elemental dignities in tarot spreads\n- Understand sign compatibility by element\n- Determine elemental balance in birth charts\n- Educational content about elements\n\n**Response time:** ~20ms | **Content:** Complete elemental system","operationId":"get_elements_glossary_endpoint_api_v3_glossary_elements_get","responses":{"200":{"description":"Classical elements reference for astrology and tarot with complete correspondences","content":{"application/json":{"schema":{},"examples":{"classical_elements":{"summary":"Four classical elements","description":"Complete reference of Fire, Water, Air, and Earth elements with astrological and tarot correspondences","value":{"items":[{"id":"fire","description":"Fire element represents energy, action, and inspiration. Keywords: dynamic, passionate, creative. Signs: Ari, Leo, Sag. Tarot: Wands suit"},{"id":"water","description":"Water element represents emotions, intuition, and flow. Keywords: emotional, intuitive, healing. Signs: Can, Sco, Pis. Tarot: Cups suit"},{"id":"air","description":"Air element represents communication, thought, and connection. Keywords: intellectual, communicative, social. Signs: Gem, Lib, Aqu. Tarot: Swords suit"},{"id":"earth","description":"Earth element represents stability, practicality, and manifestation. Keywords: practical, stable, material. Signs: Tau, Vir, Cap. Tarot: Pentacles suit"}]}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/elements\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/elements\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/elements\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/elements\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/elements\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/glossary/horary-categories":{"get":{"tags":["📚 Reference & Glossary"],"summary":"Get Horary Categories","description":"**Horary Question Categories** - Reference for question types and subtypes\n\nReturns all horary question categories and their subtypes for use with\n`/horary/analyze` endpoint. Each category has specific subtypes with\ndifferent judgment criteria and significators.\n\n**Perfect for:**\n- Discovering available question categories\n- Understanding subtype-specific significators\n- Building dynamic question forms\n- Educational horary content\n\n**What you get:**\n- **Categories** - Main question types (health, love, career, etc.)\n- **Subtypes** - Specific question variations within each category\n- **Significators** - Planets/points to examine for each subtype\n- **Descriptions** - Human-readable question examples\n\n**Example usage with /horary/analyze:**\n```json\n{\n \"question\": \"Will I get the job?\",\n \"category\": \"career\",\n \"subtype\": \"get_position\",\n ...\n}\n```\n\n**Response time:** ~10ms | **Content:** Complete horary category reference","operationId":"get_horary_categories_api_v3_glossary_horary_categories_get","responses":{"200":{"description":"Horary question categories and their subtypes","content":{"application/json":{"schema":{},"examples":{"all_categories":{"summary":"All horary categories","description":"Complete list of question categories with subtypes for horary analysis","value":{"categories":{"health":{"subtypes":[{"id":"will_recover","description":"Will I recover from this illness?","significators":["L1","L6"]},{"id":"is_dangerous","description":"Is the illness dangerous?","significators":["L6","Moon"]}]},"love":{"subtypes":[{"id":"marriage","description":"Will there be marriage?","significators":["L1","L7"]},{"id":"fidelity","description":"Is partner faithful?","significators":["L7","Venus","Moon"]}]}},"total_categories":16,"total_subtypes":65}}}}}},"404":{"description":"Glossary item not found"},"500":{"description":"Internal server error loading glossary"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/glossary/horary-categories\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/glossary/horary-categories\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/glossary/horary-categories\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/glossary/horary-categories\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/glossary/horary-categories\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/relationship/compatibility":{"post":{"tags":["💕 Relationship Insights"],"summary":"Calculate Compatibility","description":"🌟 **Relationship Compatibility Analysis** - Deep synastry and composite insights\n\n**Perfect for:**\n- 💑 Couples wanting to understand their dynamic\n- 💕 Dating apps providing compatibility scores\n- 💍 Pre-marriage counseling\n- 🔮 Relationship coaches\n\n**What you get:**\n- **Compatibility Score** - 0-100 rating with detailed breakdown\n- **Synastry Analysis** - How you affect each other\n- **Composite Chart** - Your relationship as an entity\n- **Love Languages** - How you give and receive love\n- **Relationship Dynamics** - Power balance, communication style\n- **Davison Chart** (optional) - Midpoint relationship chart\n\n**Response time:** ~500ms | **Accuracy:** Professional-grade calculations","operationId":"calculate_compatibility_api_v3_insights_relationship_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatibilityRequest"},"examples":{"basic_compatibility":{"summary":"Basic compatibility check","description":"Simple compatibility analysis between two people","value":{"subjects":[{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},{"name":"Partner","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"Kiev","country_code":"UA"}}],"options":{"language":"en"},"compatibility_options":{"include_davison":false,"include_timing":false}}},"international_couple":{"summary":"International relationship","description":"Cross-cultural compatibility with coordinates","value":{"subjects":[{"name":"Person 1","birth_data":{"year":1988,"month":3,"day":15,"hour":9,"minute":45,"latitude":50.4501,"longitude":30.5234,"timezone":"Europe/Kiev"}},{"name":"Person 2","birth_data":{"year":1992,"month":7,"day":20,"hour":16,"minute":30,"city":"Paris","country_code":"FR"}}],"options":{"language":"fr"},"compatibility_options":{"include_davison":true,"include_timing":true}}}}}},"required":true},"responses":{"200":{"description":"Successful compatibility analysis with synastry, composite chart insights, and compatibility scores","content":{"application/json":{"schema":{},"examples":{"ukrainian_couple_analysis":{"summary":"Ukrainian couple compatibility analysis","description":"Complete compatibility report for couple from Ukraine","value":{"overall_score":78,"compatibility_score":78,"synastry":{"emotional_connection":85,"communication_style":72,"physical_attraction":80,"long_term_potential":75,"key_aspects":["Sun_conjunction_Moon: Deep emotional understanding","Venus_trine_Mars: Strong physical and romantic attraction","Mercury_square_Mercury: Different communication styles requiring adjustment"]},"composite":{"relationship_purpose":"Growth through emotional healing and creative expression","strengths":["Emotional depth","Shared values","Creative synergy"],"challenges":["Communication differences","Different life pacing"],"sun_sign":"Can","moon_sign":"Pis","venus_sign":"Tau"},"love_languages":{"person1":{"primary":"Quality time","secondary":"Physical touch","receiving_style":"Acts of service"},"person2":{"primary":"Words of affirmation","secondary":"Gift giving","receiving_style":"Quality time"}},"relationship_dynamics":{"power_balance":"Equal partnership with complementary strengths","conflict_resolution":"Emotional processing with logical solutions","intimacy_style":"Deep emotional connection with physical expression"},"recommendations":["Focus on clear communication about needs and expectations","Create regular quality time rituals","Practice patience during emotional processing","Celebrate differences as growth opportunities"]}},"international_couple_analysis":{"summary":"International couple with Davison chart","description":"Cross-cultural compatibility with relationship timing","value":{"overall_score":82,"compatibility_score":82,"synastry":{"emotional_connection":88,"communication_style":79,"physical_attraction":84,"long_term_potential":80,"cultural_harmony":76},"composite":{"relationship_purpose":"Bridge cultures through love and understanding","strengths":["Cultural appreciation","Adventure","Growth mindset"],"challenges":["Language barriers","Family integration","Geographic distance"]},"davison_chart":{"midpoint_location":{"latitude":48.8566,"longitude":15.2137,"city":"Midpoint between Kiev and Paris"},"relationship_sun":"Gem","relationship_moon":"Aqu","relationship_rising":"Lib","dominant_themes":["Communication","Innovation","Harmony"]},"timing":{"optimal_periods":{"2024-Q3":"Excellent for commitment decisions","2024-Q4":"Favorable for family integration","2025-Q1":"Ideal for relocation planning"}}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"missing_subjects":{"summary":"Missing subjects for compatibility","description":"Error when not providing exactly 2 subjects","value":{"detail":[{"type":"value_error","loc":["body","subjects"],"msg":"Exactly 2 subjects required for compatibility analysis","input":[]}]}},"invalid_birth_data":{"summary":"Invalid birth data format","description":"Error when birth data is incomplete or invalid","value":{"detail":[{"type":"value_error","loc":["body","subjects",0,"birth_data","year"],"msg":"Year must be between 1800 and 2100","input":1750}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/relationship/compatibility-score":{"post":{"tags":["💕 Relationship Insights"],"summary":"Quick Compatibility Score","description":"🎯 **Quick Compatibility Score** - Fast numerical compatibility\n\n**Perfect for:**\n- 📱 Dating app swipe decisions\n- ⚡ Quick compatibility checks\n- 🎰 Match percentage displays\n\n**What you get:**\n- **Overall Score** - 0-100 compatibility percentage\n- **Category Breakdown** - Emotional, intellectual, physical scores\n- **Match Quality** - Excellent/Good/Moderate/Challenging\n\n**Response time:** ~200ms | **Optimized for speed**","operationId":"quick_compatibility_score_api_v3_insights_relationship_compatibility_score_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultipleSubjectsRequest"},"examples":{"quick_score":{"summary":"Quick compatibility score","description":"Fast compatibility percentage for dating apps","value":{"subjects":[{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},{"name":"Match","birth_data":{"year":1990,"month":8,"day":22,"hour":10,"minute":30,"city":"Kiev","country_code":"UA"}}],"options":{"language":"en"}}},"coordinates_speed":{"summary":"Using coordinates for speed","description":"Direct coordinate input avoids geocoding delay","value":{"subjects":[{"name":"Person A","birth_data":{"year":1987,"month":9,"day":3,"hour":14,"minute":22,"latitude":50.4501,"longitude":30.5234,"timezone":"Europe/Kiev"}},{"name":"Person B","birth_data":{"year":1992,"month":12,"day":7,"hour":16,"minute":45,"latitude":51.5074,"longitude":-0.1278,"timezone":"Europe/London"}}],"options":{"language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Fast compatibility score calculation optimized for dating apps and quick decisions","content":{"application/json":{"schema":{},"examples":{"high_compatibility_score":{"summary":"High compatibility couple","description":"Strong compatibility score for Ukrainian couple","value":{"overall_score":85,"breakdown":{"emotional":88,"intellectual":82,"physical":87,"spiritual":83,"lifestyle":85},"match_quality":"excellent","key_strengths":["Strong emotional resonance","Complementary communication styles","Shared life values"],"potential_challenges":["Different approaches to decision-making","Varying social energy levels"]}},"moderate_compatibility_score":{"summary":"Moderate compatibility with growth potential","description":"Moderate score requiring mutual understanding","value":{"overall_score":62,"breakdown":{"emotional":65,"intellectual":70,"physical":58,"spiritual":60,"lifestyle":57},"match_quality":"good","key_strengths":["Intellectual stimulation","Growth opportunities","Complementary skills"],"potential_challenges":["Different emotional processing styles","Lifestyle compatibility requires work","Physical attraction needs nurturing"]}},"speed_optimized_calculation":{"summary":"Coordinate-based quick calculation","description":"Fast calculation using direct coordinates","value":{"overall_score":73,"breakdown":{"emotional":76,"intellectual":78,"physical":68,"spiritual":71,"lifestyle":72},"match_quality":"good","calculation_time_ms":150,"optimization_notes":"Direct coordinates bypassed geocoding for 50ms speed improvement"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"insufficient_subjects":{"summary":"Not enough subjects provided","description":"Error when less than 2 subjects provided","value":{"detail":[{"type":"value_error","loc":["body","subjects"],"msg":"Exactly 2 subjects required for compatibility score","input":[{"name":"Single person"}]}]}},"invalid_coordinates":{"summary":"Invalid geographic coordinates","description":"Error when coordinates are out of valid range","value":{"detail":[{"type":"value_error","loc":["body","subjects",0,"birth_data","latitude"],"msg":"Latitude must be between -90 and 90 degrees","input":100.5}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility-score\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility-score\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility-score\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility-score\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/relationship/compatibility-score\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/relationship/love-languages":{"post":{"tags":["💕 Relationship Insights"],"summary":"Analyze Love Languages","description":"💝 **Love Language Analysis** - Discover how you give and receive love\n\n**Based on:**\n- **Venus** - How you show love and affection\n- **Moon** - Your emotional needs and comfort\n- **Mars** - Your passion and desire nature\n- **5th House** - Romance and creative expression\n\n**What you get:**\n- **Primary Love Language** - Your main way of expressing love\n- **Secondary Love Language** - Your secondary expression\n- **Receiving Style** - How you prefer to receive love\n- **Romantic Tendencies** - Detailed personality insights\n\n**Response time:** ~300ms","operationId":"analyze_love_languages_api_v3_insights_relationship_love_languages_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"individual_analysis":{"summary":"Individual love language style","description":"Analyze one person's love language preferences","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en"}}},"ukrainian_person":{"summary":"Ukrainian person analysis","description":"Love language analysis in Russian (fallback)","value":{"subject":{"name":"Іван","birth_data":{"year":1988,"month":7,"day":18,"hour":9,"minute":45,"city":"Kiev","country_code":"UA"}},"options":{"language":"ru"}}},"french_person":{"summary":"French person analysis","description":"Love language analysis in French","value":{"subject":{"name":"Marie","birth_data":{"year":1990,"month":11,"day":2,"hour":12,"minute":0,"city":"Paris","country_code":"FR"}},"options":{"language":"fr"}}}}}},"required":true},"responses":{"200":{"description":"Individual love language analysis based on Venus, Moon, Mars positions and relationship houses","content":{"application/json":{"schema":{},"examples":{"oleg_love_language_analysis":{"summary":"Oleg's love language profile","description":"Complete love language analysis for Oleg from Kharkiv","value":{"primary_love_language":"Quality Time","secondary_love_language":"Physical Touch","receiving_style":"Acts of Service","venus_influence":{"sign":"Tau","house":"Eighth_House","expression":"Sensual, loyal, and values stability in love","gift_giving_style":"Practical and lasting items that provide comfort"},"moon_influence":{"sign":"Can","house":"Eleventh_House","emotional_needs":"Security, emotional intimacy, nurturing environment","comfort_style":"Home-based activities, cooking together, emotional support"},"mars_influence":{"sign":"Leo","house":"Twelfth_House","passion_style":"Playful, generous, enjoys appreciation and recognition","conflict_approach":"Direct but warm, prefers resolution through affection"},"fifth_house_romance":{"sign":"Vir","themes":"Thoughtful romantic gestures, attention to detail in courtship","creative_expression":"Service-oriented romance, practical expressions of love"},"romantic_tendencies":["Values consistency and reliability in relationships","Expresses love through thoughtful actions and quality time","Appreciates physical affection and sensual experiences","Needs emotional security and genuine connection","Shows care through practical support and service"],"compatibility_tips":["Partner should value consistency and show up reliably","Physical affection and touch are important","Appreciates when partner notices and meets practical needs","Quality time together builds strongest connection"]}},"multilingual_analysis":{"summary":"French person love language analysis","description":"Love language analysis delivered in French","value":{"primary_love_language":"Mots d'affirmation","secondary_love_language":"Temps de qualité","receiving_style":"Cadeaux","venus_influence":{"sign":"Lib","house":"Fifth_House","expression":"Charme, équilibre et beauté dans l'amour","gift_giving_style":"Objets esthétiques et significatifs"},"romantic_tendencies":["Apprécie l'élégance et l'harmonie dans les relations","Exprime l'amour à travers la beauté et l'art","A besoin d'équilibre et de partenariat égalitaire","Valorise la communication et le partage intellectuel"]}},"detailed_psychological_profile":{"summary":"Comprehensive psychological love profile","description":"Deep psychological analysis of love patterns","value":{"primary_love_language":"Words of Affirmation","secondary_love_language":"Acts of Service","receiving_style":"Quality Time","psychological_profile":{"attachment_style":"Secure with slight anxious tendencies","emotional_processing":"Analytical with strong intuitive insights","intimacy_preference":"Gradual deepening with intellectual connection first","conflict_style":"Seeks understanding and harmony, avoids confrontation initially"},"astrological_foundations":{"venus_aspects":["Venus trine Jupiter: Generous and optimistic in love"],"moon_aspects":["Moon sextile Mercury: Emotional intelligence in communication"],"mars_aspects":["Mars conjunct Saturn: Disciplined approach to desire and action"]},"growth_recommendations":["Practice expressing needs directly and clearly","Develop comfort with healthy conflict resolution","Balance giving and receiving in relationships","Trust emotional intuition alongside analytical thinking"]}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"missing_subject":{"summary":"Missing subject data","description":"Error when subject data is not provided","value":{"detail":[{"type":"missing","loc":["body","subject"],"msg":"Field required"}]}},"invalid_time_format":{"summary":"Invalid time format","description":"Error when birth time format is invalid","value":{"detail":[{"type":"value_error","loc":["body","subject","birth_data","hour"],"msg":"Hour must be between 0 and 23","input":25}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/relationship/love-languages\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/love-languages\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/love-languages\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/relationship/love-languages\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/relationship/love-languages\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/relationship/davison":{"post":{"tags":["💕 Relationship Insights"],"summary":"Calculate Davison Chart","description":"🌌 **Davison Relationship Chart** - The midpoint chart of your relationship\n\n**What is it?**\nThe Davison chart calculates the exact midpoint in time and space between\ntwo births, creating a chart for the relationship itself as a separate entity.\n\n**Calculation:**\n- Midpoint in space (latitude/longitude average)\n- Midpoint in time (between two birth moments)\n- Creates a third chart representing the relationship\n\n**Use cases:**\n- Understanding the relationship's purpose\n- Timing for the relationship\n- Relationship's personality\n\n**Response time:** ~400ms","operationId":"calculate_davison_chart_api_v3_insights_relationship_davison_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultipleSubjectsRequest"},"examples":{"ukraine_couple":{"summary":"Ukrainian couple Davison chart","description":"Midpoint relationship chart for Ukrainian couple","value":{"subjects":[{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},{"name":"Partner","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"Kiev","country_code":"UA"}}],"options":{"language":"ru"}}},"international_couple":{"summary":"International relationship","description":"Cross-cultural Davison chart analysis","value":{"subjects":[{"name":"Person A","birth_data":{"year":1987,"month":2,"day":28,"hour":22,"minute":30,"city":"Lviv","country_code":"UA"}},{"name":"Person B","birth_data":{"year":1989,"month":6,"day":10,"hour":11,"minute":0,"city":"Berlin","country_code":"DE"}}],"options":{"language":"de"}}},"marriage_chart":{"summary":"Marriage relationship chart","description":"Long-term partnership Davison analysis","value":{"subjects":[{"name":"Partner 1","birth_data":{"year":1983,"month":12,"day":5,"hour":16,"minute":45,"city":"Warsaw","country_code":"PL"}},{"name":"Partner 2","birth_data":{"year":1985,"month":3,"day":20,"hour":8,"minute":15,"city":"Krakow","country_code":"PL"}}],"options":{"language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Davison relationship chart calculation with midpoint location and time analysis","content":{"application/json":{"schema":{},"examples":{"ukrainian_couple_davison":{"summary":"Ukrainian couple Davison chart","description":"Complete Davison chart for couple from Ukraine","value":{"midpoint_calculation":{"person1_location":{"city":"Kharkiv","latitude":49.9935,"longitude":36.2304,"timezone":"Europe/Kiev"},"person2_location":{"city":"Kiev","latitude":50.4501,"longitude":30.5234,"timezone":"Europe/Kiev"},"midpoint_location":{"latitude":50.2218,"longitude":33.3769,"calculated_city":"Midpoint between Kharkiv and Kiev","timezone":"Europe/Kiev"},"time_midpoint":{"person1_birth":"1985-05-11T18:15:45","person2_birth":"1990-08-22T14:30:00","relationship_birth":"1987-12-31T16:22:52"}},"relationship_chart":{"sun":{"sign":"Cap","house":"Seventh_House","position":10.45,"meaning":"Serious, committed partnership with long-term focus"},"moon":{"sign":"Pis","house":"Ninth_House","position":22.18,"meaning":"Intuitive, spiritual connection with shared dreams"},"rising":{"sign":"Can","position":5.33,"meaning":"Nurturing, protective relationship identity"},"venus":{"sign":"Aqu","house":"Eighth_House","position":15.67,"meaning":"Innovative approach to intimacy and shared resources"}},"relationship_themes":{"primary_purpose":"Stable foundation building with emotional growth","dominant_elements":["Water","Earth"],"key_strengths":["Deep emotional understanding","Practical approach to partnership","Shared spiritual values","Strong foundation building"],"growth_areas":["Balancing security needs with growth","Communication during emotional intensity","Integrating different life philosophies"]},"timing_insights":{"relationship_seasons":{"spring":"New beginnings and growth periods","summer":"Active manifestation and external focus","autumn":"Harvest of relationship efforts","winter":"Deep reflection and planning phase"},"major_transits":["Jupiter return every 12 years: Expansion phases","Saturn return every 29 years: Commitment tests"]}}},"international_davison":{"summary":"International couple cross-cultural chart","description":"Davison chart spanning different countries and cultures","value":{"midpoint_calculation":{"geographic_span":{"distance_km":2387,"cultural_bridge":"Eastern European and Western European influences"},"midpoint_location":{"latitude":49.1426,"longitude":25.4521,"nearest_city":"Chernivtsi, Ukraine","significance":"Cultural meeting point between traditions"}},"relationship_chart":{"sun":{"sign":"Gem","house":"Ninth_House","meaning":"Communication bridge between cultures and philosophies"},"moon":{"sign":"Sag","house":"Third_House","meaning":"Adventurous learning and exploration together"},"mercury":{"sign":"Can","house":"Tenth_House","meaning":"Nurturing communication in public and career"}},"cultural_synthesis":{"shared_values":["Education","Family","Cultural appreciation"],"complementary_differences":["Tradition vs Innovation","Stability vs Adventure"],"integration_opportunities":["Language learning","Cultural exchange","Travel together"]}}},"detailed_technical_chart":{"summary":"Technical Davison chart with all planets","description":"Complete planetary positions and aspect analysis","value":{"planetary_positions":{"sun":{"sign":"Leo","position":18.45,"house":"Fifth_House"},"moon":{"sign":"Lib","position":3.22,"house":"Seventh_House"},"mercury":{"sign":"Vir","position":25.67,"house":"Sixth_House"},"venus":{"sign":"Can","position":12.89,"house":"Fourth_House"},"mars":{"sign":"Sco","position":8.13,"house":"Eighth_House"},"jupiter":{"sign":"Aqu","position":20.44,"house":"Eleventh_House"},"saturn":{"sign":"Cap","position":15.78,"house":"Tenth_House"}},"major_aspects":[{"aspect":"conjunction","planets":["Sun","Venus"],"orb":2.3,"strength":"strong"},{"aspect":"trine","planets":["Moon","Jupiter"],"orb":1.8,"strength":"very_strong"},{"aspect":"square","planets":["Mars","Saturn"],"orb":3.1,"strength":"moderate"}],"house_emphasis":{"strongest_houses":["Fourth_House","Seventh_House","Tenth_House"],"themes":["Home and foundation","Partnership dynamics","Public image and career"]}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"missing_second_subject":{"summary":"Only one subject provided","description":"Error when only one subject provided for Davison chart","value":{"detail":[{"type":"value_error","loc":["body","subjects"],"msg":"Exactly 2 subjects required for Davison chart","input":[{"name":"Single person","birth_data":{}}]}]}},"invalid_location_data":{"summary":"Invalid location information","description":"Error when location cannot be resolved","value":{"detail":[{"type":"value_error","loc":["body","subjects",1,"birth_data","city"],"msg":"City not found or invalid location data","input":"Nonexistent City"}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/relationship/davison\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/davison\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/davison\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/relationship/davison\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/relationship/davison\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/relationship/timing":{"post":{"tags":["💕 Relationship Insights"],"summary":"Calculate Relationship Timing","description":"📅 **Relationship Timing Analysis** - Find optimal dates for milestones\n\n**Analyzes:**\n- 💑 Best dates for commitment\n- 🏠 Moving in together timing\n- 💍 Engagement opportunities\n- 👰 Wedding date selection\n- 🌙 Lunar phases for romance\n\n**Based on:**\n- Individual transits\n- Composite chart transits\n- Davison chart transits\n- Venus and Mars cycles\n- Lunar phases\n\n**Response time:** ~600ms","operationId":"calculate_relationship_timing_api_v3_insights_relationship_timing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatibilityRequest"},"examples":{"wedding_planning":{"summary":"Wedding date planning","description":"Find optimal wedding dates for engaged couple","value":{"subjects":[{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},{"name":"Fiancée","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"Kiev","country_code":"UA"}}],"options":{"language":"en"},"compatibility_options":{"start_date":"2024-06-01","end_date":"2025-12-31","milestones":["wedding"]}}},"dating_progression":{"summary":"Dating milestone timing","description":"Early relationship progression timing","value":{"subjects":[{"name":"Person 1","birth_data":{"year":1992,"month":1,"day":25,"hour":12,"minute":0,"city":"Kiev","country_code":"UA"}},{"name":"Person 2","birth_data":{"year":1988,"month":11,"day":14,"hour":8,"minute":45,"city":"Prague","country_code":"CZ"}}],"options":{"language":"en"},"compatibility_options":{"milestones":["commitment","moving_together"]}}},"complete_timeline":{"summary":"Complete relationship timeline","description":"All major relationship milestones timing","value":{"subjects":[{"name":"Partner A","birth_data":{"year":1987,"month":4,"day":3,"hour":15,"minute":20,"city":"Odessa","country_code":"UA"}},{"name":"Partner B","birth_data":{"year":1991,"month":9,"day":12,"hour":21,"minute":45,"city":"Lviv","country_code":"UA"}}],"options":{"language":"ru"},"compatibility_options":{"milestones":["commitment","moving_together","engagement","wedding"]}}}}}},"required":true},"responses":{"200":{"description":"Relationship timing analysis for optimal dates of major milestones and transitions","content":{"application/json":{"schema":{},"examples":{"wedding_planning_timing":{"summary":"Wedding date planning for Ukrainian couple","description":"Optimal wedding dates and relationship milestone timing","value":{"optimal_dates":{"wedding":[{"date":"2024-09-21","score":92,"reasons":["Venus trine Jupiter in both charts","New Moon in Libra - fresh relationship starts","Composite Venus receiving beneficial aspects","Harmonious lunar phase for commitment"],"moon_phase":"New Moon","season":"Autumn Equinox"},{"date":"2024-10-15","score":88,"reasons":["Jupiter transit supporting commitment","Waxing Moon phase for growth","Both birth charts in harmonious aspect"],"moon_phase":"Waxing Gibbous","season":"Mid-Autumn"}],"commitment":[{"date":"2024-08-12","score":85,"reasons":["Venus return for Person 1","Composite chart receiving positive aspects","Full Moon energy for manifestation"]}]},"challenging_periods":{"2024-07-01_to_2024-07-15":{"reason":"Mars retrograde affecting communication","advice":"Avoid major decisions, focus on understanding"},"2024-11-20_to_2024-12-05":{"reason":"Mercury retrograde in commitment sector","advice":"Review relationship terms, avoid new commitments"}},"monthly_highlights":{"2024-08":"Strong period for emotional bonding and intimacy","2024-09":"Excellent for public commitments and celebrations","2024-10":"Growth period with family integration opportunities","2024-11":"Planning and practical relationship building","2024-12":"Reflection and intention setting for next year"},"venus_mars_cycles":{"next_venus_mars_conjunction":"2024-12-01","passion_peaks":["2024-08-22","2024-10-30","2024-12-15"],"harmony_periods":["2024-09-05","2024-11-18"]},"lunar_guidance":{"new_moons_for_new_beginnings":["2024-08-04: New intentions","2024-09-03: Relationship goals","2024-10-02: Practical planning"],"full_moons_for_manifestation":["2024-08-19: Emotional culmination","2024-09-18: Harvest relationship progress","2024-10-17: Achievement celebration"]}}},"dating_progression_timeline":{"summary":"Early relationship progression timing","description":"Timing for dating milestones and relationship development","value":{"optimal_dates":{"commitment":[{"date":"2024-09-15","score":89,"reasons":["Harmonious Venus aspects in both charts","New Moon supports new agreements","Jupiter transit favoring partnerships"],"milestone_type":"Exclusive dating agreement"}],"moving_together":[{"date":"2025-03-20","score":85,"reasons":["Spring Equinox - new beginnings","Composite chart 4th house activation","Both charts supporting domestic harmony"],"milestone_type":"Cohabitation start"}]},"relationship_progression":{"phase_1_attraction":{"timeframe":"2024-07-01 to 2024-08-15","focus":"Initial attraction and getting to know each other","favorable_dates":["2024-07-14","2024-08-08"]},"phase_2_connection":{"timeframe":"2024-08-15 to 2024-10-30","focus":"Deepening emotional connection and compatibility assessment","favorable_dates":["2024-09-05","2024-10-12"]},"phase_3_commitment":{"timeframe":"2024-11-01 to 2025-01-15","focus":"Defining relationship boundaries and future planning","favorable_dates":["2024-11-21","2024-12-25"]}}}},"comprehensive_yearly_timeline":{"summary":"Complete relationship timeline with all milestones","description":"Full year timing analysis for all relationship phases","value":{"yearly_overview":{"2024_theme":"Foundation building and emotional development","2025_theme":"Growth, expansion and practical manifestation"},"quarter_by_quarter":{"Q3_2024":{"energy":"High compatibility, strong emotional connection","best_for":["First meetings","Getting to know each other","Initial romantic dates"],"optimal_weeks":["Week of Aug 12","Week of Sep 16"]},"Q4_2024":{"energy":"Commitment-focused, building stability","best_for":["Exclusive commitment","Meeting families","Holiday celebrations"],"optimal_weeks":["Week of Oct 21","Week of Nov 25"]},"Q1_2025":{"energy":"New beginnings, fresh starts together","best_for":["Moving in together","Joint financial planning","Future goal setting"],"optimal_weeks":["Week of Jan 20","Week of Mar 17"]}},"astrological_influences":{"jupiter_transits":"Supporting long-term commitment and growth","saturn_influences":"Building solid foundation and realistic expectations","venus_periods":"Enhanced romance and aesthetic connection","mars_dynamics":"Passion cycles and conflict resolution opportunities"}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"invalid_date_range":{"summary":"Invalid date range provided","description":"Error when start date is after end date","value":{"detail":[{"type":"value_error","loc":["body","compatibility_options","end_date"],"msg":"End date must be after start date","input":{"start_date":"2024-12-01","end_date":"2024-06-01"}}]}},"unsupported_milestone":{"summary":"Unsupported milestone type","description":"Error when requesting unsupported milestone analysis","value":{"detail":[{"type":"value_error","loc":["body","compatibility_options","milestones"],"msg":"Supported milestones: commitment, moving_together, engagement, wedding","input":["unknown_milestone"]}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/relationship/timing\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/timing\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/timing\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/relationship/timing\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/relationship/timing\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/relationship/red-flags":{"post":{"tags":["💕 Relationship Insights"],"summary":"Analyze Red Green Flags","description":"🚦 **Red & Green Flags Analysis** - Dating profile insights\n\n**Identifies:**\n- 🟢 **Green Flags** - Positive relationship indicators\n- 🟡 **Yellow Flags** - Areas needing awareness\n- 🔴 **Red Flags** - Potential challenges\n\n**Analyzes:**\n- Venus aspects (love nature)\n- Moon aspects (emotional patterns)\n- Mars aspects (conflict style)\n- Saturn aspects (commitment)\n- 7th house (partnership approach)\n\n**Response time:** ~300ms","operationId":"analyze_red_green_flags_api_v3_insights_relationship_red_flags_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"dating_profile_analysis":{"summary":"Dating profile insights","description":"Analyze relationship patterns for dating","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en"}}},"self_awareness_check":{"summary":"Self-awareness analysis","description":"Understanding your relationship patterns","value":{"subject":{"name":"Anna","birth_data":{"year":1992,"month":9,"day":8,"hour":11,"minute":45,"city":"Kiev","country_code":"UA"}},"options":{"language":"ru"}}},"counseling_preparation":{"summary":"Relationship counseling prep","description":"Prepare for relationship therapy session","value":{"subject":{"name":"Михайло","birth_data":{"year":1988,"month":12,"day":3,"hour":16,"minute":20,"city":"Dnipro","country_code":"UA"}},"options":{"language":"ru"}}}}}},"required":true},"responses":{"200":{"description":"Relationship red and green flags analysis based on astrological patterns and personality indicators","content":{"application/json":{"schema":{},"examples":{"oleg_relationship_analysis":{"summary":"Oleg's relationship profile analysis","description":"Complete red/green flags analysis for Oleg from Kharkiv","value":{"green_flags":["Strong emotional intelligence indicated by Moon in Cancer","Stable and loyal nature with Venus in Taurus","Good communication skills with Mercury well-aspected","Committed approach to relationships with Saturn influences","Balanced masculine/feminine energy integration","Natural nurturing qualities and protective instincts","Values long-term stability over short-term excitement"],"yellow_flags":["May become overly protective or possessive at times","Tendency to hold onto grudges when emotionally hurt","Can be stubborn about changing relationship patterns","Sometimes difficulty expressing needs directly","May need more emotional security than some partners can provide","Occasional tendency to overthink relationship dynamics"],"red_flags":["Potential for emotional walls when feeling vulnerable","May struggle with partners who need excessive independence","Can become critically judgmental under stress","Risk of being too self-sacrificing in unbalanced relationships"],"overall_assessment":{"relationship_readiness":82,"compatibility_openness":7.8,"emotional_maturity":8.5,"communication_style":"Gentle but thorough","primary_strength":"Emotional stability and loyalty","area_for_growth":"Direct expression of personal needs","ideal_partner_traits":["Emotionally secure and stable","Appreciates consistency and reliability","Values home and family connections","Good at reading non-verbal emotional cues"]},"relationship_patterns":{"in_conflict":"Withdraws initially, then seeks resolution through understanding","showing_love":"Acts of service, quality time, physical affection","receiving_love":"Consistent presence, emotional validation, practical support","stress_response":"Becomes more protective and cautious about emotional exposure"},"recommendations":["Practice expressing needs and boundaries clearly and early","Work on trusting partner's independence without feeling abandoned","Develop healthy conflict resolution skills","Balance giving nature with healthy self-care","Communicate emotional needs before they become overwhelming"],"dating_advice":{"best_approach":"Slow, steady relationship building with emotional depth","warning_signs_to_watch":["Partners who dismiss emotional needs","Excessive drama or instability","Lack of commitment to growth"],"compatibility_indicators":["Partner values emotional intimacy","Appreciates consistent, reliable behavior","Shows care through practical actions"]}}},"self_awareness_profile":{"summary":"Comprehensive self-awareness analysis","description":"Deep psychological relationship pattern analysis","value":{"green_flags":["High emotional intelligence and empathy","Strong desire for authentic connections","Good at creating harmonious environments","Naturally supportive and encouraging to partners","Values personal growth and development","Excellent at reading emotional subtleties"],"yellow_flags":["May avoid conflict even when resolution is needed","Can be overly accommodating to keep peace","Sometimes difficulty setting firm boundaries","Tendency to internalize relationship stress","May give more energy than received in relationships"],"red_flags":["Risk of losing personal identity in intense relationships","May attract partners who take advantage of giving nature","Can become passive-aggressive when needs aren't met"],"psychological_insights":{"attachment_style":"Secure with anxious tendencies in uncertainty","love_blueprint":"Seeks deep emotional connection with growth potential","conflict_style":"Avoidant initially, then collaborative problem-solving","intimacy_approach":"Gradual trust building with emotional depth preference"},"growth_opportunities":["Develop assertiveness in expressing personal needs","Practice healthy conflict engagement strategies","Build confidence in maintaining independence within partnership","Learn to recognize and address codependent patterns early"]}},"relationship_coaching_profile":{"summary":"Professional relationship coaching insights","description":"Analysis prepared for relationship therapy or coaching session","value":{"strengths_to_leverage":["Natural empathy and emotional attunement","Strong commitment to relationship success","Ability to create safe emotional spaces","Genuine interest in partner's wellbeing and growth","Patience with relationship development process"],"challenges_to_address":["Tendency to prioritize partner's needs over own","Difficulty with direct confrontation when needed","Risk of emotional overwhelm during relationship stress","May seek excessive validation from partner"],"therapeutic_focus_areas":["Assertiveness training and boundary setting","Healthy conflict resolution skill development","Self-worth independent of relationship status","Communication of emotional needs and expectations"],"relationship_success_indicators":{"compatibility_factors":["Partner who values emotional depth","Mutual respect for personal growth","Shared commitment to communication","Balance of giving and receiving"],"warning_signs":["Partner who exploits giving nature","Relationship that discourages personal boundaries","Excessive drama or emotional volatility","Lack of reciprocal emotional investment"]},"action_steps":["Practice daily check-ins with personal emotional needs","Develop scripts for expressing boundaries kindly but firmly","Create support system outside of romantic relationship","Regular self-reflection on relationship balance and satisfaction"]}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation Error","content":{"application/json":{"examples":{"missing_birth_data":{"summary":"Incomplete birth information","description":"Error when essential birth data is missing","value":{"detail":[{"type":"missing","loc":["body","subject","birth_data","year"],"msg":"Birth year is required for analysis"}]}},"invalid_location":{"summary":"Location cannot be resolved","description":"Error when birth location cannot be found or resolved","value":{"detail":[{"type":"value_error","loc":["body","subject","birth_data","city"],"msg":"Unable to resolve coordinates for the provided city","input":"Unknown City"}]}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/relationship/red-flags\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/red-flags\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/red-flags\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/relationship/red-flags\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/relationship/red-flags\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/pet/personality":{"post":{"tags":["🐾 Pet Insights"],"summary":"Analyze Pet Personality","description":"🐾 **Pet Personality Analysis** - Understand your pet's unique character\n\n**Perfect for:**\n- 🐕 New pet parents wanting to understand their companion\n- 🐈 Trainers developing customized approaches\n- 🦜 Breeders understanding temperament patterns\n- 🐴 Anyone deepening their pet relationship\n\n**What you get:**\n- **Personality Profile** - Core temperament and traits\n- **Energy Level** - Activity needs and patterns\n- **Social Style** - How they interact with others\n- **Training Approach** - Best methods for this personality\n- **Emotional Needs** - What makes them feel secure\n\n**Response time:** ~300ms | **Accuracy:** Based on birth time precision","operationId":"analyze_pet_personality_api_v3_insights_pet_personality_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetSingleSubjectRequest"},"examples":{"dog_personality":{"summary":"Golden Retriever personality analysis","description":"Analyze personality traits of a Golden Retriever puppy","value":{"subject":{"name":"Buddy","birth_data":{"year":2020,"month":3,"day":15,"hour":10,"minute":0,"city":"London","country_code":"GB"}},"pet_options":{"pet_type":"dog","breed":"golden_retriever","language":"en"}}},"cat_personality":{"summary":"Persian cat personality analysis","description":"Understanding a Persian cat's unique traits","value":{"subject":{"name":"Whiskers","birth_data":{"year":2021,"month":7,"day":22,"hour":14,"minute":30,"city":"Kharkiv","country_code":"UA"}},"pet_options":{"pet_type":"cat","breed":"persian","language":"en"}}},"owner_influenced_personality":{"summary":"Pet-Owner personality analysis","description":"Enhanced pet analysis with owner's astrological influence","value":{"subject":{"name":"Luna","birth_data":{"year":2022,"month":4,"day":10,"hour":8,"minute":30,"city":"Paris","country_code":"FR"}},"owner":{"name":"Marie","birth_data":{"year":1990,"month":8,"day":25,"hour":16,"minute":45,"city":"Paris","country_code":"FR"}},"pet_options":{"pet_type":"cat","breed":"siamese","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful pet personality analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetPersonalityResponse"},"examples":{"dog_personality_success":{"summary":"Golden Retriever personality analysis","description":"Complete personality profile for a friendly Golden Retriever","value":{"success":true,"data":{"basic_nature":{"sun_sign":"Pis","moon_sign":"Gem","dominant_element":"Water","temperament":"Gentle and intuitive with high emotional intelligence"},"activity_patterns":{"energy_level":"Your pet has moderate to high energy levels, enjoying regular activity balanced with rest periods.","active_hours":"Most active during morning hours (6-10 AM) and evening (5-8 PM)","exercise_needs":"Requires 60-90 minutes of daily activity including walks and play","playfulness":"Highly playful and responsive to interactive toys and games"},"social_behavior":{"pack_dynamics":"Natural pack member who prefers harmony and cooperation","stranger_reaction":"Cautious but curious with new people, warms up gradually","with_children":"Excellent with children, protective yet gentle","with_other_pets":"Generally friendly but may need proper introductions"},"training_approach":{"best_methods":"Positive reinforcement works best with consistent rewards","learning_style":"Visual and tactile learner who responds to demonstration","attention_span":"Good focus for 15-20 minute training sessions","motivation":"Food rewards and praise are highly effective"},"emotional_needs":{"security_factors":"Needs routine and familiar surroundings to feel secure","bonding_style":"Forms deep emotional bonds with family members","stress_triggers":"Loud noises and sudden environmental changes","comfort_preferences":"Enjoys physical closeness and gentle petting"}},"message":"Personality analysis completed for your dog"}},"cat_personality_success":{"summary":"Persian cat personality analysis","description":"Detailed personality insights for an independent Persian cat","value":{"success":true,"data":{"basic_nature":{"sun_sign":"Leo","moon_sign":"Tau","dominant_element":"Fire","temperament":"Regal and dignified with strong independent streak"},"activity_patterns":{"energy_level":"Moderate energy with preference for leisurely activities","active_hours":"Most active during dawn and dusk periods","exercise_needs":"Light daily play sessions and climbing opportunities","playfulness":"Selective about play, prefers elegant feather toys"},"social_behavior":{"pack_dynamics":"Prefers to be the only pet or clear alpha","stranger_reaction":"Very cautious, takes time to warm up to new people","with_children":"Better with older, calmer children who respect boundaries","with_other_pets":"Can be territorial, needs careful introductions"},"training_approach":{"best_methods":"Patience and consistency with gentle encouragement","learning_style":"Independent learner who observes before acting","attention_span":"Short bursts of 5-10 minutes work best","motivation":"High-value treats and quiet praise"},"emotional_needs":{"security_factors":"Needs quiet, private spaces and predictable routines","bonding_style":"Bonds deeply but shows affection on own terms","stress_triggers":"Chaos, loud environments, and forced interaction","comfort_preferences":"Warm, elevated resting spots and gentle handling"}},"message":"Personality analysis completed for your cat"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in request data","content":{"application/json":{"examples":{"invalid_birth_data":{"summary":"Invalid birth date","description":"Birth date validation failed","value":{"success":false,"error":{"error_code":"INVALID_BIRTH_DATA","message":"Invalid birth date provided","field":"birth_data.year","value":2025,"severity":"medium","suggestions":["Use a valid birth year (1900-2024)","Ensure all birth data fields are provided correctly"]},"timestamp":"2024-01-15T10:30:00Z"}},"missing_pet_data":{"summary":"Missing pet information","description":"Required pet data not provided","value":{"success":false,"error":{"error_code":"MISSING_REQUIRED_FIELD","message":"Pet type is required for personality analysis","field":"pet_options.pet_type","severity":"medium","suggestions":["Specify pet type: dog, cat, bird, rabbit, etc.","Include pet_options in your request"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/pet/personality\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/personality\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/personality\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/pet/personality\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/pet/personality\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/pet/compatibility":{"post":{"tags":["🐾 Pet Insights"],"summary":"Calculate Pet Human Compatibility","description":"🤝 **Human-Pet Compatibility** - Analyze your bond with your pet\n\n**Perfect for:**\n- 🏠 Choosing the right pet for your lifestyle\n- 💕 Understanding your existing pet relationship\n- 🎯 Optimizing training and care approaches\n- 🔮 Deepening the human-animal bond\n\n**What you get:**\n- **Compatibility Score** - Overall match percentage\n- **Energy Match** - Activity level compatibility\n- **Emotional Bond** - Connection depth potential\n- **Communication Style** - How you understand each other\n- **Care Recommendations** - Personalized care tips\n\n**Response time:** ~400ms | **Multi-pet household:** Compare multiple pets","operationId":"calculate_pet_human_compatibility_api_v3_insights_pet_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetCompatibilityRequest"},"examples":{"owner_dog_compatibility":{"summary":"Human-dog compatibility analysis","description":"Analyze compatibility between a human owner and their dog","value":{"subjects":[{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},{"name":"Max","birth_data":{"year":2020,"month":3,"day":15,"hour":10,"minute":0,"city":"Kharkiv","country_code":"UA"}}],"options":{"pet_type":"dog","breed":"golden_retriever","language":"en"}}},"owner_cat_compatibility":{"summary":"Human-cat compatibility analysis","description":"Understanding the bond between human and feline","value":{"subjects":[{"name":"Sarah","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"London","country_code":"GB"}},{"name":"Luna","birth_data":{"year":2021,"month":7,"day":8,"hour":9,"minute":15,"city":"London","country_code":"GB"}}],"options":{"pet_type":"cat","breed":"siamese","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful human-pet compatibility analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetCompatibilityResponse"},"examples":{"excellent_compatibility":{"summary":"High compatibility match","description":"Owner and pet with excellent compatibility","value":{"success":true,"data":{"overall_score":88,"compatibility_score":88,"energy_match":"Your energy levels complement each other perfectly - you both enjoy moderate activity with relaxation periods.","emotional_bond":"Deep emotional connection with strong mutual understanding and intuitive communication.","communication":"Natural intuitive communication makes daily interaction effortless and rewarding.","lifestyle_fit":"Your lifestyle provides the ideal environment for your pet's needs and preferences.","care_style":"Your caregiving approach perfectly matches your pet's emotional and physical needs.","detailed_analysis":{"sun_compatibility":"Sun signs create harmonious energy exchange","moon_compatibility":"Emotional needs align well for comfort and security","personality_match":"Complementary personalities that balance each other"},"recommendations":["Maintain consistent daily routines for security","Schedule regular play sessions during peak energy times","Create quiet bonding moments for emotional connection","Provide mental stimulation through interactive toys"]},"message":"Human-pet compatibility analysis completed"}},"moderate_compatibility":{"summary":"Moderate compatibility match","description":"Owner and pet with good potential requiring some adjustments","value":{"success":true,"data":{"overall_score":65,"compatibility_score":65,"energy_match":"Energy levels differ somewhat - your pet needs more activity than you naturally provide.","emotional_bond":"Good emotional connection with some areas needing attention and understanding.","communication":"Communication works well most of the time but requires patience during stress periods.","lifestyle_fit":"Your lifestyle accommodates your pet well with minor adjustments needed.","care_style":"Your caregiving style is generally good but could be more attuned to specific needs.","detailed_analysis":{"sun_compatibility":"Some tension in basic approaches but workable","moon_compatibility":"Different emotional rhythms requiring understanding","personality_match":"Differences that can be complementary with effort"},"recommendations":["Increase daily exercise and activity time","Learn to recognize stress signals earlier","Adjust feeding schedule to match natural rhythms","Create more structured training routines"]},"message":"Human-pet compatibility analysis completed"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in request data","content":{"application/json":{"examples":{"incorrect_subject_count":{"summary":"Wrong number of subjects","description":"Compatibility requires exactly 2 subjects","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Exactly 2 subjects required: owner and pet","field":"subjects","value":1,"severity":"medium","suggestions":["Provide exactly 2 subjects: one for the owner and one for the pet","Ensure both subjects have complete birth data"]},"timestamp":"2024-01-15T10:30:00Z"}},"invalid_location":{"summary":"Invalid location data","description":"Birth location could not be resolved","value":{"success":false,"error":{"error_code":"INVALID_LOCATION","message":"Could not resolve birth location","field":"birth_data.city","value":"UnknownCity","severity":"medium","suggestions":["Use a valid city name and country code","Provide latitude and longitude if city lookup fails"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/pet/compatibility\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/compatibility\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/compatibility\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/pet/compatibility\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/pet/compatibility\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/pet/training-windows":{"post":{"tags":["🐾 Pet Insights"],"summary":"Get Optimal Training Windows","description":"📚 **Optimal Training Windows** - Find the best times for training\n\n**Perfect for:**\n- 🎓 Professional trainers planning programs\n- 🏆 Competition preparation timing\n- 🧠 Learning new tricks or behaviors\n- 🤝 Socialization planning\n\n**What you get:**\n- **Best Training Days** - When learning is easiest\n- **Focus Areas** - What to train on specific days\n- **Bonding Windows** - Best times for connection\n- **Challenge Days** - When to take it easy\n\n**Response time:** ~500ms | **Range:** Up to 365 days ahead","operationId":"get_optimal_training_windows_api_v3_insights_pet_training_windows_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetSingleSubjectRequest"},"examples":{"dog_training":{"summary":"Dog obedience training","description":"Analyze best times for training a dog","value":{"subject":{"name":"Rex","birth_data":{"year":2020,"month":3,"day":15,"hour":10,"minute":0,"city":"London","country_code":"GB"}},"pet_options":{"pet_type":"dog","training_type":"obedience","language":"en"}}},"cat_training":{"summary":"Cat behavior training","description":"Find optimal times for cat training","value":{"subject":{"name":"Whiskers","birth_data":{"year":2021,"month":7,"day":22,"hour":14,"minute":30,"city":"Kharkiv","country_code":"UA"}},"pet_options":{"pet_type":"cat","training_type":"socialization","language":"en"}}},"puppy_socialization":{"summary":"Puppy socialization windows","description":"Best times for socializing a young puppy","value":{"subject":{"name":"Buddy","birth_data":{"year":2024,"month":1,"day":5,"hour":8,"minute":15,"city":"Paris","country_code":"FR"}},"pet_options":{"pet_type":"dog","breed":"golden_retriever","training_type":"socialization","language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Successful training windows analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetTrainingWindowsResponse"},"examples":{"dog_training_optimal":{"summary":"Optimal dog training periods","description":"Best training windows for a young dog","value":{"success":true,"data":{"training_type":"obedience","optimal_times":[{"date":"2024-01-20","time_range":"7:00-9:00 AM","favorability":"excellent","focus_area":"Basic commands and recall training","energy_level":"high","attention_span":"20-25 minutes"},{"date":"2024-01-22","time_range":"6:00-8:00 PM","favorability":"very_good","focus_area":"Leash training and socialization","energy_level":"moderate","attention_span":"15-20 minutes"},{"date":"2024-01-25","time_range":"8:00-10:00 AM","favorability":"excellent","focus_area":"Advanced commands and tricks","energy_level":"high","attention_span":"25-30 minutes"}],"training_windows":[{"period":"Early Morning (6-9 AM)","suitability":"excellent","activities":["Basic obedience","Recall training","Focus exercises"]},{"period":"Evening (5-7 PM)","suitability":"good","activities":["Socialization","Leash training","Play-based learning"]}],"recommendations":["Morning sessions show highest learning potential","Keep sessions short and positive","Use high-value treats during optimal windows","Avoid training during afternoon low-energy periods"],"general_advice":"Your pet learns best during consistent morning routines when energy and focus are naturally high."},"message":"Training window analysis completed"}},"cat_socialization":{"summary":"Cat socialization windows","description":"Best times for socializing a young cat","value":{"success":true,"data":{"training_type":"socialization","optimal_times":[{"date":"2024-01-18","time_range":"6:00-7:00 AM","favorability":"good","focus_area":"Gentle handling and petting","energy_level":"calm","attention_span":"5-10 minutes"},{"date":"2024-01-21","time_range":"7:00-8:00 PM","favorability":"very_good","focus_area":"Interactive play and bonding","energy_level":"moderate","attention_span":"10-15 minutes"}],"training_windows":[{"period":"Dawn (6-7 AM)","suitability":"good","activities":["Gentle handling","Quiet bonding","Feeding associations"]},{"period":"Dusk (7-8 PM)","suitability":"excellent","activities":["Interactive play","Exploration","Social games"]}],"recommendations":["Respect natural crepuscular activity patterns","Use play as primary socialization tool","Allow cat to approach at own pace","Keep sessions brief and positive"],"general_advice":"Cats socialize best during their natural active periods at dawn and dusk."},"message":"Training window analysis completed"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in request data","content":{"application/json":{"examples":{"invalid_training_type":{"summary":"Invalid training type","description":"Unsupported training type specified","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Invalid training type specified","field":"pet_options.training_type","value":"unknown_training","severity":"low","suggestions":["Use supported training types: obedience, socialization, agility, behavior_modification","Check the training type spelling and format"]},"timestamp":"2024-01-15T10:30:00Z"}},"future_birth_date":{"summary":"Future birth date","description":"Birth date is in the future","value":{"success":false,"error":{"error_code":"INVALID_BIRTH_DATA","message":"Birth date cannot be in the future","field":"birth_data.year","value":2025,"severity":"medium","suggestions":["Use the pet's actual birth date","Estimated dates are acceptable if exact date unknown"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/pet/training-windows\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/training-windows\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/training-windows\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/pet/training-windows\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/pet/training-windows\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/pet/health-sensitivities":{"post":{"tags":["🐾 Pet Insights"],"summary":"Analyze Health Sensitivities","description":"🏥 **Health Sensitivity Analysis** - Preventive health insights\n\n**Perfect for:**\n- 🩺 Preventive health planning\n- 🥗 Dietary optimization\n- 💪 Exercise planning\n- 😰 Stress management\n\n**What you get:**\n- **Sensitive Areas** - Body systems needing attention\n- **Dietary Considerations** - Nutritional needs\n- **Exercise Needs** - Optimal activity levels\n- **Stress Triggers** - What to avoid or minimize\n- **Preventive Care** - Proactive health measures\n\n**Note:** This is astrological insight only - always consult your veterinarian\n\n**Response time:** ~300ms","operationId":"analyze_health_sensitivities_api_v3_insights_pet_health_sensitivities_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetSingleSubjectRequest"},"examples":{"cat_persian":{"summary":"Persian cat health analysis","description":"Analyze health sensitivities for a Persian cat","value":{"subject":{"name":"Princess","birth_data":{"year":2020,"month":3,"day":15,"hour":10,"minute":0,"city":"London","country_code":"GB"}},"pet_options":{"pet_type":"cat","breed":"persian","language":"en"}}},"dog_labrador":{"summary":"Labrador health check","description":"Health sensitivities for a Labrador Retriever","value":{"subject":{"name":"Lucky","birth_data":{"year":2019,"month":9,"day":10,"hour":7,"minute":30,"city":"Kharkiv","country_code":"UA"}},"pet_options":{"pet_type":"dog","breed":"labrador","language":"en"}}},"rabbit_holland_lop":{"summary":"Rabbit health analysis","description":"Health considerations for a Holland Lop rabbit","value":{"subject":{"name":"Nibbles","birth_data":{"year":2022,"month":4,"day":1,"hour":12,"minute":0,"city":"Berlin","country_code":"DE"}},"pet_options":{"pet_type":"rabbit","breed":"holland_lop","language":"de"}}}}}},"required":true},"responses":{"200":{"description":"Successful health sensitivities analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetHealthSensitivitiesResponse"},"examples":{"dog_health_analysis":{"summary":"Dog health sensitivity profile","description":"Comprehensive health insights for a Labrador","value":{"success":true,"data":{"sensitive_areas":[{"body_system":"Digestive","sensitivity_level":"moderate","description":"May be prone to food sensitivities and digestive issues","recommendations":["Monitor for food allergies","Consider limited ingredient diets","Maintain consistent feeding schedule"]},{"body_system":"Joints and Bones","sensitivity_level":"high","description":"Potential for joint issues, especially in later years","recommendations":["Maintain healthy weight","Provide joint supplements","Regular low-impact exercise"]}],"dietary_considerations":{"primary_needs":"High-quality protein, moderate fat, controlled portions","foods_to_avoid":"High-fat foods, artificial additives, excessive treats","beneficial_foods":"Lean proteins, omega-3 rich fish, vegetables","feeding_schedule":"Regular meals at consistent times"},"exercise_needs":{"activity_level":"high","daily_requirements":"60-90 minutes of exercise","best_activities":["Swimming","Walking","Fetch","Mental stimulation games"],"exercise_timing":"Morning and evening sessions work best"},"stress_triggers":["Loud noises and sudden sounds","Changes in routine or environment","Separation from family members","Overcrowded social situations"],"preventive_care":{"regular_checkups":"Every 6 months for senior pets, annually for younger ones","dental_care":"Regular brushing and dental chews","weight_monitoring":"Monthly weight checks recommended","grooming_needs":"Weekly brushing, monthly baths"},"breed_considerations":"Labradors are prone to hip dysplasia and obesity"},"message":"Health sensitivity analysis completed","disclaimer":"For entertainment purposes only. Always consult a qualified veterinarian for health concerns."}},"cat_health_analysis":{"summary":"Cat health sensitivity profile","description":"Health insights for a Persian cat","value":{"success":true,"data":{"sensitive_areas":[{"body_system":"Respiratory","sensitivity_level":"high","description":"Flat-faced breeds may have breathing difficulties","recommendations":["Monitor for breathing issues","Keep environment dust-free","Avoid extreme temperatures"]},{"body_system":"Eyes","sensitivity_level":"moderate","description":"Prone to eye discharge and tear staining","recommendations":["Daily eye cleaning","Monitor for infections","Keep facial area dry"]}],"dietary_considerations":{"primary_needs":"High-quality protein, controlled portions, hairball prevention","foods_to_avoid":"Low-quality dry foods, dairy products, excessive carbohydrates","beneficial_foods":"Wet food for hydration, fiber for hairballs, omega oils for coat","feeding_schedule":"Small, frequent meals throughout the day"},"exercise_needs":{"activity_level":"low to moderate","daily_requirements":"20-30 minutes of gentle play","best_activities":["Feather toys","Laser pointer","Climbing towers","Puzzle feeders"],"exercise_timing":"Short sessions throughout the day"},"stress_triggers":["Loud environments and chaos","Forced interaction or handling","Changes in litter box location","New people or pets in the home"],"preventive_care":{"regular_checkups":"Annual veterinary visits","dental_care":"Dental treats and regular tooth brushing","weight_monitoring":"Indoor cats prone to weight gain","grooming_needs":"Daily brushing essential for long coat"},"breed_considerations":"Persian cats require daily grooming and respiratory monitoring"},"message":"Health sensitivity analysis completed","disclaimer":"For entertainment purposes only. Always consult a qualified veterinarian for health concerns."}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in request data","content":{"application/json":{"examples":{"unsupported_pet_type":{"summary":"Unsupported pet type","description":"Health analysis not available for this pet type","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Health analysis not available for this pet type","field":"pet_options.pet_type","value":"exotic_spider","severity":"low","suggestions":["Use supported pet types: dog, cat, bird, rabbit, horse","Contact support for additional pet type requests"]},"timestamp":"2024-01-15T10:30:00Z"}},"incomplete_birth_data":{"summary":"Incomplete birth information","description":"Missing required birth data fields","value":{"success":false,"error":{"error_code":"MISSING_REQUIRED_FIELD","message":"Birth date is required for health analysis","field":"birth_data.year","severity":"medium","suggestions":["Provide at least birth year and month","Estimated dates are acceptable if exact date unknown"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/pet/health-sensitivities\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/health-sensitivities\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/health-sensitivities\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/pet/health-sensitivities\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/pet/health-sensitivities\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/pet/multi-pet-dynamics":{"post":{"tags":["🐾 Pet Insights"],"summary":"Analyze Multi Pet Household","description":"🏡 **Multi-Pet Household Dynamics** - Harmony in multi-pet homes\n\n**Perfect for:**\n- 🐕🐈 Multi-pet households\n- 🆕 Adding a new pet to the family\n- ⚖️ Resolving pet conflicts\n- 🎭 Understanding pack dynamics\n\n**What you get:**\n- **Pack Dynamics** - Leadership and hierarchy\n- **Pair Compatibilities** - Each pet-to-pet relationship\n- **Harmony Tips** - Creating peaceful coexistence\n- **Resource Management** - Avoiding competition\n- **Introduction Timing** - Best times for new additions\n\n**Response time:** ~600ms | **Pets analyzed:** Up to 5","operationId":"analyze_multi_pet_household_api_v3_insights_pet_multi_pet_dynamics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PetMultiSubjectRequest"},"examples":{"dog_cat_pair":{"summary":"Dog and cat household","description":"Analyze dynamics between a dog and cat","value":{"subjects":[{"name":"Max","birth_data":{"year":2020,"month":3,"day":15,"hour":10,"minute":0,"city":"London","country_code":"GB"}},{"name":"Luna","birth_data":{"year":2021,"month":7,"day":8,"hour":14,"minute":30,"city":"London","country_code":"GB"}}],"pet_options":{"language":"en"}}},"three_dogs":{"summary":"Three dog pack","description":"Analyze pack dynamics with three dogs","value":{"subjects":[{"name":"Rex","birth_data":{"year":2019,"month":1,"day":10,"hour":8,"minute":0,"city":"Kharkiv","country_code":"UA"}},{"name":"Buddy","birth_data":{"year":2020,"month":5,"day":15,"hour":12,"minute":30,"city":"Kharkiv","country_code":"UA"}},{"name":"Charlie","birth_data":{"year":2021,"month":9,"day":20,"hour":16,"minute":45,"city":"Kharkiv","country_code":"UA"}}],"pet_options":{"language":"en"}}},"mixed_household":{"summary":"Mixed species household","description":"Dog, cat, and rabbit living together","value":{"subjects":[{"name":"Cooper","birth_data":{"year":2020,"month":2,"day":14,"hour":9,"minute":15,"city":"Paris","country_code":"FR"}},{"name":"Mittens","birth_data":{"year":2021,"month":6,"day":1,"hour":11,"minute":0,"city":"Paris","country_code":"FR"}},{"name":"Oreo","birth_data":{"year":2022,"month":3,"day":10,"hour":14,"minute":20,"city":"Paris","country_code":"FR"}}],"pet_options":{"language":"fr"}}}}}},"required":true},"responses":{"200":{"description":"Successful multi-pet dynamics analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiPetDynamicsResponse"},"examples":{"dog_cat_harmony":{"summary":"Dog and cat household dynamics","description":"Analysis of a harmonious dog-cat household","value":{"success":true,"data":{"pack_overview":"Multi-pet household with complementary personalities showing good potential for harmony","harmony_score":78,"compatibility":78,"pair_compatibilities":[{"pet1":"Max","pet2":"Luna","score":78,"relationship_type":"dog_cat_pair","notes":["Dog's gentle nature complements cat's independent style","Both prefer routine and structured environment","Cat may assert dominance through elevated spaces"]}],"dynamics":[{"pet1":"Max","pet2":"Luna","score":78,"relationship_type":"dog_cat_pair","notes":["Dog's gentle nature complements cat's independent style","Both prefer routine and structured environment","Cat may assert dominance through elevated spaces"]}],"interactions":{"overall_harmony":78,"individual_pairs":[{"pet1":"Max","pet2":"Luna","score":78,"relationship_type":"dog_cat_pair"}],"leadership_dynamic":"Cat takes natural leadership role","resource_sharing":"Minimal competition with proper setup"},"recommendations":["Provide separate feeding areas to prevent competition","Ensure cat has high perches for escape and observation","Create separate sleeping areas for each pet","Supervise initial interactions during introduction period","Maintain consistent daily routines for both pets"],"resource_management":{"feeding":"Separate feeding stations recommended","sleeping":"Individual sleeping areas prevent territorial disputes","toys":"Provide species-specific toys to avoid competition","attention":"Balance individual attention for both pets"}},"message":"Multi-pet dynamics analyzed for 2 pets"}},"three_dog_pack":{"summary":"Three dog pack dynamics","description":"Complex pack hierarchy with three dogs","value":{"success":true,"data":{"pack_overview":"Three-dog pack with established hierarchy and generally harmonious relationships","harmony_score":72,"compatibility":72,"pair_compatibilities":[{"pet1":"Rex","pet2":"Buddy","score":85,"relationship_type":"alpha_beta_pair","notes":["Clear leadership dynamic with mutual respect","Excellent training partnership potential"]},{"pet1":"Rex","pet2":"Charlie","score":68,"relationship_type":"alpha_omega_pair","notes":["Older dog mentors younger pack member","Some supervision needed during play"]},{"pet1":"Buddy","pet2":"Charlie","score":74,"relationship_type":"peer_pair","notes":["Similar energy levels make good play partners","May compete for middle pack position"]}],"dynamics":[{"pet1":"Rex","pet2":"Buddy","score":85,"relationship_type":"alpha_beta_pair"},{"pet1":"Rex","pet2":"Charlie","score":68,"relationship_type":"alpha_omega_pair"},{"pet1":"Buddy","pet2":"Charlie","score":74,"relationship_type":"peer_pair"}],"interactions":{"overall_harmony":72,"individual_pairs":[{"pet1":"Rex","pet2":"Buddy","score":85},{"pet1":"Rex","pet2":"Charlie","score":68},{"pet1":"Buddy","pet2":"Charlie","score":74}],"leadership_dynamic":"Rex is the natural pack leader","resource_sharing":"Structured feeding order prevents competition"},"recommendations":["Establish clear feeding order: Rex, then Buddy, then Charlie","Provide individual exercise for different energy levels","Train together to reinforce pack hierarchy","Monitor Buddy and Charlie interactions for competition","Ensure each dog has personal space and toys"],"pack_hierarchy":{"alpha":"Rex - Natural leader, calm authority","beta":"Buddy - Reliable second-in-command","omega":"Charlie - Playful youngest member"}},"message":"Multi-pet dynamics analyzed for 3 pets"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in request data","content":{"application/json":{"examples":{"too_few_pets":{"summary":"Not enough pets for analysis","description":"Multi-pet analysis requires at least 2 pets","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Need at least 2 pets for dynamics analysis","field":"subjects","value":1,"severity":"medium","suggestions":["Provide at least 2 pet subjects for dynamics analysis","Use single pet endpoints for individual analysis"]},"timestamp":"2024-01-15T10:30:00Z"}},"too_many_pets":{"summary":"Too many pets for analysis","description":"Multi-pet analysis limited to 5 pets maximum","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Maximum 5 pets for analysis","field":"subjects","value":7,"severity":"medium","suggestions":["Limit to maximum of 5 pets for dynamics analysis","Consider analyzing pets in smaller groups"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/pet/multi-pet-dynamics\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/multi-pet-dynamics\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/pet/multi-pet-dynamics\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/pet/multi-pet-dynamics\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/pet/multi-pet-dynamics\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/wellness/body-mapping":{"post":{"tags":["🌿 Wellness Insights"],"summary":"Analyze Body Mapping","description":"🗺️ **Astrological Body Mapping** - Traditional medical astrology insights\n\n**Based on:**\n- 🌟 Zodiac signs ruling body systems\n- 🪐 Planetary influences on health\n- 🏠 6th house (health house) analysis\n- 🔥 Elemental balance and constitution\n\n**What you get:**\n- **Sensitive Systems** - Areas needing extra care\n- **Strong Systems** - Your constitutional strengths\n- **Element Balance** - Constitutional type\n- **Wellness Focus** - Personalized health priorities\n- **Preventive Care** - Proactive recommendations\n\n**Note:** For entertainment only - always consult healthcare professionals\n\n**Response time:** ~300ms","operationId":"analyze_body_mapping_api_v3_insights_wellness_body_mapping_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"default":{"summary":"Body mapping analysis for Oleg","description":"Traditional medical astrology body system mapping","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Comprehensive astrological body mapping with health insights","content":{"application/json":{"schema":{},"examples":{"oleg_body_mapping":{"summary":"Oleg's Body System Analysis - Taurus Rising","description":"Complete body mapping for Oleg born in Kharkiv showing sensitive and strong systems","value":{"success":true,"data":{"constitutional_type":"Earth-Fire","dominant_element":"Earth","rising_sign":"Tau","health_house_sign":"Lib","health_house_ruler":"Venus","sensitive_systems":[{"system":"Throat and Neck","ruler":"Taurus Rising","description":"Taurus rising makes throat, neck, and thyroid particularly sensitive areas requiring extra care","recommendations":["Regular throat care","Neck massage","Thyroid monitoring"]},{"system":"Kidney and Balance","ruler":"Libra 6th House","description":"Libra ruling the health house emphasizes kidney function and body balance","recommendations":["Stay hydrated","Balance work and rest","Kidney-supporting foods"]}],"strong_systems":[{"system":"Heart and Circulation","ruler":"Leo Sun","description":"Strong Leo Sun provides robust heart function and vital energy","advantages":["Strong vitality","Good circulation","Leadership energy"]},{"system":"Digestive Fire","ruler":"Mars placement","description":"Well-aspected Mars supports strong digestion and metabolism","advantages":["Good metabolism","Strong appetite","Energy processing"]}],"elemental_balance":{"fire":35,"earth":40,"air":15,"water":10},"wellness_priorities":["Focus on throat and neck care","Maintain kidney health through hydration","Support natural vitality through heart-healthy activities","Balance physical activity with rest periods"],"preventive_recommendations":["Regular cardiovascular exercise to support Leo Sun vitality","Gentle neck stretches and throat care for Taurus rising","Balanced diet supporting kidney function","Stress management for overall harmony"]},"message":"Body mapping analysis completed","disclaimer":"For entertainment purposes only. Consult qualified healthcare providers for medical advice.","timestamp":"2024-01-15T10:30:00Z"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Missing birth time for body mapping","description":"Validation error when birth time is required for accurate body mapping analysis","value":{"success":false,"error":{"error_code":"MISSING_BIRTH_TIME","message":"Birth time is required for rising sign and house calculations in body mapping","field":"birth_data.hour","severity":"high","suggestions":["Provide exact birth time for accurate body mapping","Contact birth registry if time is unknown","Use sun sign analysis if exact time unavailable"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/wellness/body-mapping\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/body-mapping\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/body-mapping\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/wellness/body-mapping\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/wellness/body-mapping\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/wellness/biorhythms":{"post":{"tags":["🌿 Wellness Insights"],"summary":"Calculate Biorhythms","description":"〰️ **Biorhythm Calculator** - Physical, emotional, and intellectual cycles\n\n**Tracks:**\n- 💪 **Physical Cycle** - 23-day energy and strength rhythm\n- ❤️ **Emotional Cycle** - 28-day mood and sensitivity rhythm\n- 🧠 **Intellectual Cycle** - 33-day mental clarity rhythm\n- 🌙 **Lunar Influence** - Personal moon cycle overlay\n\n**What you get:**\n- **Current Values** - -100 to +100 for each rhythm\n- **Critical Days** - Transition points requiring care\n- **Lunar Phase** - Current moon influence\n- **Overall Vitality** - Combined energy assessment (text interpretation)\n- **Daily Recommendations** - What to focus on today (text interpretation)\n\n**Language Support:**\n- **English (en)** - Default language\n- **Russian (ru)** - Русские интерпретации\n- **French (fr)** - Interprétations françaises \n- **German (de)** - Deutsche Interpretationen\n- **Spanish (es)** - Interpretaciones españolas\n- **Italian (it)** - Interpretazioni italiane\n- **Portuguese (pt)** - Interpretações portuguesas\n- **Chinese (zh)** - 中文解释\n\n**Response time:** ~200ms | **Range:** Any date from birth","operationId":"calculate_biorhythms_api_v3_insights_wellness_biorhythms_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"default":{"summary":"Calculate biorhythms for today","description":"Physical, emotional and intellectual cycles for Oleg","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en"}}},"with_date":{"summary":"Calculate biorhythms for specific date","description":"Biorhythms with custom analysis date in Chinese","value":{"subject":{"name":"Li Wei","birth_data":{"year":1990,"month":8,"day":25,"hour":14,"minute":30,"city":"Beijing","country_code":"CN"}},"options":{"language":"zh"}}}}}},"required":true},"responses":{"200":{"description":"Complete biorhythm analysis with physical, emotional, and intellectual cycles","content":{"application/json":{"schema":{},"examples":{"oleg_high_energy_day":{"summary":"Oleg's Biorhythms - High Energy Day","description":"Strong biorhythmic day for Oleg with high physical and intellectual cycles","value":{"success":true,"data":{"analysis_date":"2024-01-15","days_since_birth":14159,"classic_biorhythms":{"physical":85,"emotional":45,"intellectual":92},"physical":85,"emotional":45,"intellectual":92,"lunar_influence":{"moon_phase":"Waxing Crescent","phase_energy":65,"sign":"Ari","personal_lunar_return_days":8},"critical_days":{"physical_critical":"2024-01-18","emotional_critical":"2024-01-22","intellectual_critical":"2024-01-25"},"overall_vitality":"High energy day with excellent physical strength and mental clarity. Your intellectual cycle is at its peak, making this ideal for complex problem-solving and creative work. Emotional energy is moderate, suggesting a balanced approach to feelings.","daily_recommendations":"Take advantage of your high physical energy for challenging workouts or demanding tasks. Your intellectual peak makes this perfect for learning, writing, or strategic planning. Be mindful that emotional energy is moderate - avoid making purely emotional decisions.","energy_forecast":{"next_3_days":"Physical energy remains high, intellectual begins to decline slightly, emotional rises","next_week":"Physical cycle enters declining phase, emotional reaches peak mid-week"}},"message":"Biorhythm calculation completed","timestamp":"2024-01-15T08:15:00Z"}},"li_wei_mixed_cycles":{"summary":"Li Wei's Biorhythms - Mixed Energy Day","description":"Balanced biorhythmic day for Li Wei with varying cycle strengths","value":{"success":true,"data":{"analysis_date":"2024-01-15","days_since_birth":12248,"classic_biorhythms":{"physical":15,"emotional":78,"intellectual":-25},"physical":15,"emotional":78,"intellectual":-25,"lunar_influence":{"moon_phase":"Full Moon","phase_energy":95,"sign":"Leo","personal_lunar_return_days":2},"critical_days":{"physical_critical":"2024-01-20","intellectual_critical":"2024-01-16"},"overall_vitality":"今天是情感高峰期，心理敏感度很高，适合处理人际关系和创造性工作。体力处于低位，需要充分休息。智力周期为负值，避免复杂的分析工作。","daily_recommendations":"专注于情感交流和人际关系建设。避免高强度体力活动，选择轻度运动如散步或瑜伽。推迟重要决策和复杂分析工作至明天。","energy_forecast":{"next_3_days":"体力开始恢复，情感保持高位，智力周期转向正值","next_week":"整体能量趋于平衡，各项指标稳步上升"}},"message":"Biorhythm calculation completed","timestamp":"2024-01-15T14:30:00Z"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid birth date for biorhythm calculation","description":"Validation error when birth date is invalid or too recent for meaningful biorhythm analysis","value":{"success":false,"error":{"error_code":"INVALID_BIRTH_DATE","message":"Birth date must be at least 30 days ago for meaningful biorhythm calculation","field":"birth_data.date","value":"2024-01-10","severity":"medium","suggestions":["Use a birth date at least 30 days in the past","Ensure date format is correct (YYYY-MM-DD)","Biorhythms require sufficient time elapsed since birth"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/wellness/biorhythms\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/biorhythms\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/biorhythms\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/wellness/biorhythms\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/wellness/biorhythms\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/wellness/wellness-timing":{"post":{"tags":["🌿 Wellness Insights"],"summary":"Find Wellness Timing","description":"📅 **Wellness Timing Optimizer** - Find best dates for health activities\n\n**Timing for:**\n- 🏥 **Surgery** - Optimal healing periods (consult doctors)\n- 🥗 **Detox** - Best cleansing windows\n- 💪 **Exercise Start** - Motivation and energy peaks\n- 🍎 **Diet Change** - Sustainable habit formation\n- 🧘 **Meditation** - Spiritual receptivity\n- 💚 **Healing** - Recovery and regeneration\n\n**Based on:**\n- Moon phases and signs\n- Personal transits\n- Biorhythm cycles\n- Planetary hours\n\n**Response time:** ~500ms | **Range:** Up to 90 days","operationId":"find_wellness_timing_api_v3_insights_wellness_wellness_timing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"surgery_timing":{"summary":"Surgery timing optimization","description":"Find optimal dates for surgical procedures","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"activity_type":"surgery","timeframe":"monthly","language":"en"}}},"detox_program":{"summary":"Detox program timing","description":"Plan cleansing and detox activities","value":{"subject":{"name":"Ivan","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"Kiev","country_code":"UA"}},"options":{"activity_type":"detox","timeframe":"weekly","language":"en"}}},"exercise_start":{"summary":"Exercise program launch","description":"Best time to start new fitness routine","value":{"subject":{"name":"Oksana","birth_data":{"year":1992,"month":3,"day":14,"hour":9,"minute":45,"city":"Lviv","country_code":"UA"}},"options":{"activity_type":"exercise","timeframe":"monthly","language":"ru"}}}}}},"required":true},"responses":{"200":{"description":"Optimal timing recommendations for health and wellness activities","content":{"application/json":{"schema":{},"examples":{"oleg_surgery_timing":{"summary":"Oleg's Surgery Timing - Optimal Healing Periods","description":"Best surgical timing for Oleg considering lunar phases and personal transits","value":{"success":true,"data":{"activity_type":"surgery","analysis_period":{"start":"2024-01-15","end":"2024-02-14"},"optimal_windows":[{"date":"2024-01-22","quality_score":95,"moon_phase":"Waning Gibbous","moon_sign":"Vir","reasoning":"Waning moon in Virgo excellent for precision procedures and healing initiation","time_window":"Morning 10:00-12:00","planetary_support":["Venus trine natal Sun","Mars sextile MC"]},{"date":"2024-02-05","quality_score":88,"moon_phase":"Waning Crescent","moon_sign":"Sag","reasoning":"Waning moon supports recovery, Jupiter influence aids healing","time_window":"Early afternoon 13:00-15:00","planetary_support":["Jupiter conjunction natal Venus","Sun trine natal Mars"]}],"avoid_periods":[{"date_range":"2024-01-25 to 2024-01-27","reason":"Full Moon in Leo - high inflammation potential","score":25},{"date_range":"2024-02-09 to 2024-02-11","reason":"New Moon with Mars square - delayed healing","score":30}],"general_guidelines":{"best_moon_phases":["Waning Gibbous","Third Quarter","Waning Crescent"],"best_moon_signs":["Vir","Cap","Tau"],"avoid_moon_signs":["Ari","Sco","Leo"],"ideal_planetary_hours":["Venus","Jupiter","Moon"]},"recovery_support":{"nutrition_timing":"Focus on anti-inflammatory foods during waning moon phases","rest_periods":"Plan 2-3 days post-procedure rest during supportive lunar transits","follow_up_timing":"Schedule follow-ups during waxing moon for tissue regeneration assessment"}},"message":"Wellness timing analysis completed","timestamp":"2024-01-15T09:45:00Z"}},"oksana_exercise_program":{"summary":"Oksana's Exercise Program Launch - Motivation Peaks","description":"Optimal timing for Oksana to start new fitness routine based on personal cycles","value":{"success":true,"data":{"activity_type":"exercise","analysis_period":{"start":"2024-01-15","end":"2024-02-14"},"optimal_windows":[{"date":"2024-01-20","quality_score":92,"moon_phase":"Waxing Gibbous","moon_sign":"Gem","reasoning":"Новолуние в Близнецах поддерживает новые начинания и ментальную мотивацию к фитнесу","time_window":"Утро 7:00-9:00","planetary_support":["Марс тригон Солнца","Венера секстиль Асцендента"]},{"date":"2024-02-03","quality_score":85,"moon_phase":"Waning Gibbous","moon_sign":"Sco","reasoning":"Убывающая Луна в Скорпионе идеальна для трансформации тела и интенсивных тренировок","time_window":"Вечер 18:00-20:00","planetary_support":["Плутон секстиль натального Марса","Луна тригон Юпитера"]}],"program_phases":{"initiation":"Start during New Moon in Gemini for mental commitment","building":"Increase intensity during Waxing phases","plateau_breaking":"Use Full Moon energy for breakthrough workouts","recovery":"Plan rest weeks during Waning phases"},"exercise_timing_by_moon":{"new_moon":"Планирование и легкие тренировки","waxing":"Наращивание интенсивности и силовые тренировки","full_moon":"Пиковые тренировки и соревновательная активность","waning":"Восстановление, растяжка, йога"}},"message":"Wellness timing analysis completed","timestamp":"2024-01-15T16:20:00Z"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid wellness activity type","description":"Validation error when unsupported wellness activity type is requested","value":{"success":false,"error":{"error_code":"INVALID_ACTIVITY_TYPE","message":"Unsupported wellness activity type for timing analysis","field":"activity_type","value":"invalid_activity","severity":"medium","suggestions":["Use supported activities: surgery, detox, exercise, diet, meditation, healing","See /api/v3/glossary for complete list of wellness activities"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-timing\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-timing\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-timing\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-timing\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-timing\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/wellness/energy-patterns":{"post":{"tags":["🌿 Wellness Insights"],"summary":"Analyze Energy Patterns","description":"⚡ **Energy Pattern Analysis** - Understand your natural rhythms\n\n**Discovers:**\n- 🌅 **Chronotype** - Morning person or night owl\n- ⏰ **Peak Hours** - When you're most productive\n- 📉 **Low Energy Times** - When to rest or do routine tasks\n- 📅 **Monthly Patterns** - Lunar cycle influence\n- 🍂 **Seasonal Patterns** - Yearly energy fluctuations\n\n**Personalized for:**\n- Exercise timing and style\n- Work schedule optimization\n- Recovery and rest needs\n- Energy management strategies\n\n**Response time:** ~300ms","operationId":"analyze_energy_patterns_api_v3_insights_wellness_energy_patterns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"default":{"summary":"Energy pattern analysis for Oleg","description":"Understand natural energy rhythms and chronotype","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en","analysis_period":"monthly"}}}}}},"required":true},"responses":{"200":{"description":"Comprehensive energy pattern analysis and chronotype assessment","content":{"application/json":{"schema":{},"examples":{"oleg_energy_patterns":{"summary":"Oleg's Energy Patterns - Fire-Earth Combination","description":"Complete energy rhythm analysis for Oleg showing strong morning and evening patterns","value":{"success":true,"data":{"chronotype":"Morning-Evening Hybrid","dominant_energy_element":"Fire-Earth","energy_constitution":"Strong vitality with steady endurance","daily_energy_curve":{"peak_hours":["07:00-09:00","19:00-21:00"],"low_energy_hours":["13:00-15:00","03:00-05:00"],"moderate_hours":["09:00-12:00","15:00-18:00"],"pattern_type":"Bimodal with strong morning and evening peaks"},"weekly_patterns":{"high_energy_days":["Sunday","Tuesday","Thursday"],"moderate_days":["Monday","Wednesday","Friday"],"recovery_day":"Saturday","solar_influence":"Leo Sun provides consistent vitality throughout week"},"monthly_patterns":{"new_moon_energy":"Lower but focused - ideal for planning","waxing_energy":"Building strength - perfect for starting projects","full_moon_energy":"Peak vitality - maximum output capacity","waning_energy":"Steady decline - good for completion and rest","personal_lunar_return":"Every 27.3 days - emotional and physical reset"},"seasonal_patterns":{"spring":"High initiation energy - start new health routines","summer":"Peak vitality period - maximum activity capacity","autumn":"Harvesting energy - focus on consolidation","winter":"Conservation mode - emphasize rest and restoration"},"optimization_recommendations":{"exercise_timing":"Schedule intense workouts 7-9 AM or 7-9 PM","work_schedule":"Handle demanding tasks during peak hours, routine work during moderate periods","recovery_needs":"Plan downtime 1-3 PM and ensure 7-8 hours sleep","nutrition_timing":"Largest meals during peak energy windows for optimal processing"},"energy_management_strategies":["Use morning peak for physical exercise and creative work","Schedule meetings and important decisions during moderate hours","Utilize evening peak for social activities and project completion","Respect natural afternoon dip with light activities or brief rest","Align major life changes with seasonal energy patterns"]},"message":"Energy pattern analysis completed","timestamp":"2024-01-15T11:20:00Z"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Insufficient birth data for energy pattern analysis","description":"Validation error when complete birth data is required for accurate energy pattern calculation","value":{"success":false,"error":{"error_code":"INSUFFICIENT_BIRTH_DATA","message":"Complete birth data including location is required for energy pattern analysis","field":"birth_data","value":{"year":1985,"month":5,"day":11},"severity":"high","suggestions":["Provide complete birth time and location for accurate analysis","Include city and country or precise coordinates","Energy patterns depend on sunrise/sunset times at birth location"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/wellness/energy-patterns\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/energy-patterns\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/energy-patterns\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/wellness/energy-patterns\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/wellness/energy-patterns\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/wellness/wellness-score":{"post":{"tags":["🌿 Wellness Insights"],"summary":"Calculate Wellness Score","description":"💯 **Wellness Score Calculator** - Comprehensive health potential assessment\n\n**Evaluates:**\n- 💪 **Physical Vitality** - Constitutional strength\n- ❤️ **Emotional Balance** - Mood stability potential\n- 🧠 **Mental Clarity** - Cognitive function support\n- 🕊️ **Spiritual Connection** - Inner peace capacity\n\n**Factors:**\n- Natal chart indicators\n- Current transit influences\n- Biorhythm positions\n- Lunar phase effects\n\n**What you get:**\n- Overall wellness score (0-100)\n- Category breakdowns\n- Current influences assessment\n- Personalized recommendations\n- Focus areas for improvement\n\n**Response time:** ~400ms","operationId":"calculate_wellness_score_api_v3_insights_wellness_wellness_score_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"default":{"summary":"Wellness score calculation for Oleg","description":"Comprehensive health potential assessment","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en"}}}}}},"required":true},"responses":{"200":{"description":"Comprehensive wellness potential assessment with detailed scoring","content":{"application/json":{"schema":{},"examples":{"oleg_wellness_score":{"summary":"Oleg's Wellness Score - Strong Constitutional Foundation","description":"Complete wellness assessment for Oleg showing high vitality and balanced health potential","value":{"success":true,"data":{"overall_score":82,"wellness_score":82,"assessment_date":"2024-01-15","category_scores":{"physical_vitality":{"score":88,"description":"Excellent constitutional strength with Leo Sun providing robust vital energy","key_factors":["Strong solar vitality","Good Mars placement","Healthy elemental balance"],"recommendations":["Maintain regular cardiovascular exercise","Support heart health","Use natural leadership energy"]},"emotional_balance":{"score":75,"description":"Good emotional stability with some sensitivity requiring attention","key_factors":["Balanced lunar aspects","Venus support","Occasional intensity"],"recommendations":["Regular emotional check-ins","Creative expression","Stress management practices"]},"mental_clarity":{"score":85,"description":"Sharp mental function with excellent problem-solving capabilities","key_factors":["Strong Mercury placement","Good air sign support","Clear communication"],"recommendations":["Engage in continuous learning","Practice mindfulness","Share knowledge with others"]},"spiritual_connection":{"score":78,"description":"Developing spiritual awareness with natural wisdom potential","key_factors":["Jupiter aspects","9th house influences","Natural philosophy"],"recommendations":["Explore philosophical studies","Nature connection","Meditation practice"]}},"current_influences":{"supporting_transits":[{"transit":"Jupiter trine natal Sun","effect":"Enhanced vitality and optimism","duration":"3 months","wellness_impact":"+15% overall energy"},{"transit":"Venus sextile natal Mars","effect":"Harmonious energy flow and motivation","duration":"2 weeks","wellness_impact":"+10% emotional balance"}],"challenging_transits":[{"transit":"Saturn square natal Moon","effect":"Emotional restrictions requiring patience","duration":"6 months","wellness_impact":"-5% emotional flexibility"}]},"biorhythm_influence":{"physical_cycle":85,"emotional_cycle":45,"intellectual_cycle":92,"overall_biorhythm_score":74,"impact_on_wellness":"High physical and intellectual energy supports current wellness score"},"lunar_phase_effect":{"current_phase":"Waxing Crescent","energy_modifier":"+8%","wellness_support":"Building energy phase supports growth and improvement initiatives"},"personalized_recommendations":["Focus on cardiovascular health to support your strong Leo Sun vitality","Develop emotional awareness practices during current Saturn transit","Leverage high intellectual cycle for health education and planning","Use waxing moon energy to establish new wellness routines"],"focus_areas_for_improvement":["Emotional flexibility during challenging transits","Stress management techniques","Regular sleep schedule optimization","Balanced nutrition supporting high energy demands"],"next_wellness_review":"2024-02-15","score_trend":"Stable with potential for 5-10 point improvement through targeted practices"},"message":"Wellness score calculated successfully","timestamp":"2024-01-15T13:45:00Z"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Incomplete chart data for wellness scoring","description":"Validation error when insufficient astrological data prevents accurate wellness assessment","value":{"success":false,"error":{"error_code":"INCOMPLETE_CHART_DATA","message":"Complete birth chart data is required for accurate wellness scoring","field":"birth_data","value":{"year":1985},"severity":"high","suggestions":["Provide complete birth date (year, month, day)","Include birth time for house calculations","Add location for precise planetary positions"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-score\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-score\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-score\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-score\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/wellness/wellness-score\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/wellness/moon-wellness":{"post":{"tags":["🌿 Wellness Insights"],"summary":"Get Moon Wellness Calendar","description":"🌙 **Moon Wellness Calendar** - Lunar health and wellness guide\n\n**Moon Phases for Wellness:**\n- 🌑 **New Moon** - Set intentions, begin new health habits\n- 🌒 **Waxing** - Build energy, increase activity\n- 🌕 **Full Moon** - Peak energy, emotional release\n- 🌘 **Waning** - Detox, release, rest and recovery\n\n**Daily Guidance:**\n- Best activities for each moon phase\n- Emotional wellness tips\n- Physical activity recommendations\n- Dietary suggestions\n- Sleep and rest guidance\n\n**Response time:** ~300ms | **Range:** Up to 60 days","operationId":"get_moon_wellness_calendar_api_v3_insights_wellness_moon_wellness_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleSubjectRequest"},"examples":{"default":{"summary":"Moon wellness calendar for Oleg","description":"Lunar health and wellness guide","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en","focus_area":"general","period":"month"}}}}}},"required":true},"responses":{"200":{"description":"Comprehensive lunar wellness calendar with phase-based health guidance","content":{"application/json":{"schema":{},"examples":{"oleg_moon_wellness_calendar":{"summary":"Oleg's 30-Day Lunar Wellness Calendar","description":"Complete lunar health guidance for Oleg with personalized moon phase recommendations","value":{"success":true,"data":{"start_date":"2024-01-15T00:00:00","end_date":"2024-02-14T23:59:59","focus_area":"general","moon_phases":{"current_phase":"Waxing Crescent","current_illumination":25.5,"current_sign":"Ari","upcoming_phases":[{"phase":"First Quarter","date":"2024-01-25","sign":"Tau","wellness_focus":"Building strength and establishing routines"},{"phase":"Full Moon","date":"2024-01-25","sign":"Leo","wellness_focus":"Peak energy and emotional release"},{"phase":"Third Quarter","date":"2024-02-02","sign":"Sco","wellness_focus":"Deep healing and transformation"},{"phase":"New Moon","date":"2024-02-09","sign":"Aqu","wellness_focus":"Innovation in health practices"}]},"wellness_guidance":{"new_moon":{"focus":"New beginnings and intention setting","activities":["Start new health routines","Set wellness goals","Gentle detox","Planning and visioning"],"avoid":["Surgery","Intense physical activity","Major health decisions"],"nutrition":"Light, cleansing foods and increased hydration","energy_level":"Low to moderate - honor need for rest"},"waxing":{"focus":"Building energy and strength","activities":["Increase exercise intensity","Build muscle","Social activities","Skill development"],"avoid":["Major detox","Fasting","Depleting activities"],"nutrition":"Nourishing, building foods with adequate protein","energy_level":"Steadily increasing - perfect for growth"},"full_moon":{"focus":"Peak energy and release","activities":["High-intensity exercise","Emotional processing","Celebrations","Peak performance"],"avoid":["Surgery","Starting new routines","Overexertion"],"nutrition":"Balanced meals with focus on emotional comfort foods","energy_level":"Maximum - channel productively"},"waning":{"focus":"Release and restoration","activities":["Detox programs","Rest and recovery","Meditation","Letting go practices"],"avoid":["Starting new projects","Intense training","Major commitments"],"nutrition":"Cleansing foods, reduced portions, mindful eating","energy_level":"Decreasing - emphasize restoration"}},"daily_recommendations":[{"date":"2024-01-15","moon_phase":"Waxing Crescent","moon_sign":"Ari","energy_level":65,"focus":"Initiate new fitness routine with moderate intensity","activities":["Light cardio","Goal setting","Energy assessment"],"nutrition":"Energizing breakfast, balanced meals","avoid":"Pushing too hard too fast"},{"date":"2024-01-25","moon_phase":"Full Moon","moon_sign":"Leo","energy_level":95,"focus":"Celebrate progress, high-energy activities","activities":["Intense workout","Social fitness","Performance"],"nutrition":"Hearty, celebratory meals with loved ones","avoid":"Overindulgence, emotional eating"},{"date":"2024-02-02","moon_phase":"Third Quarter","moon_sign":"Sco","energy_level":45,"focus":"Deep healing and transformation work","activities":["Yoga","Therapy","Cleansing","Reflection"],"nutrition":"Detoxifying foods, herbal teas","avoid":"Stimulants, heavy foods"}],"personal_lunar_insights":{"natal_moon_sign":"Pis","moon_return_dates":["2024-01-22","2024-02-18"],"sensitive_lunar_transits":["Moon opposite natal Moon (emotional peaks)","Moon conjunct natal Sun (vitality boosts)"],"optimal_healing_periods":"When Moon transits your natal 6th house (health) and 12th house (healing)"}},"message":"Moon wellness calendar created for 30 days","timestamp":"2024-01-15T12:00:00Z"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Request validation failed","content":{"application/json":{"examples":{"validation_error":{"summary":"Invalid period for moon wellness calendar","description":"Validation error when requested time period exceeds supported range","value":{"success":false,"error":{"error_code":"INVALID_TIME_PERIOD","message":"Moon wellness calendar period cannot exceed 90 days","field":"period","value":"6_months","severity":"medium","suggestions":["Use supported periods: week, month, quarter (90 days max)","For longer periods, make multiple requests","Lunar patterns repeat every 29.5 days"]},"timestamp":"2024-01-01T12:00:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/wellness/moon-wellness\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/moon-wellness\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/wellness/moon-wellness\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/wellness/moon-wellness\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/wellness/moon-wellness\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/financial/market-timing":{"post":{"tags":["💰 Financial Insights"],"summary":"Analyze Market Timing","description":"📈 **Market Timing Analysis** - Planetary cycles and market correlations\n\n**Based on:**\n- 🌙 Lunar phases and market volatility\n- 🪐 Planetary aspects and sentiment shifts\n- 📊 Sector rotation by planetary rulership\n- 🔄 Major planetary cycles (Jupiter, Saturn, Uranus)\n\n**What you get:**\n- **Market Bias** - Bullish/bearish/neutral outlook\n- **Volatility Forecast** - Expected market turbulence\n- **Sector Recommendations** - Which sectors align with cycles\n- **Key Dates** - Important turning points\n- **Risk Windows** - Periods requiring caution\n\n**Response time:** ~400ms | **Range:** Up to 90 days","operationId":"analyze_market_timing_api_v3_insights_financial_market_timing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketTimingRequest"},"examples":{"default":{"summary":"Market timing analysis","value":{"start_date":"2024-01-01","end_date":"2024-01-31","markets":["stocks","crypto"],"language":"en"}}}}},"required":true},"responses":{"200":{"description":"Market timing analysis completed successfully","content":{"application/json":{"schema":{},"examples":{"stocks_analysis":{"summary":"Stock market timing analysis","description":"30-day stock market cycle analysis with volatility forecast","value":{"success":true,"data":{"market_bias":"bullish","volatility_forecast":"moderate","analysis_period":{"start_date":"2024-01-01","end_date":"2024-01-31"},"key_dates":[{"date":"2024-01-15","event":"New Moon - Market momentum shift","significance":"high"},{"date":"2024-01-24","event":"Mars-Jupiter trine - Bullish sentiment","significance":"moderate"}],"sector_recommendations":[{"sector":"Technology","planetary_ruler":"Uranus","recommendation":"favored","confidence":0.75},{"sector":"Healthcare","planetary_ruler":"Virgo/Mercury","recommendation":"neutral","confidence":0.6}],"risk_windows":[{"start":"2024-01-08","end":"2024-01-12","reason":"Mercury retrograde station","risk_level":"high"}],"planetary_cycles":{"jupiter_cycle":"expansion phase","saturn_cycle":"consolidation","mars_cycle":"active trading"}},"message":"Market timing analysis completed","disclaimer":"For educational purposes only. Not financial advice."}},"crypto_analysis":{"summary":"Crypto market timing analysis","description":"Bitcoin-focused timing with lunar correlation patterns","value":{"success":true,"data":{"market_bias":"neutral","volatility_forecast":"high","analysis_period":{"start_date":"2024-01-01","end_date":"2024-01-31"},"key_dates":[{"date":"2024-01-11","event":"Full Moon - Retail FOMO peak","significance":"high"},{"date":"2024-01-20","event":"Uranus station direct - Innovation cycle","significance":"moderate"}],"sector_recommendations":[{"sector":"Bitcoin","planetary_ruler":"Uranus","recommendation":"accumulate","confidence":0.68},{"sector":"DeFi","planetary_ruler":"Neptune","recommendation":"cautious","confidence":0.45}],"lunar_correlation":{"next_new_moon":"2024-01-25","correlation_strength":0.72,"pattern":"buying_pressure_increases"}},"message":"Market timing analysis completed","disclaimer":"For educational purposes only. Not financial advice."}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in request parameters","content":{"application/json":{"examples":{"invalid_date_range":{"summary":"Date range too long","description":"Analysis period exceeds 90-day maximum limit","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Date range cannot exceed 90 days","field":"date_range","value":"120 days","severity":"medium","suggestions":["Reduce the date range to 90 days or less","Split analysis into multiple shorter periods"]},"timestamp":"2024-01-15T10:30:00Z"}},"invalid_market":{"summary":"Unsupported market type","description":"Market type not supported for analysis","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Unsupported market type","field":"markets","value":"commodities_futures","severity":"low","suggestions":["Use supported markets: stocks, crypto, forex","See /api/v3/glossary/markets for complete list"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/financial/market-timing\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/market-timing\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/market-timing\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/financial/market-timing\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/financial/market-timing\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/financial/personal-trading":{"post":{"tags":["💰 Financial Insights"],"summary":"Analyze Personal Trading Windows","description":"🎯 **Personal Trading Windows** - Your optimal trading times\n\n**Analyzes:**\n- 🧠 Mental clarity periods for decision-making\n- 💰 Financial luck cycles from Jupiter\n- ⚠️ Risk periods from challenging transits\n- 🎲 Speculation windows from Neptune/Uranus\n- 📊 Best sectors based on your chart\n\n**Trading Styles:**\n- **Day Trading** - Intraday mental acuity\n- **Swing Trading** - Multi-day momentum\n- **Position Trading** - Weeks to months\n- **Investment** - Long-term cycles\n\n**What you get:**\n- **Optimal Trading Days** - Your best performance windows\n- **Risk Profile** - Current risk tolerance\n- **Sector Affinity** - Markets aligned with your energy\n- **Avoid Periods** - When to stay flat\n\n**Response time:** ~500ms","operationId":"analyze_personal_trading_windows_api_v3_insights_financial_personal_trading_post","requestBody":{"content":{"application/json":{"schema":{"title":"Request Data"},"examples":{"standard_format":{"summary":"Personal trading analysis (standard format)","description":"Using the new standardized request format with subject and options","value":{"subject":{"name":"Test User","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"trading_style":"day_trading","analysis_period_days":30,"include_lunar_cycles":true,"language":"en"}}},"legacy_format":{"summary":"Legacy format (backward compatible)","description":"Old format still supported through request adapter","value":{"birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"},"analysis_period_days":30,"include_lunar_cycles":true,"trading_style":"swing","language":"en"}}}}},"required":true},"responses":{"200":{"description":"Personal trading windows analysis completed successfully","content":{"application/json":{"schema":{},"examples":{"oleg_swing_trading":{"summary":"Swing trading analysis for Oleg","description":"30-day swing trading windows for Ukrainian trader born in Kharkiv","value":{"success":true,"data":{"optimal_trading_days":[{"date":"2024-01-15","quality":"excellent","mental_clarity":0.92,"financial_luck":0.78,"aspects":["Mercury trine natal Jupiter - Clear thinking","Venus sextile natal Venus - Good timing"]},{"date":"2024-01-22","quality":"good","mental_clarity":0.85,"financial_luck":0.71,"aspects":["Sun conjunct natal Mercury - Mental focus"]}],"risk_profile":{"current_tolerance":"moderate","jupiter_influence":"expanding confidence","saturn_influence":"cautious approach","mars_influence":"aggressive entries"},"sector_affinity":[{"sector":"Technology","planetary_connection":"Uranus in 6th house","strength":0.82,"reasoning":"Innovation and daily work alignment"},{"sector":"Healthcare","planetary_connection":"Virgo influence","strength":0.65,"reasoning":"Service-oriented Virgo energy"}],"avoid_periods":[{"start":"2024-01-08","end":"2024-01-12","reason":"Mercury square natal Mars - Impulsive decisions","severity":"high"},{"start":"2024-01-28","end":"2024-01-30","reason":"Mars opposite natal Sun - Ego conflicts","severity":"moderate"}],"lunar_cycles":{"new_moon_effect":"increased optimism, good for entries","full_moon_effect":"emotional decisions, avoid major trades","next_favorable_moon":"2024-01-25"},"trading_style_compatibility":{"swing":0.88,"day":0.62,"position":0.75,"reasoning":"Mercury-Jupiter trine favors medium-term decisions"}},"disclaimer":"For educational purposes only. Trade at your own risk.","message":"Personal trading analysis completed"}},"day_trading_analysis":{"summary":"Day trading mental clarity","description":"Intraday optimal performance windows based on birth chart","value":{"success":true,"data":{"optimal_trading_days":[{"date":"2024-01-16","quality":"excellent","mental_clarity":0.95,"financial_luck":0.73,"best_hours":["09:30-11:00 EST","14:00-15:30 EST"],"aspects":["Moon trine natal Mercury - Sharp intuition","Mercury sextile natal Ascendant - Quick decisions"]}],"mental_performance_pattern":{"peak_hours":"10:00-12:00 local time","mercury_influence":"strong analytical ability","moon_cycle_sensitivity":0.68},"trading_style_compatibility":{"day":0.91,"scalping":0.58,"reasoning":"Quick Mercury aspects favor rapid decisions"}},"disclaimer":"For educational purposes only. Trade at your own risk.","message":"Personal trading analysis completed"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in birth data or trading parameters","content":{"application/json":{"examples":{"invalid_birth_data":{"summary":"Invalid birth coordinates","description":"Birth location cannot be resolved","value":{"success":false,"error":{"error_code":"INVALID_LOCATION","message":"Cannot resolve birth location","field":"birth_data.city","value":"UnknownCity","severity":"high","suggestions":["Check city name spelling","Provide latitude/longitude coordinates","Include valid country_code"]},"timestamp":"2024-01-15T10:30:00Z"}},"invalid_trading_style":{"summary":"Unsupported trading style","description":"Trading style not recognized","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Invalid trading style","field":"trading_style","value":"algorithmic","severity":"low","suggestions":["Use supported styles: swing, day, position","See documentation for style descriptions"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/financial/personal-trading\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/personal-trading\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/personal-trading\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/financial/personal-trading\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/financial/personal-trading\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/financial/gann-analysis":{"post":{"tags":["💰 Financial Insights"],"summary":"Calculate Gann Cycles","description":"📐 **W.D. Gann Cycle Analysis** - Time and price calculations\n\n**Gann Techniques:**\n- 🔄 Planetary cycle periods\n- 📐 Geometric angles (45°, 90°, 180°, 360°)\n- 📅 Time cycles and squares\n- 🎯 Support/resistance levels\n- 🌟 Natural time periods\n\n**Calculations:**\n- **Major Cycles** - Jupiter (12yr), Saturn (29yr)\n- **Minor Cycles** - Mercury, Venus, Mars\n- **Gann Angles** - Price/time relationships\n- **Square of Nine** - Price targets\n\n**Response time:** ~300ms | **Accuracy:** Based on astronomical precision","operationId":"calculate_gann_cycles_api_v3_insights_financial_gann_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_calculate_gann_cycles_api_v3_insights_financial_gann_analysis_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error - check input data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/financial/gann-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/gann-analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/gann-analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/financial/gann-analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/financial/gann-analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/financial/bradley-siderograph":{"post":{"tags":["💰 Financial Insights"],"summary":"Calculate Bradley Turns","description":"📉 **Bradley Siderograph** - Major market turning points\n\n**Donald Bradley's Method:**\n- 🌌 Planetary aspects sum\n- 📊 Market sentiment indicator\n- 🔄 Major trend reversals\n- 📅 Turn dates (+/- 4 days)\n\n**Identifies:**\n- **Major Turns** - Significant trend changes\n- **Minor Turns** - Short-term reversals\n- **Trend Direction** - Up or down bias\n- **Intensity** - Strength of the turn\n\n**Historical Accuracy:**\n- Major turns: ~70% within 4 trading days\n- Works best with indices, not individual stocks\n\n**Flexible Input:**\n- **Period-based** - \"yearly\", \"quarterly\", \"monthly\"\n- **Year extraction** - Automatically determines year from period\n- **Personal data** - Optional birth data for enhanced analysis\n- **Language support** - Multi-language interpretations\n\n**Response time:** ~400ms | **Range:** Full year analysis","operationId":"calculate_bradley_turns_api_v3_insights_financial_bradley_siderograph_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BradleySiderographRequest"},"examples":{"yearly_analysis":{"summary":"Yearly Bradley Siderograph analysis","description":"Calculate major market turning points for entire year","value":{"birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"},"period":"yearly","market":"stocks","year":2024,"language":"en"}},"quarterly_analysis":{"summary":"Quarterly Bradley analysis","description":"Focused quarterly analysis with personal birth data","value":{"birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"},"period":"quarterly","market":"crypto","language":"en"}},"legacy_test_format":{"summary":"Legacy test format support","description":"Backward compatibility with existing test format","value":{"analysis_date":{"year":2024,"month":10,"day":1},"market":"US_STOCKS","period":"yearly","language":"en"}},"simple_yearly":{"summary":"Simple yearly without birth data","description":"General market analysis without personal data","value":{"period":"yearly","market":"stocks","year":2024,"language":"en"}}}}},"required":true},"responses":{"200":{"description":"Bradley Siderograph analysis completed successfully","content":{"application/json":{"schema":{},"examples":{"yearly_bradley_analysis":{"summary":"Full year Bradley Siderograph","description":"2024 major market turning points with personal birth data","value":{"success":true,"data":{"year":2024,"period":"yearly","market":"stocks","siderograph_value":-23.7,"market_stress":"low","rating":"neutral","has_birth_data":true,"major_turns":[{"date":"2024-03-15","direction":"bearish","intensity":0.78,"bradley_value":-45.2,"planetary_aspects":["Mars square Jupiter","Mercury opposition Saturn"],"confidence":0.72},{"date":"2024-06-21","direction":"bullish","intensity":0.85,"bradley_value":62.1,"planetary_aspects":["Sun trine Jupiter","Venus conjunction Mercury"],"confidence":0.81},{"date":"2024-09-23","direction":"bearish","intensity":0.69,"bradley_value":-38.4,"planetary_aspects":["Saturn square Mercury","Mars opposition Venus"],"confidence":0.68}],"minor_turns":[{"date":"2024-02-08","direction":"bullish","intensity":0.45,"bradley_value":28.6},{"date":"2024-04-12","direction":"bearish","intensity":0.52,"bradley_value":-31.2},{"date":"2024-07-18","direction":"bullish","intensity":0.48,"bradley_value":33.7}],"chart_data":[{"date":"2024-01-01T00:00:00","value":-12.3},{"date":"2024-01-08T00:00:00","value":18.7},{"date":"2024-01-15T00:00:00","value":-8.2}],"interpretation":"Watch for trend changes around major turn dates"},"message":"Bradley Siderograph calculated for 2024 (yearly)","disclaimer":"Historical market timing method for research purposes"}},"quarterly_crypto_bradley":{"summary":"Quarterly crypto Bradley analysis","description":"Q1 2024 crypto market turning points with enhanced volatility","value":{"success":true,"data":{"year":2024,"period":"quarterly","market":"crypto","siderograph_value":41.2,"market_stress":"moderate","rating":"bullish","has_birth_data":true,"major_turns":[{"date":"2024-01-25","direction":"bullish","intensity":0.82,"bradley_value":55.3,"crypto_factors":["Uranus trine - Innovation surge","Neptune sextile - Speculation wave"],"confidence":0.74},{"date":"2024-03-08","direction":"bearish","intensity":0.67,"bradley_value":-42.8,"crypto_factors":["Saturn square - Regulation fears","Mars retrograde - Selling pressure"],"confidence":0.71}],"crypto_specific_analysis":{"lunar_correlation":0.68,"retail_sentiment_peaks":["2024-01-11","2024-02-09","2024-03-10"],"institutional_flow_dates":["2024-01-15","2024-02-15","2024-03-15"]}},"message":"Bradley Siderograph calculated for 2024 (quarterly)","disclaimer":"Historical market timing method for research purposes"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in Bradley Siderograph parameters","content":{"application/json":{"examples":{"invalid_year":{"summary":"Invalid analysis year","description":"Year outside supported calculation range","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Year outside supported range","field":"year","value":1800,"severity":"medium","suggestions":["Use years between 1900-2100","Current year analysis recommended for accuracy"]},"timestamp":"2024-01-15T10:30:00Z"}},"invalid_period":{"summary":"Unsupported analysis period","description":"Period type not supported for Bradley calculation","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Invalid analysis period","field":"period","value":"weekly","severity":"low","suggestions":["Use supported periods: yearly, quarterly, monthly","Yearly analysis provides best accuracy"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/financial/bradley-siderograph\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/bradley-siderograph\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/bradley-siderograph\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/financial/bradley-siderograph\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/financial/bradley-siderograph\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/financial/crypto-timing":{"post":{"tags":["💰 Financial Insights"],"summary":"Analyze Crypto Timing","description":"₿ **Crypto Market Timing** - 24/7 market cycle analysis\n\n**Crypto-Specific Factors:**\n- 🌙 Lunar correlation (retail sentiment)\n- ⚡ Uranus cycles (innovation/disruption)\n- 🌊 Neptune cycles (speculation/delusion)\n- 🪐 Saturn cycles (regulation/structure)\n\n**Analysis Includes:**\n- **Volatility Windows** - High movement periods\n- **Accumulation Zones** - Good entry timing\n- **Distribution Signals** - Exit considerations\n- **Social Sentiment** - Mass psychology cycles\n- **DCA Optimization** - Best regular buy days\n\n**24/7 Market Considerations:**\n- Weekend patterns\n- Asian/European/US session timing\n- Full moon volatility spikes\n\n**Response time:** ~400ms","operationId":"analyze_crypto_timing_api_v3_insights_financial_crypto_timing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoTimingRequest"},"examples":{"default":{"summary":"Crypto timing analysis","value":{"cryptocurrency":"bitcoin","analysis_period_days":30,"include_volatility_forecast":true,"language":"en"}}}}},"required":true},"responses":{"200":{"description":"Crypto market timing analysis completed successfully","content":{"application/json":{"schema":{},"examples":{"bitcoin_timing_analysis":{"summary":"Bitcoin 30-day timing analysis","description":"Comprehensive Bitcoin market timing with volatility forecast","value":{"success":true,"data":{"cryptocurrency":"bitcoin","analysis_type":"general_market","include_volatility_forecast":true,"analysis_period":{"start_date":"2024-01-15","end_date":"2024-02-14"},"volatility_windows":[{"start":"2024-01-20","end":"2024-01-23","intensity":"high","cause":"Full Moon + Uranus aspect","expected_movement":"15-25%"},{"start":"2024-02-05","end":"2024-02-08","intensity":"moderate","cause":"Mercury-Mars conjunction","expected_movement":"8-15%"}],"accumulation_zones":[{"date":"2024-01-25","quality":"excellent","lunar_phase":"new_moon","planetary_support":"Venus trine Jupiter","confidence":0.78},{"date":"2024-02-10","quality":"good","lunar_phase":"waning_crescent","planetary_support":"Sun sextile Saturn","confidence":0.65}],"distribution_signals":[{"date":"2024-01-29","risk_level":"moderate","lunar_phase":"waning_gibbous","warning_signs":"Mars square Neptune - delusion peak"}],"social_sentiment":{"current_phase":"cautious optimism","fear_greed_planetary":"Venus influence - moderate greed","retail_activity_forecast":"increasing","next_sentiment_shift":"2024-01-28"},"dca_optimization":{"best_weekly_day":"Wednesday","avoid_days":["Sunday","Monday"],"lunar_timing":"2-3 days after new moon","planetary_timing":"Venus or Jupiter aspects"},"weekend_patterns":{"saturday_tendency":"consolidation","sunday_tendency":"low volume accumulation","monday_gap_probability":0.68},"session_analysis":{"asian_session":"accumulation favored","european_session":"breakout potential","us_session":"high volatility","weekend_session":"thin liquidity"},"planetary_influences":{"uranus":"innovation cycles - major moves","neptune":"speculation waves - retail FOMO","saturn":"regulation cycles - structural changes","jupiter":"institutional adoption - bull markets"}},"disclaimer":"Crypto markets are highly volatile. Not financial advice.","message":"Crypto timing analysis for bitcoin completed"}},"ethereum_volatility_forecast":{"summary":"Ethereum volatility analysis","description":"ETH-specific timing with DeFi protocol correlations","value":{"success":true,"data":{"cryptocurrency":"ethereum","analysis_type":"general_market","include_volatility_forecast":true,"volatility_windows":[{"start":"2024-01-18","end":"2024-01-21","intensity":"high","cause":"Mercury retrograde + DeFi protocol updates","expected_movement":"12-20%","defi_correlation":0.85}],"smart_contract_timing":{"upgrade_windows":"Avoid major trades","gas_fee_optimization":"Sunday early hours","network_activity_peak":"Tuesday-Thursday"},"institutional_flow":{"staking_trends":"increasing before upgrades","liquid_staking_impact":"moderate volatility","validator_activity":"stable"}},"disclaimer":"Crypto markets are highly volatile. Not financial advice.","message":"Crypto timing analysis for ethereum completed"}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in crypto timing parameters","content":{"application/json":{"examples":{"unsupported_cryptocurrency":{"summary":"Cryptocurrency not supported","description":"Analysis not available for specified cryptocurrency","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Cryptocurrency not supported for analysis","field":"cryptocurrency","value":"shiba_inu","severity":"low","suggestions":["Use major cryptocurrencies: bitcoin, ethereum, litecoin","See /api/v3/glossary/cryptocurrencies for complete list"]},"timestamp":"2024-01-15T10:30:00Z"}},"invalid_analysis_period":{"summary":"Analysis period too long","description":"Crypto analysis period exceeds maximum limit","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Analysis period too long for crypto markets","field":"analysis_period_days","value":120,"severity":"medium","suggestions":["Limit crypto analysis to 90 days maximum","Use shorter periods for higher accuracy"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/financial/crypto-timing\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/crypto-timing\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/crypto-timing\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/financial/crypto-timing\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/financial/crypto-timing\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/financial/forex-timing":{"post":{"tags":["💰 Financial Insights"],"summary":"Analyze Forex Timing","description":"💱 **Forex Market Timing** - Currency pair cycle analysis\n\n**Session-Based Analysis:**\n- 🇦🇺 **Sydney** - AUD, NZD strength\n- 🇯🇵 **Tokyo** - JPY, Asian currencies\n- 🇬🇧 **London** - EUR, GBP movements\n- 🇺🇸 **New York** - USD dominance\n\n**Planetary Correlations:**\n- **Mercury** - Short-term volatility\n- **Venus** - Value and balance\n- **Mars** - Aggressive moves\n- **Jupiter** - Expansion trends\n\n**What you get:**\n- **Session Strength** - Best trading hours\n- **Volatility Forecast** - Pip movement potential\n- **Trend Bias** - Directional tendency\n- **Key Levels** - Planetary support/resistance\n\n**Response time:** ~300ms | **Range:** Up to 30 days","operationId":"analyze_forex_timing_api_v3_insights_financial_forex_timing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_analyze_forex_timing_api_v3_insights_financial_forex_timing_post"}}}},"responses":{"200":{"description":"Forex market timing analysis completed successfully","content":{"application/json":{"schema":{},"examples":{"eurusd_london_session":{"summary":"EUR/USD London session analysis","description":"Weekly EUR/USD timing optimized for London trading hours","value":{"success":true,"data":{"pair":"EUR/USD","session":"london","session_times_utc":{"open":8,"close":17},"forecast_period":{"start":"2024-01-15T00:00:00","end":"2024-01-22T00:00:00"},"volatility_forecast":"moderate","trend_bias":"neutral to bullish","best_entry_times":["London open + 1 hour","London close - 1 hour"],"optimal_trading_days":[{"date":"2024-01-16","day_of_week":"Tuesday","volatility_rating":"high","pip_potential":"80-120","session_overlap":"London-NewYork","planetary_aspects":["Mercury trine Jupiter - Clear ECB communication","Venus sextile Mars - Balanced risk appetite"]},{"date":"2024-01-18","day_of_week":"Thursday","volatility_rating":"moderate","pip_potential":"60-90","session_overlap":"London only","planetary_aspects":["Sun conjunct Mercury - Central bank focus"]}],"currency_strength_analysis":{"EUR":{"strength_rating":0.72,"planetary_ruler":"Venus","current_influence":"stability seeking","key_factors":["ECB policy","EU economic data"]},"USD":{"strength_rating":0.68,"planetary_ruler":"Mars","current_influence":"moderate aggression","key_factors":["Fed policy","Treasury yields"]}},"session_characteristics":{"london_session":{"typical_range":"70-100 pips","best_pairs":["EUR/USD","GBP/USD","EUR/GBP"],"volatility_peak":"09:00-11:00 UTC","trend_continuation":0.65}},"key_levels":{"planetary_support":1.085,"planetary_resistance":1.092,"venus_level":1.0885,"mars_level":1.0865},"planetary_influences":{"mercury":"High frequency trading favorable","venus":"Value plays recommended","mars":"Momentum trades active","jupiter":"Expansion bias for EUR"},"risk_management":{"recommended_risk":"1-2% per trade","stop_loss_guidance":"Below session low/high","position_sizing":"Reduce size during Mercury retrograde"}},"message":"Forex timing analysis for EUR/USD completed","disclaimer":"Forex trading involves substantial risk. Not financial advice."}},"usdjpy_tokyo_session":{"summary":"USD/JPY Tokyo session analysis","description":"Asian hours JPY analysis with carry trade considerations","value":{"success":true,"data":{"pair":"USD/JPY","session":"tokyo","session_times_utc":{"open":0,"close":9},"forecast_period":{"start":"2024-01-15T00:00:00","end":"2024-01-22T00:00:00"},"volatility_forecast":"low-moderate","trend_bias":"range-bound","carry_trade_analysis":{"interest_rate_differential":5.25,"carry_attractiveness":"high","risk_on_sentiment":"moderate","boj_intervention_risk":"low at current levels"},"tokyo_specific_factors":{"boj_meeting_proximity":"none this week","japanese_data_releases":["Tokyo CPI - Tuesday","Trade Balance - Thursday"],"nikkei_correlation":0.72,"jgb_yield_sensitivity":"high"},"session_characteristics":{"typical_range":"40-70 pips","trend_strength":"weak in isolation","reversal_probability":0.45,"best_strategy":"range trading"}},"message":"Forex timing analysis for USD/JPY completed","disclaimer":"Forex trading involves substantial risk. Not financial advice."}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in forex timing parameters","content":{"application/json":{"examples":{"invalid_currency_pair":{"summary":"Unsupported currency pair","description":"Currency pair not available for analysis","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Currency pair not supported","field":"pair","value":"BTC/USD","severity":"low","suggestions":["Use major forex pairs: EUR/USD, GBP/USD, USD/JPY","See /api/v3/glossary/forex-pairs for complete list","For crypto analysis use /crypto-timing endpoint"]},"timestamp":"2024-01-15T10:30:00Z"}},"invalid_trading_session":{"summary":"Unknown trading session","description":"Trading session not recognized","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Invalid trading session","field":"trading_session","value":"africa","severity":"low","suggestions":["Use valid sessions: sydney, tokyo, london, newyork","Consider timezone overlaps for higher volatility"]},"timestamp":"2024-01-15T10:30:00Z"}},"forecast_period_too_long":{"summary":"Forecast period exceeds limit","description":"Forex forecast period too long for accurate analysis","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Maximum 30 days for forex forecast","field":"forecast_days","value":45,"severity":"medium","suggestions":["Limit forex forecast to 30 days or less","Use shorter periods for higher accuracy"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/financial/forex-timing\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/forex-timing\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/financial/forex-timing\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/financial/forex-timing\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/financial/forex-timing\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/business/team-dynamics":{"post":{"tags":["🏢 Business Insights"],"summary":"Analyze Team Dynamics","description":"👥 **Team Dynamics Analysis** - Understand your team's chemistry\n\n**Analyzes:**\n- 🤝 **Compatibility Matrix** - Every team member pair\n- ⚖️ **Element Balance** - Team's collective energy\n- 💬 **Communication Patterns** - How information flows\n- 👑 **Natural Leaders** - Who emerges as leaders\n- 🏢 **Department Synergy** - Cross-functional harmony\n\n**Perfect for:**\n- Team building and optimization\n- Identifying collaboration opportunities\n- Resolving team conflicts\n- Project team selection\n- Department restructuring\n\n**Response time:** ~600ms | **Team size:** 2-20 members","operationId":"analyze_team_dynamics_api_v3_insights_business_team_dynamics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMultipleRequest"},"examples":{"development_team":{"summary":"Development team analysis","description":"Analyze team dynamics for a software development team","value":{"subjects":[{"name":"Alice Johnson","birth_data":{"year":1985,"month":3,"day":15,"hour":10,"minute":30,"city":"New York","country_code":"US"}},{"name":"Bob Smith","birth_data":{"year":1990,"month":7,"day":22,"hour":14,"minute":15,"city":"San Francisco","country_code":"US"}}],"options":{"language":"en","team_name":"Dev Team","department_focus":"tech"}}},"leadership_team":{"summary":"Executive team analysis","description":"Analyze dynamics between C-level executives","value":{"subjects":[{"name":"Sarah Wilson","birth_data":{"year":1978,"month":12,"day":8,"hour":9,"minute":0,"city":"London","country_code":"GB"}},{"name":"Michael Chen","birth_data":{"year":1982,"month":6,"day":25,"hour":16,"minute":45,"city":"Singapore","country_code":"SG"}}],"options":{"language":"en","team_name":"Executive Team","department_focus":"leadership"}}}}}},"required":true},"responses":{"200":{"description":"Successful team dynamics analysis","content":{"application/json":{"schema":{},"examples":{"development_team_success":{"summary":"Development team analysis results","description":"Comprehensive team dynamics for a software development team","value":{"success":true,"data":{"team_overview":{"team_name":"Dev Team","member_count":2,"overall_compatibility":8.3,"team_energy":"collaborative","leadership_style":"distributed"},"compatibility_matrix":[{"person_1":"Alice Johnson","person_2":"Bob Smith","compatibility_score":8.3,"interaction_style":"highly collaborative","potential_conflicts":["different work paces"],"synergy_areas":["problem-solving","innovation"]}],"element_balance":{"fire":30,"earth":20,"air":35,"water":15,"dominant_element":"air","team_characteristics":"innovative and communicative"},"communication_patterns":{"primary_style":"direct and analytical","information_flow":"horizontal","decision_making":"consensus-based","conflict_resolution":"logical discussion"},"natural_leaders":[{"name":"Alice Johnson","leadership_score":8.5,"leadership_style":"visionary","influence_areas":["strategic planning","innovation"]}],"department_synergy":{"internal_harmony":8.2,"productivity_potential":8.7,"innovation_index":9.1,"stress_resilience":7.8},"recommendations":{"team_building":["Focus on structured brainstorming sessions","Implement peer code reviews"],"workflow_optimization":["Establish clear sprint goals","Regular one-on-ones"],"conflict_prevention":["Define roles clearly","Create shared documentation standards"]}},"metadata":{"calculation_time":"2024-01-15T10:30:00Z","request_id":"team_dyn_123"}}},"leadership_team_success":{"summary":"Executive team analysis results","description":"C-level team dynamics with strategic focus","value":{"success":true,"data":{"team_overview":{"team_name":"Executive Team","member_count":2,"overall_compatibility":7.8,"team_energy":"strategic","leadership_style":"complementary"},"compatibility_matrix":[{"person_1":"Sarah Wilson","person_2":"Michael Chen","compatibility_score":7.8,"interaction_style":"professionally respectful","potential_conflicts":["different strategic approaches"],"synergy_areas":["long-term planning","resource allocation"]}],"element_balance":{"fire":40,"earth":25,"air":20,"water":15,"dominant_element":"fire","team_characteristics":"action-oriented and decisive"},"recommendations":{"strategic_alignment":["Quarterly strategic reviews","Clear KPI frameworks"],"communication":["Weekly executive meetings","Transparent decision processes"]}}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in team dynamics request","content":{"application/json":{"examples":{"insufficient_members":{"summary":"Not enough team members","description":"Team analysis requires at least 2 members","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Need at least 2 team members","field":"subjects","value":1,"severity":"medium","suggestions":["Provide at least 2 team member subjects for analysis"]},"timestamp":"2024-01-15T10:30:00Z"}},"too_many_members":{"summary":"Team size exceeds limit","description":"Maximum 20 team members allowed for analysis","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Maximum 20 team members for analysis","field":"subjects","value":25,"severity":"medium","suggestions":["Limit to maximum of 20 team members for analysis"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/business/team-dynamics\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/team-dynamics\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/team-dynamics\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/business/team-dynamics\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/business/team-dynamics\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/business/hiring-compatibility":{"post":{"tags":["🏢 Business Insights"],"summary":"Analyze Hiring Compatibility","description":"🎯 **Hiring Compatibility Analysis** - Make better hiring decisions\n\n**Evaluates:**\n- 🤝 **Team Fit** - Chemistry with existing team\n- 🏢 **Department Match** - Alignment with department energy\n- 📈 **Growth Potential** - Long-term development prospects\n- ⏰ **Start Timing** - Best onboarding dates\n- 🗣️ **Interview Timing** - Optimal interview slots\n\n**Based on:**\n- Synastry with team members\n- Element balance impact\n- Communication style match\n- Leadership potential\n- Cultural fit indicators\n\n**Response time:** ~500ms","operationId":"analyze_hiring_compatibility_api_v3_insights_business_hiring_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMultipleRequest"},"examples":{"tech_hiring":{"summary":"Tech department hiring","description":"Candidate and existing team compatibility analysis","value":{"subjects":[{"name":"Oleksandr Petrenko","birth_data":{"year":1992,"month":5,"day":10,"hour":9,"minute":0,"city":"Kharkiv","country_code":"UA"}},{"name":"Viktor Shevchenko","birth_data":{"year":1987,"month":6,"day":18,"hour":10,"minute":15,"city":"Kiev","country_code":"UA"}}],"options":{"language":"en","role":"Senior Developer","department":"tech","include_timing":true}}},"leadership_hiring":{"summary":"Executive hiring","description":"Leadership position candidate assessment","value":{"subjects":[{"name":"Anna Kovalenko","birth_data":{"year":1985,"month":3,"day":22,"hour":11,"minute":45,"city":"Dnipro","country_code":"UA"}},{"name":"Current CEO","birth_data":{"year":1975,"month":8,"day":12,"hour":14,"minute":30,"city":"Kiev","country_code":"UA"}}],"options":{"language":"en","role":"VP of Marketing","department":"leadership","include_timing":false}}}}}},"required":true},"responses":{"200":{"description":"Successful hiring compatibility analysis","content":{"application/json":{"schema":{},"examples":{"tech_hiring_success":{"summary":"Tech candidate compatibility results","description":"Detailed hiring analysis for software development role","value":{"success":true,"data":{"candidate_profile":{"name":"Oleksandr Petrenko","target_role":"Senior Developer","department":"tech","overall_fit_score":8.6},"team_compatibility":{"average_compatibility":8.3,"individual_scores":[{"team_member":"Viktor Shevchenko","compatibility_score":8.3,"collaboration_potential":"excellent","working_style_match":"highly compatible","communication_synergy":"strong analytical approach"}]},"department_alignment":{"cultural_fit":8.7,"technical_approach":"methodical and innovative","work_style":"detail-oriented with creative problem-solving","team_role_prediction":"technical lead potential"},"growth_potential":{"leadership_readiness":7.8,"skill_development_areas":["system architecture","team mentoring"],"career_trajectory":"senior to principal engineer in 18-24 months","long_term_value":"high retention and growth potential"},"timing_analysis":{"optimal_start_dates":["2024-02-01","2024-03-15"],"interview_timing":{"best_days":["Tuesday","Wednesday"],"optimal_times":["10:00-11:30","14:00-15:30"],"avoid_periods":["Mercury retrograde: Feb 4-25"]}},"recommendations":{"hiring_decision":"strongly recommend","onboarding_focus":["pair programming","architecture reviews"],"integration_strategy":["gradual responsibility increase","mentorship pairing"],"success_metrics":["code quality","team collaboration","project delivery"]}},"metadata":{"calculation_time":"2024-01-15T10:30:00Z","request_id":"hire_comp_456"}}},"leadership_hiring_success":{"summary":"Executive hiring compatibility","description":"VP-level candidate assessment results","value":{"success":true,"data":{"candidate_profile":{"name":"Anna Kovalenko","target_role":"VP of Marketing","department":"leadership","overall_fit_score":8.9},"leadership_compatibility":{"executive_alignment":8.7,"strategic_thinking":"visionary with practical execution","management_style":"collaborative leadership","decision_making":"data-driven with intuitive insights"},"organizational_impact":{"culture_enhancement":9.1,"team_building_potential":8.8,"change_management":"excellent adaptation and communication","stakeholder_relations":"strong external and internal focus"},"recommendations":{"hiring_decision":"exceptional candidate - prioritize","negotiation_approach":"focus on growth opportunities and team impact","integration_plan":["90-day strategic review","team introduction tour"]}}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in hiring compatibility request","content":{"application/json":{"examples":{"insufficient_subjects":{"summary":"Missing candidate or team members","description":"Hiring analysis requires candidate and at least one team member","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Need candidate and at least one team member","field":"subjects","value":1,"severity":"medium","suggestions":["Provide candidate and at least one team member for fit analysis"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/business/hiring-compatibility\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/hiring-compatibility\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/hiring-compatibility\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/business/hiring-compatibility\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/business/hiring-compatibility\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/business/leadership-style":{"post":{"tags":["🏢 Business Insights"],"summary":"Analyze Leadership Style","description":"👔 **Leadership Style Analysis** - Discover natural leadership approach\n\n**Identifies:**\n- 🎯 **Core Style** - Visionary, Collaborative, Methodical, etc.\n- 🧠 **Decision Making** - How you process and decide\n- 👥 **Team Management** - Your people management approach\n- 😤 **Stress Response** - Leadership under pressure\n- 📈 **Growth Areas** - Leadership development opportunities\n\n**Leadership Styles:**\n- **Visionary** - Future-focused, inspirational\n- **Collaborative** - Team-oriented, consensus-building\n- **Methodical** - Process-driven, systematic\n- **Intuitive** - Instinct-based, adaptive\n- **Transformational** - Change-oriented, innovative\n\n**Response time:** ~300ms","operationId":"analyze_leadership_style_api_v3_insights_business_leadership_style_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessSingleRequest"},"examples":{"executive_analysis":{"summary":"Executive leadership style","description":"Comprehensive leadership analysis for C-level executive","value":{"subject":{"name":"Oleg Yaroshevych","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"language":"en","include_development":true,"detail_level":"professional"}}},"team_lead_analysis":{"summary":"Team leader assessment","description":"Leadership style for team management roles","value":{"subject":{"name":"Maria Petrova","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"Kiev","country_code":"UA"}},"options":{"language":"en","include_development":false,"detail_level":"standard"}}}}}},"required":true},"responses":{"200":{"description":"Successful leadership style analysis","content":{"application/json":{"schema":{},"examples":{"executive_leadership_success":{"summary":"Executive leadership analysis results","description":"Comprehensive leadership profile for C-level executive","value":{"success":true,"data":{"leadership_profile":{"name":"Oleg Yaroshevych","primary_style":"Transformational","secondary_style":"Collaborative","leadership_score":8.7,"natural_authority":"high"},"core_characteristics":{"decision_making_style":"analytical with intuitive insights","communication_approach":"direct and inspiring","team_interaction":"empowering and supportive","change_management":"proactive and strategic"},"leadership_strengths":["Visionary thinking and long-term planning","Team motivation and development","Strategic decision-making under pressure","Innovation and creative problem-solving","Building strong stakeholder relationships"],"team_management_style":{"delegation_approach":"empowering with clear expectations","feedback_style":"constructive and growth-oriented","conflict_resolution":"mediative and solution-focused","performance_management":"goal-oriented with personal development focus"},"stress_response_patterns":{"under_pressure":"maintains composure while seeking input","crisis_management":"decisive action with team consultation","recovery_methods":"strategic planning and reflection","team_support_during_stress":"transparent communication and shared responsibility"},"development_opportunities":{"growth_areas":["Operational detail management","Cross-cultural team leadership","Financial strategy integration"],"recommended_training":["Executive coaching on operational excellence","International leadership development","Advanced financial strategy workshops"],"mentorship_suggestions":"Partner with operations-focused leader","timeline_for_growth":"6-12 months for operational skills"},"optimal_environments":{"best_team_structures":"diverse, autonomous teams with clear goals","organizational_fit":"innovation-driven companies with growth focus","decision_making_context":"strategic leadership with operational support"}},"metadata":{"calculation_time":"2024-01-15T10:30:00Z","request_id":"lead_style_789"}}},"team_lead_success":{"summary":"Team leader analysis results","description":"Leadership assessment for team management role","value":{"success":true,"data":{"leadership_profile":{"name":"Maria Petrova","primary_style":"Collaborative","secondary_style":"Methodical","leadership_score":7.9,"natural_authority":"moderate to high"},"core_characteristics":{"decision_making_style":"consensus-building with clear direction","communication_approach":"open and supportive","team_interaction":"inclusive and developmental","change_management":"gradual and well-communicated"},"leadership_strengths":["Team building and cohesion","Process improvement and systematization","Individual team member development","Conflict mediation and resolution"],"optimal_environments":{"best_team_structures":"collaborative teams with shared objectives","organizational_fit":"stable companies with focus on team development"}}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in leadership style request","content":{"application/json":{"examples":{"missing_birth_data":{"summary":"Incomplete birth information","description":"Leadership analysis requires complete birth data","value":{"success":false,"error":{"error_code":"MISSING_REQUIRED_FIELD","message":"Birth data is required for leadership analysis","field":"subject.birth_data","severity":"high","suggestions":["Provide complete birth data including date, time, and location"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/business/leadership-style\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/leadership-style\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/leadership-style\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/business/leadership-style\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/business/leadership-style\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/business/business-timing":{"post":{"tags":["🏢 Business Insights"],"summary":"Calculate Business Timing","description":"📅 **Business Activity Timing** - Optimize important business events\n\n**Timing for:**\n- 🚀 **Product Launch** - Maximum impact timing with astrological factors\n- 🤝 **Meetings** - Productive discussion windows\n- 💼 **Negotiations** - Favorable deal-making periods\n- 👥 **Hiring** - Best recruitment windows\n- 🔄 **Restructuring** - Smooth transition periods with transformation factors\n\n**Based on planetary cycles:**\n- Mercury (communication, contracts)\n- Venus (negotiations, partnerships)\n- Mars (launches, initiatives)\n- Jupiter (expansion, growth)\n- Saturn (structure, long-term planning)\n\n**What you get:**\n- **launch_windows** - Each window includes `astrological_factors` (transits, lunar phases)\n- **restructuring_periods** - Each period includes `astrological_factors` (Saturn, Pluto transits)\n- **astrological_context** - Overall period planetary climate with `current_events`\n\n**Astrological factors structure:**\n```json\n{\n \"type\": \"transit|lunar_phase|aspect|sign_ingress\",\n \"datetime_utc\": \"2024-01-15T00:00:00\",\n \"name\": \"Jupiter trine Sun\",\n \"influence\": \"supportive|challenging|neutral|transformative\",\n \"primary_body\": \"Jupiter\",\n \"secondary_body\": \"natal_Sun\",\n \"aspect_type\": \"trine\",\n \"strength\": 0.85\n}\n```\n\n**Response time:** ~400ms | **Range:** Up to 90 days","operationId":"calculate_business_timing_api_v3_insights_business_business_timing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_calculate_business_timing_api_v3_insights_business_business_timing_post"}}}},"responses":{"200":{"description":"Successful business timing analysis","content":{"application/json":{"schema":{},"examples":{"product_launch_success":{"summary":"Product launch timing results","description":"Optimal timing for new product release","value":{"success":true,"data":{"analysis_period":{"start_date":"2024-01-15","end_date":"2024-02-14","total_days":30},"activities_analyzed":["product_launch","meetings"],"optimal_timing_windows":{"product_launch":{"primary_window":{"start_date":"2024-01-22","end_date":"2024-01-26","rating":"excellent","planetary_support":"Mars in favorable aspect for initiatives","market_conditions":"high receptivity period"},"secondary_window":{"start_date":"2024-02-05","end_date":"2024-02-09","rating":"good","planetary_support":"Jupiter supporting expansion"},"avoid_periods":[{"start_date":"2024-01-30","end_date":"2024-02-03","reason":"Mercury retrograde affecting communication"}]},"meetings":{"best_days":[{"date":"2024-01-18","day_of_week":"Thursday","rating":"excellent","best_times":["10:00-11:30","14:00-15:30"]},{"date":"2024-01-24","day_of_week":"Wednesday","rating":"very good","best_times":["09:00-10:30","15:00-16:30"]}],"optimal_frequency":"weekly strategic meetings on Wednesdays"}},"astrological_influences":{"mercury_cycles":"Favorable for contracts and communications Jan 15-29","venus_cycles":"Excellent for partnerships and negotiations Jan 20-Feb 10","mars_cycles":"Strong initiative energy for launches Jan 22-Feb 5","jupiter_influence":"Growth and expansion support throughout period"},"business_recommendations":{"short_term_actions":["Schedule key stakeholder meetings during optimal windows","Prepare launch materials during favorable Mercury period","Avoid major announcements during retrograde period"],"strategic_planning":["Use January energy for planning and preparation","Focus on partnership development in early February","Build momentum through consistent weekly meetings"]}},"metadata":{"calculation_time":"2024-01-15T10:30:00Z","request_id":"biz_timing_012"}}},"hiring_campaign_success":{"summary":"Recruitment timing results","description":"Optimal periods for hiring and interviews","value":{"success":true,"data":{"activities_analyzed":["hiring","meetings"],"optimal_timing_windows":{"hiring":{"recruitment_launch":{"start_date":"2024-01-16","end_date":"2024-01-20","rating":"excellent","focus":"post job openings and begin candidate outreach"},"interview_periods":[{"start_date":"2024-01-25","end_date":"2024-02-02","rating":"optimal","candidate_receptivity":"high","decision_clarity":"excellent"}],"offer_timing":"Best to extend offers between Feb 5-9 for maximum acceptance"}},"business_recommendations":{"recruitment_strategy":["Launch campaigns during new moon energy for fresh starts","Schedule final interviews when Mercury is direct","Make offers during Venus-favorable periods for acceptance"]}}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in business timing request","content":{"application/json":{"examples":{"date_range_too_long":{"summary":"Analysis period exceeds limit","description":"Date range cannot exceed 90 days","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Date range cannot exceed 90 days","field":"date_range","severity":"medium","suggestions":["Reduce the date range to 90 days or less"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/business/business-timing\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/business-timing\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/business-timing\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/business/business-timing\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/business/business-timing\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/business/department-compatibility":{"post":{"tags":["🏢 Business Insights"],"summary":"Analyze Department Compatibility","description":"🏢 **Department Compatibility Analysis** - Optimize organizational structure\n\n**Analyzes:**\n- 🔄 **Inter-Department Synergy** - How departments work together\n- 🤝 **Collaboration Potential** - Cross-functional opportunities\n- ⚡ **Friction Points** - Where conflicts may arise\n- 📊 **Communication Flow** - Information exchange patterns\n- 🎯 **Project Success** - Which departments work best together\n\n**Department Types:**\n- Sales, Marketing, Tech, Creative\n- HR, Finance, Operations, Leadership\n\n**Use Cases:**\n- Organizational restructuring\n- Cross-functional team building\n- Identifying collaboration opportunities\n- Resolving inter-department conflicts\n\n**Response time:** ~500ms","operationId":"analyze_department_compatibility_api_v3_insights_business_department_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request"},"examples":{"simple_format":{"summary":"Simple department names (recommended)","description":"Use simple department names - API will auto-assign members","value":{"subjects":[{"name":"Andriy Shevchenko","birth_data":{"year":1988,"month":4,"day":12,"hour":10,"minute":30,"city":"Kiev","country_code":"UA"}},{"name":"Olena Kovalenko","birth_data":{"year":1991,"month":9,"day":5,"hour":14,"minute":15,"city":"Kharkiv","country_code":"UA"}}],"options":{"language":"en","departments":["engineering","marketing"]}}},"tech_and_marketing":{"summary":"Advanced format with member assignment","description":"Full control over department membership (advanced users)","value":{"subjects":[{"name":"Andriy Shevchenko","birth_data":{"year":1988,"month":4,"day":12,"hour":10,"minute":30,"city":"Kiev","country_code":"UA"}},{"name":"Olena Kovalenko","birth_data":{"year":1991,"month":9,"day":5,"hour":14,"minute":15,"city":"Kharkiv","country_code":"UA"}},{"name":"Yana Petrenko","birth_data":{"year":1989,"month":6,"day":20,"hour":11,"minute":0,"city":"Lviv","country_code":"UA"}}],"options":{"language":"en","departments":[{"name":"Engineering","type":"tech","members":[0,1]},{"name":"Marketing","type":"marketing","members":[2]}]}}},"full_organization":{"summary":"Complete organizational analysis","description":"Multi-department compatibility for full organization","value":{"subjects":[{"name":"Maksym Bondarenko","birth_data":{"year":1985,"month":2,"day":14,"hour":9,"minute":45,"city":"Odessa","country_code":"UA"}},{"name":"Iryna Savchenko","birth_data":{"year":1987,"month":11,"day":8,"hour":13,"minute":20,"city":"Dnipro","country_code":"UA"}},{"name":"Roman Tkachenko","birth_data":{"year":1992,"month":5,"day":3,"hour":15,"minute":30,"city":"Kiev","country_code":"UA"}}],"options":{"language":"en","departments":[{"name":"Sales","type":"sales","members":[0]},{"name":"Operations","type":"operations","members":[1]},{"name":"Creative","type":"creative","members":[2]}]}}}}}},"required":true},"responses":{"200":{"description":"Successful department compatibility analysis","content":{"application/json":{"schema":{},"examples":{"engineering_marketing_success":{"summary":"Tech and marketing department analysis","description":"Cross-functional compatibility between engineering and marketing teams","value":{"success":true,"data":{"overall_compatibility":8.2,"departments_analyzed":[{"name":"Engineering","type":"tech","member_count":2},{"name":"Marketing","type":"marketing","member_count":1}],"department_synergies":{"Engineering":{"internal_harmony":8.5,"productivity_score":8.7,"communication_style":"direct and analytical","strengths":["technical excellence","systematic problem-solving","innovation focus"],"areas_for_improvement":["external communication","business impact articulation"]},"Marketing":{"internal_harmony":7.8,"productivity_score":8.3,"communication_style":"creative and persuasive","strengths":["customer empathy","creative storytelling","market awareness"],"areas_for_improvement":["technical understanding","data-driven decisions"]}},"inter_department_dynamics":[{"departments":["Engineering","Marketing"],"compatibility_score":8.2,"collaboration_potential":"high","communication_bridge":"product-focused dialogue","potential_conflicts":["different timelines and priorities","technical vs. market-driven decisions","resource allocation disagreements"],"synergy_opportunities":["Product development collaboration","Technical marketing content creation","Customer feedback integration","Feature prioritization alignment"],"communication_recommendations":["Weekly product sync meetings","Shared roadmap planning sessions","Cross-team shadowing programs","Technical literacy workshops for marketing"]}],"organizational_insights":{"leadership_distribution":"balanced with complementary strengths","innovation_potential":8.8,"change_adaptability":8.1,"conflict_resolution":7.9,"cross_functional_effectiveness":"high potential with proper communication frameworks"},"recommendations":{"short_term":["Establish regular engineering-marketing sync meetings","Create shared product development documentation","Implement cross-team project assignments","Define clear handoff processes between teams"],"long_term":["Develop technical marketing specialist roles","Create integrated product development workflows","Build shared metrics and KPIs","Establish cross-departmental mentorship programs"],"leadership":["Foster collaborative culture through shared goals","Invest in communication skills training","Create clear escalation paths for conflicts","Align departmental objectives with company vision"]}},"metadata":{"calculation_time":"2024-01-15T10:30:00Z","request_id":"dept_comp_345"}}},"full_organization_success":{"summary":"Multi-department organizational analysis","description":"Comprehensive compatibility analysis across sales, operations, and creative departments","value":{"success":true,"data":{"overall_compatibility":7.8,"departments_analyzed":[{"name":"Sales","type":"sales","member_count":1},{"name":"Operations","type":"operations","member_count":1},{"name":"Creative","type":"creative","member_count":1}],"organizational_insights":{"leadership_distribution":"diverse leadership styles across departments","innovation_potential":8.2,"change_adaptability":7.6,"conflict_resolution":8.0,"workflow_efficiency":"good with optimization opportunities"},"key_synergies":["Sales-Creative collaboration on customer-facing materials","Operations-Sales alignment on delivery capabilities","Creative-Operations cooperation on process innovation"],"recommendations":{"organizational_structure":["Create cross-functional project teams","Establish clear communication protocols","Implement rotating leadership opportunities"]}}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in department compatibility request","content":{"application/json":{"examples":{"insufficient_departments":{"summary":"Not enough departments","description":"Analysis requires at least 2 departments","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Need at least 2 departments","field":"subjects","value":1,"severity":"medium","suggestions":["Provide at least 2 department subjects for analysis"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/business/department-compatibility\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/department-compatibility\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/department-compatibility\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/business/department-compatibility\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/business/department-compatibility\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/business/succession-planning":{"post":{"tags":["🏢 Business Insights"],"summary":"Analyze Succession Planning","description":"🔄 **Succession Planning Analysis** - Identify future leaders\n\n**Evaluates:**\n- 👑 **Leadership Readiness** - Who's ready to lead\n- 🎯 **Style Compatibility** - Continuity vs change\n- 📈 **Growth Timeline** - When they'll be ready\n- 🤝 **Team Acceptance** - How team will respond\n- 🚀 **Transition Timing** - Optimal handover periods\n\n**Provides:**\n- Successor rankings with scores\n- Development recommendations\n- Optimal transition timing\n- Risk assessments\n- Mentorship pairings\n\n**Response time:** ~400ms","operationId":"analyze_succession_planning_api_v3_insights_business_succession_planning_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMultipleRequest"},"examples":{"ceo_succession":{"summary":"CEO succession planning","description":"Current CEO and potential successors analysis","value":{"subjects":[{"name":"Volodymyr Kravchenko","birth_data":{"year":1975,"month":3,"day":15,"hour":11,"minute":30,"city":"Kiev","country_code":"UA"}},{"name":"Oleksandr Moroz","birth_data":{"year":1985,"month":6,"day":12,"hour":10,"minute":0,"city":"Kiev","country_code":"UA"}},{"name":"Anastasiya Kovalchuk","birth_data":{"year":1987,"month":9,"day":30,"hour":13,"minute":20,"city":"Dnipro","country_code":"UA"}}],"options":{"language":"en","current_leader_role":"CEO","succession_department":"leadership"}}},"department_succession":{"summary":"Department head succession","description":"Tech department leadership succession planning","value":{"subjects":[{"name":"Sergiy Petrov","birth_data":{"year":1978,"month":8,"day":22,"hour":9,"minute":45,"city":"Kharkiv","country_code":"UA"}},{"name":"Pavlo Kravets","birth_data":{"year":1984,"month":7,"day":5,"hour":9,"minute":15,"city":"Kiev","country_code":"UA"}},{"name":"Tetyana Savchuk","birth_data":{"year":1989,"month":10,"day":14,"hour":12,"minute":0,"city":"Lviv","country_code":"UA"}}],"options":{"language":"en","current_leader_role":"VP of Engineering","succession_department":"tech"}}}}}},"required":true},"responses":{"200":{"description":"Successful succession planning analysis","content":{"application/json":{"schema":{},"examples":{"ceo_succession_success":{"summary":"CEO succession planning results","description":"Executive succession analysis with candidate rankings","value":{"success":true,"data":{"current_leader":{"name":"Volodymyr Kravchenko","role":"CEO","leadership_style":"visionary","tenure_impact":"transformational growth period"},"succession_candidates":[{"name":"Anastasiya Kovalchuk","current_role":"Potential Successor","leadership_style":"Collaborative","compatibility_score":87,"readiness_score":96.1,"development_timeline":"12-18 months","key_strengths":["Strategic vision and long-term planning","Team building and organizational development","Change management and innovation","Stakeholder relationship management"],"development_areas":["Financial strategy and board relations","International market expansion","Crisis management experience"],"succession_readiness":"high - ready for transition with minimal development","risk_factors":["limited international experience"],"mitigation_strategies":["International assignment","Board shadowing program"]},{"name":"Oleksandr Moroz","current_role":"Potential Successor","leadership_style":"Methodical","compatibility_score":78,"readiness_score":93.4,"development_timeline":"12-18 months","key_strengths":["Operational excellence and process optimization","Analytical decision-making","Team development and mentoring","Technology and innovation focus"],"development_areas":["Strategic communication and vision articulation","External stakeholder management","Market and competitive analysis"],"succession_readiness":"good - needs strategic leadership development","leadership_growth_potential":"high with proper coaching"}],"transition_planning":{"optimal_transition_window":"Q2-Q3 2025","transition_timeline":{"preparation_phase":"6 months - leadership development and skill building","handover_phase":"3 months - gradual responsibility transfer","stabilization_phase":"6 months - full autonomy with mentorship support"},"success_factors":["Clear communication to stakeholders","Gradual responsibility increase","Ongoing mentorship from current leader","Board and investor confidence building"]},"development_recommendations":{"immediate_actions":["Begin executive coaching program for top candidates","Create stretch assignments with increasing responsibility","Establish mentorship pairings with current executive team","Develop 360-degree feedback processes"],"6_month_milestones":["Complete leadership assessment and development plan","Execute significant project leadership roles","Build external stakeholder relationships","Demonstrate crisis management capabilities"],"long_term_preparation":["Board presentation and strategic planning involvement","Industry conference speaking and thought leadership","Cross-functional leadership experience","International business exposure"]},"risk_assessment":{"succession_risks":["Leadership gap if transition is rushed","Cultural change resistance","Key talent retention during transition"],"mitigation_strategies":["Phased transition with overlap period","Clear communication and change management","Retention programs for critical team members"]},"recommendations":["Begin leadership development program for top candidates","Create mentorship pairings with current executives","Provide stretch assignments to test readiness","Establish regular succession planning reviews","Build external stakeholder confidence in candidates"]},"metadata":{"calculation_time":"2024-01-15T10:30:00Z","request_id":"succession_678"}}},"department_succession_success":{"summary":"Department head succession results","description":"Tech department leadership succession planning","value":{"success":true,"data":{"current_leader":{"name":"Sergiy Petrov","role":"VP of Engineering"},"succession_candidates":[{"name":"Tetyana Savchuk","current_role":"Potential Successor","leadership_style":"Collaborative","compatibility_score":83,"readiness_score":94.9,"development_timeline":"12-18 months","key_strengths":["Technical excellence","Team building"],"development_areas":["Strategic planning"]},{"name":"Pavlo Kravets","current_role":"Potential Successor","leadership_style":"Methodical","compatibility_score":79,"readiness_score":93.7,"development_timeline":"12-18 months","key_strengths":["Technical leadership","Process optimization"],"development_areas":["Team communication"]}],"optimal_transition_window":"Q2-Q3 2025","recommendations":["Implement technical leadership development program","Create cross-team project leadership opportunities","Establish technical mentorship with senior leaders"]}}}}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error in succession planning request","content":{"application/json":{"examples":{"insufficient_subjects":{"summary":"Missing leader or successors","description":"Succession planning requires current leader and at least one potential successor","value":{"success":false,"error":{"error_code":"INVALID_FIELD_VALUE","message":"Need current leader and at least one potential successor","field":"subjects","value":1,"severity":"medium","suggestions":["Provide current leader and at least one potential successor for succession planning"]},"timestamp":"2024-01-15T10:30:00Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/insights/business/succession-planning\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/succession-planning\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/business/succession-planning\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/business/succession-planning\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/business/succession-planning\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/":{"get":{"tags":["💫 Insights Platform"],"summary":"Discover Insights","description":"🌟 **Discover Astrology Insights Platform** - Specialized astrological wisdom\n\n**Available Insights:**\n- 💕 **Relationship** - Compatibility, love languages, timing\n- 🐾 **Pet** - Pet personality, training, owner bonding (coming soon)\n- 🏥 **Wellness** - Health patterns, biorhythms, timing (coming soon)\n- 💰 **Financial** - Market timing, trading signals (coming soon)\n- 💼 **Business** - Team dynamics, hiring, leadership (coming soon)\n\n**Why Insights?**\nOur insights platform transforms complex astrological calculations into\npractical, actionable wisdom for every aspect of modern life.\n\n**Response time:** ~10ms","operationId":"discover_insights_api_v3_insights__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error - check input data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/insights/\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/insights/relationship/":{"get":{"tags":["💕 Relationship Insights"],"summary":"Discover Relationship Insights","description":"💕 **Relationship Insights Discovery** - Available relationship analyses\n\nExplore all available relationship and compatibility insights.","operationId":"discover_relationship_insights_api_v3_insights_relationship__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid insights parameters"},"422":{"description":"Validation error - check input data"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/insights/relationship/\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/insights/relationship/\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/insights/relationship/\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/insights/relationship/\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/health/":{"get":{"tags":["🔧 Health & Monitoring"],"summary":"Health Check","description":"🏥 **API Health Check**\n\nSimple health status check for monitoring and load balancers.\n\n**Perfect for:**\n- 🔍 Load balancer health checks\n- 📊 Uptime monitoring systems\n- 🚀 RapidAPI automatic monitoring\n- ⚡ Quick service validation\n\n**Returns:**\n- **status** - Current health status (\"healthy\" or \"unhealthy\")\n- **version** - API version number\n- **api** - API name and identifier\n- **timestamp** - Response generation time\n\n**Response time:** ~50ms | **Use:** Production monitoring","operationId":"health_check_api_v3_health__get","responses":{"200":{"description":"API is healthy and operational","content":{"application/json":{"schema":{},"examples":{"healthy_response":{"summary":"Healthy API Response","description":"Standard response when API is functioning correctly","value":{"success":true,"data":{"status":"healthy","version":"3.2.0","api":"Astrology API v3","timestamp":"2024-09-14T21:26:00.123456Z"},"metadata":{"timestamp":"2024-09-14T21:26:00.123456Z","calculation_time_ms":45,"api_version":"3.2.0","endpoint":"health.check","request_id":"req_abc123def456","cache_hit":false,"credits_used":0}}}}}}},"503":{"description":"API is unhealthy or experiencing issues","content":{"application/json":{"examples":{"unhealthy_response":{"summary":"Unhealthy API Response","description":"Response when API components are failing","value":{"success":false,"error":{"error_code":"INTERNAL_SERVER_ERROR","message":"Health check failed: Basic calculation test failed","severity":"high","suggestions":["Check server logs for detailed error information","Verify all service dependencies are running","Contact system administrator if issue persists"]},"timestamp":"2024-09-14T21:26:00.123456Z"}}}}}},"500":{"description":"Internal server error"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/health/\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/health/\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/health/\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/health/\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/health/\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/health/debug/timezone":{"get":{"tags":["🔧 Health & Monitoring"],"summary":"Debug TimezoneFinder","description":"Debug endpoint to check TimezoneFinder behavior on production.","operationId":"debug_timezone_api_v3_health_debug_timezone_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"503":{"description":"Service unavailable - health check failed"},"500":{"description":"Internal server error"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/health/debug/timezone\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/health/debug/timezone\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/health/debug/timezone\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/health/debug/timezone\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/health/debug/timezone\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/enhanced/personal-analysis":{"post":{"tags":["✨ Enhanced Traditional Analysis"],"summary":"Get Personal Analysis","description":"🏛️ **Personal Traditional Analysis** - Complete natal chart with traditional astrology\n\n**Perfect for:**\n- 🎯 Personal astrological consultations with birth data\n- 📱 Personalized astrology apps with natal correlation\n- 🔮 Traditional timing and profection analysis\n- 📊 Complete dignity and reception analysis\n\n**What you get:**\n- **Complete natal chart** with traditional enhancements\n- **Essential dignities** - domicile, exaltation, triplicity, term, decan\n- **Essential debilities** - exile and fall\n- **Planetary conditions** - combust, cazimi, under beams\n- **Dispositor chains** - full rulership sequences\n- **Mutual receptions** - traditional planetary relationships\n- **Annual profections** - Lord of the Year (Chronocrator)\n- **Fixed star conjunctions** - 7 major stars (Aldebaran, Regulus, etc.)\n- **Enhanced aspects** - with reception analysis\n- **Lunar phase data** - current Moon phase and elongation\n- **House system** - Whole Sign by default (traditional)\n\n**Traditional Features:**\n- Hellenistic astrology methods\n- Sect analysis (day/night chart)\n- Houses of joy (jubilation)\n- About-to-change-sign predictions\n- Complete 12-house data\n\n**Response time:** ~300ms | **Accuracy:** Swiss Ephemeris + Traditional calculations","operationId":"get_personal_analysis_api_v3_enhanced_personal_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalAnalysisRequest"},"examples":{"comprehensive_analysis":{"summary":"Comprehensive Personal Analysis","description":"Complete traditional analysis with current transits and profections using standardized test subject","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Part_of_Fortune","Part_of_Spirit"],"precision":4},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"dignity_focused":{"summary":"Dignity-Focused Analysis","description":"Emphasis on essential dignities and planetary conditions","value":{"subject":{"name":"Dignity Scholar","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":41.9028,"longitude":12.4964}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3},"orbs":{"major_aspects_deg":1.5,"minor_aspects_deg":0.5}}},"fixed_stars_analysis":{"summary":"Fixed Stars Analysis","description":"Personal analysis with emphasis on fixed star conjunctions","value":{"subject":{"name":"Star Gazer","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Cairo","country_code":"EG"}},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Aldebaran","Regulus","Antares","Fomalhaut","Sirius"],"precision":2},"orbs":{"major_aspects_deg":2.5,"minor_aspects_deg":1.0}}},"night_chart_analysis":{"summary":"Night Chart - Sect Analysis","description":"Traditional analysis for night birth emphasizing nocturnal planets","value":{"subject":{"name":"Luna Nocturna","birth_data":{"year":1988,"month":7,"day":4,"hour":23,"minute":45,"second":0,"city":"Sydney","country_code":"AU"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Part_of_Fortune","Part_of_Spirit"],"precision":4},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"day_chart_analysis":{"summary":"Day Chart - Solar Emphasis","description":"Traditional analysis for day birth emphasizing diurnal planets","value":{"subject":{"name":"Sol Diurnus","birth_data":{"year":1995,"month":6,"day":21,"hour":12,"minute":0,"second":0,"latitude":48.8566,"longitude":2.3522}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":3},"orbs":{"major_aspects_deg":1.5,"minor_aspects_deg":0.5}}},"arabic_parts_focus":{"summary":"Arabic Parts Emphasis","description":"Analysis focusing on traditional Arabic Parts and Lots","value":{"subject":{"name":"Parts Master","birth_data":{"year":1987,"month":9,"day":23,"hour":15,"minute":30,"second":0,"city":"Baghdad","country_code":"IQ"}},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Part_of_Fortune","Part_of_Spirit"],"precision":5},"orbs":{"major_aspects_deg":3.0,"minor_aspects_deg":1.5}}},"mutual_reception_focus":{"summary":"Mutual Reception Analysis","description":"Emphasis on planetary mutual receptions and dispositor chains","value":{"subject":{"name":"Reception Scholar","birth_data":{"year":1991,"month":4,"day":10,"hour":6,"minute":30,"second":0,"city":"Florence","country_code":"IT"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node"],"precision":4},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"combustion_analysis":{"summary":"Combustion & Cazimi Analysis","description":"Focus on planets in combustion, cazimi, and under the beams","value":{"subject":{"name":"Solar Proximity","birth_data":{"year":1989,"month":8,"day":15,"hour":11,"minute":45,"second":0,"latitude":35.6762,"longitude":139.6503}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron"],"precision":6},"orbs":{"major_aspects_deg":1.0,"minor_aspects_deg":0.5}}},"sidereal_traditional":{"summary":"Sidereal Traditional Analysis","description":"Traditional Hellenistic techniques applied to Sidereal zodiac with Whole Sign houses","value":{"subject":{"name":"Sidereal Traditionalist","birth_data":{"year":1993,"month":12,"day":25,"hour":18,"minute":0,"second":0,"city":"Varanasi","country_code":"IN"}},"options":{"house_system":"W","zodiac_type":"Sidereal","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":3},"orbs":{"major_aspects_deg":2.5,"minor_aspects_deg":1.0}}},"profection_timing":{"summary":"Current Profection Analysis","description":"Personal analysis with current profection year timing","value":{"subject":{"name":"Timing Master","birth_data":{"year":1986,"month":3,"day":15,"hour":14,"minute":20,"second":0,"city":"Vienna","country_code":"AT"}},"calculation_time":{"year":2024,"month":3,"day":15,"hour":12,"minute":0,"second":0},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","Part_of_Fortune"],"precision":3},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}}}}},"required":true},"responses":{"200":{"description":"Personal traditional analysis completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalAnalysisResponse"},"examples":{"comprehensive_response":{"summary":"Complete Personal Analysis Response","description":"Traditional analysis with all components calculated","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","nation":"UA","lng":36.2527,"lat":49.9808,"tz_str":"Europe/Kiev"},"metadata":{"schema_version":"1.0","calculation_epoch_utc":"2024-05-11T15:30:00Z","timezone":"UTC","orbs":{"major_aspects_deg":2.0}},"ascendant":{"degree":15.45,"sign":"Leo","ruler":"Sun","house":1},"houses":[{"house":1,"sign":"Leo","degree":15.45},{"house":2,"sign":"Vir","degree":15.45}],"planets":[{"name":"Sun","quality":"Fixed","element":"Earth","sign":"Tau","sign_num":1,"position":20.82,"abs_pos":50.82,"emoji":"♉️","point_type":"Planet","house":"Tenth_House","retrograde":false,"dignities":{"domicile":false,"exaltation":false},"debilities":{"exile":false,"fall":false},"sect":"day","conditions":{"combust":false,"cazimi":false},"jubilation":false,"dispositor_chain":["Venus"],"about_to_change_sign":{"changing":false}}],"aspects":[{"planet_a":"Sun","planet_b":"Moon","aspect_type":"trine","orb":1.25,"applying":true,"reception_quality":{"quality":"neutral"},"dignity_context":{"both_dignified":false},"aspect_strength":0.85}],"fixed_stars":[{"star":"Aldebaran","planet":"Moon","orb":0.8,"star_longitude":69.47,"traditional_meaning":"Royal Watcher of the East"}],"lunar_phase":{"phase_name":"Waxing Gibbous","elongation_deg":130.5,"illumination_percent":85.2,"moon_age_days":10.7},"chronocrator":{"method":"Annual Profection","year_age":38,"sign":"Can","ruler":"Moon","house_themes":["home","family","emotional foundation"]},"priority_score":0.72,"activates":["Sun angular","Moon in domicile"],"house_crossings_next_72h":[],"life_areas":["career_success","creative_expression","leadership"],"start_utc":"2024-05-11T00:00:00Z","end_utc":"2024-05-11T23:59:59Z","daypart_hint":"afternoon"}}}}}},"400":{"description":"Invalid enhanced analysis parameters"},"422":{"description":"Validation error - check request format"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/enhanced/personal-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/enhanced/personal-analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/enhanced/personal-analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/enhanced/personal-analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/enhanced/personal-analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/enhanced/global-analysis":{"post":{"tags":["✨ Enhanced Traditional Analysis"],"summary":"Get Global Analysis","description":"🌍 **Global Traditional Analysis** - Current planetary conditions without natal correlation\n\n**Perfect for:**\n- 🔮 Electional astrology (choosing optimal timing)\n- 📅 Universal astrological planning\n- 🌙 Lunar timing and void-of-course periods\n- 📊 Current sky analysis and research\n\n**What you get:**\n- **Current planetary positions** with traditional dignities\n- **Essential dignities** - domicile, exaltation, triplicity, term, decan\n- **Essential debilities** - exile and fall\n- **Planetary conditions** - combust, cazimi, under beams\n- **Current aspects** - between transiting planets\n- **Fixed star conjunctions** - 7 major stars\n- **Lunar phase data** - current Moon phase and elongation\n- **Sect analysis** - day/night determination\n- **Dispositor chains** - current rulership patterns\n- **Mutual receptions** - current planetary relationships\n\n**No Birth Data Required:**\n- Pure astronomical/astrological analysis\n- Universal timing information\n- Current planetary dignity states\n- Optimal for electional astrology\n\n**Response time:** ~200ms | **Accuracy:** Swiss Ephemeris + Traditional calculations","operationId":"get_global_analysis_api_v3_enhanced_global_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalAnalysisRequest"},"examples":{"current_sky":{"summary":"Current Sky Analysis","description":"Current planetary conditions for electional astrology (uses current time)","value":{"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":3},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"new_moon_timing":{"summary":"New Moon Electional","description":"Optimal timing analysis around New Moon for manifestation","value":{"calculation_time":{"year":2024,"month":4,"day":8,"hour":19,"minute":21,"second":0},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","Part_of_Fortune"],"precision":4},"orbs":{"major_aspects_deg":1.5,"minor_aspects_deg":0.5}}},"eclipse_analysis":{"summary":"Eclipse Period Analysis","description":"Global analysis during eclipse for major timing decisions","value":{"calculation_time":{"year":2024,"month":10,"day":14,"hour":18,"minute":55,"second":0},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Mean_South_Node","True_South_Node"],"precision":5},"orbs":{"major_aspects_deg":3.0,"minor_aspects_deg":1.5}}}}}},"required":true},"responses":{"200":{"description":"Global traditional analysis completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalAnalysisResponse"},"examples":{"current_sky_response":{"summary":"Current Sky Analysis Response","description":"Complete global analysis with current planetary conditions","value":{"metadata":{"schema_version":"1.0","calculation_epoch_utc":"2024-05-11T12:30:00Z","timezone":"UTC","orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}},"planets":[{"name":"Sun","sign":"Tau","degree":21.15,"absolute_longitude":51.15,"is_retrograde":false,"speed":0.9583,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":true,"ruler":"Venus"}},"debilities":{"exile":false,"fall":false},"sect":"day","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Venus"],"about_to_change_sign":{"changing":false,"degrees_to_change":8.85}},{"name":"Moon","sign":"Sco","degree":12.87,"absolute_longitude":222.87,"is_retrograde":false,"speed":13.2456,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":true,"ruler":"Mars"}},"debilities":{"exile":false,"fall":false},"sect":"night","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mars","Pluto"],"about_to_change_sign":{"changing":false,"degrees_to_change":17.13}},{"name":"Jupiter","sign":"Gem","degree":28.42,"absolute_longitude":88.42,"is_retrograde":false,"speed":0.2134,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":false}},"debilities":{"exile":true,"fall":false},"sect":"day","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mercury"],"about_to_change_sign":{"changing":true,"degrees_to_change":1.58}}],"aspects":[{"planet_a":"Sun","planet_b":"Moon","aspect_type":"opposition","orb":1.72,"applying":false,"reception_quality":{"quality":"neutral","score":0.0},"dignity_context":{"both_dignified":false,"either_dignified":false},"aspect_strength":0.91},{"planet_a":"Sun","planet_b":"Jupiter","aspect_type":"sextile","orb":0.88,"applying":true,"reception_quality":{"quality":"neutral","score":0.0},"dignity_context":{"both_dignified":false,"either_dignified":false},"aspect_strength":0.85}],"fixed_stars":[{"star":"Aldebaran","planet":"Moon","orb":1.2,"star_longitude":69.47,"traditional_meaning":"Royal Watcher of the East, brings honor when rising"}],"lunar_phase":{"phase_name":"Waning Gibbous","elongation_deg":171.72,"illumination_percent":95.4,"moon_age_days":14.05},"rarity":"High aspect density","priority_score":0.68,"life_areas":["relationships","values_resources","communication"],"start_utc":"2024-05-11T00:00:00Z","end_utc":"2024-05-11T23:59:59Z","daypart_hint":"afternoon"}},"eclipse_response":{"summary":"Eclipse Period Analysis Response","description":"Global analysis during eclipse showing heightened planetary activity","value":{"metadata":{"schema_version":"1.0","calculation_epoch_utc":"2024-10-14T18:55:00Z","timezone":"UTC","orbs":{"major_aspects_deg":3.0,"minor_aspects_deg":1.5}},"planets":[{"name":"Sun","sign":"Lib","degree":21.68,"absolute_longitude":201.68,"is_retrograde":false,"speed":1.0124,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":false}},"debilities":{"exile":false,"fall":true},"sect":"day","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Venus"],"about_to_change_sign":{"changing":false,"degrees_to_change":8.32}},{"name":"Moon","sign":"Ari","degree":21.71,"absolute_longitude":21.71,"is_retrograde":false,"speed":14.1892,"dignities":{"domicile":false,"exaltation":true,"triplicity":{"is_in_triplicity":true,"ruler":"Sun"}},"debilities":{"exile":false,"fall":false},"sect":"night","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mars"],"about_to_change_sign":{"changing":false,"degrees_to_change":8.29}},{"name":"Mean_Node","sign":"Ari","degree":22.45,"absolute_longitude":22.45,"is_retrograde":true,"speed":-0.0529,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":false}},"debilities":{"exile":false,"fall":false},"sect":"neutral","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mars"],"about_to_change_sign":{"changing":false,"degrees_to_change":7.55}}],"aspects":[{"planet_a":"Sun","planet_b":"Moon","aspect_type":"opposition","orb":0.03,"applying":false,"reception_quality":{"quality":"mixed","score":0.5},"dignity_context":{"both_dignified":false,"either_dignified":true},"aspect_strength":0.99},{"planet_a":"Moon","planet_b":"Mean_Node","aspect_type":"conjunction","orb":0.74,"applying":true,"reception_quality":{"quality":"neutral","score":0.0},"dignity_context":{"both_dignified":false,"either_dignified":true},"aspect_strength":0.75}],"fixed_stars":[{"star":"Spica","planet":"Sun","orb":2.1,"star_longitude":203.78,"traditional_meaning":"Most benefic star, brings success and protection"}],"lunar_phase":{"phase_name":"Full Moon","elongation_deg":179.97,"illumination_percent":99.8,"moon_age_days":14.7},"rarity":"Eclipse configuration","priority_score":0.95,"life_areas":["transformation","relationships","karmic_lessons"],"start_utc":"2024-10-14T00:00:00Z","end_utc":"2024-10-14T23:59:59Z","daypart_hint":"evening"}}}}}},"400":{"description":"Invalid enhanced analysis parameters"},"422":{"description":"Validation error in global analysis request","content":{"application/json":{"examples":{"invalid_time_format":{"summary":"Invalid Date/Time Format","description":"Error when date/time parameters are invalid or out of range","value":{"success":false,"error":{"error_code":"INVALID_DATE_TIME","message":"Invalid date/time format","field":"calculation_time.month","value":13,"severity":"medium","suggestions":["Month must be between 1 and 12","Use format: YYYY-MM-DD HH:MM:SS","Check all date components are valid"]},"timestamp":"2024-05-11T12:30:45Z"}},"invalid_celestial_points":{"summary":"Invalid Active Points","description":"Error when unknown celestial bodies are specified","value":{"success":false,"error":{"error_code":"INVALID_CELESTIAL_BODY","message":"Invalid celestial body name","field":"options.active_points","value":"invalid_planet","severity":"low","suggestions":["Use standard names: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn","For nodes: Mean_Node, True_Node, Mean_South_Node, True_South_Node","For angles: Ascendant, Medium_Coeli, Imum_Coeli, Descendant","See /api/v3/glossary/active-points for complete list"]},"timestamp":"2024-05-11T12:30:45Z"}},"invalid_orb_values":{"summary":"Invalid Orb Configuration","description":"Error when orb values are outside acceptable ranges","value":{"success":false,"error":{"error_code":"INVALID_ORB_CONFIG","message":"Orb values must be positive numbers","field":"orbs.major_aspects_deg","value":-2.0,"severity":"low","suggestions":["Major aspect orbs: 0.5 to 10.0 degrees (recommended: 1.0-3.0)","Minor aspect orbs: 0.1 to 5.0 degrees (recommended: 0.5-1.5)","Use smaller orbs for tighter analysis"]},"timestamp":"2024-05-11T12:30:45Z"}},"invalid_house_system":{"summary":"Invalid House System","description":"Error when unsupported house system is specified","value":{"success":false,"error":{"error_code":"INVALID_HOUSE_SYSTEM","message":"Invalid house system code","field":"options.house_system","value":"INVALID","severity":"low","suggestions":["Use single-letter codes: P (Placidus), W (Whole Sign), K (Koch)","Popular systems: A (Equal), R (Regiomontanus), C (Campanus)","See /api/v3/glossary/house-systems for complete list"]},"timestamp":"2024-05-11T12:30:45Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/enhanced/global-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/enhanced/global-analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/enhanced/global-analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/enhanced/global-analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/enhanced/global-analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/enhanced_charts/personal-analysis":{"post":{"tags":["✨ Enhanced Traditional Analysis (Alt Path)"],"summary":"Get Personal Analysis","description":"🏛️ **Personal Traditional Analysis** - Complete natal chart with traditional astrology\n\n**Perfect for:**\n- 🎯 Personal astrological consultations with birth data\n- 📱 Personalized astrology apps with natal correlation\n- 🔮 Traditional timing and profection analysis\n- 📊 Complete dignity and reception analysis\n\n**What you get:**\n- **Complete natal chart** with traditional enhancements\n- **Essential dignities** - domicile, exaltation, triplicity, term, decan\n- **Essential debilities** - exile and fall\n- **Planetary conditions** - combust, cazimi, under beams\n- **Dispositor chains** - full rulership sequences\n- **Mutual receptions** - traditional planetary relationships\n- **Annual profections** - Lord of the Year (Chronocrator)\n- **Fixed star conjunctions** - 7 major stars (Aldebaran, Regulus, etc.)\n- **Enhanced aspects** - with reception analysis\n- **Lunar phase data** - current Moon phase and elongation\n- **House system** - Whole Sign by default (traditional)\n\n**Traditional Features:**\n- Hellenistic astrology methods\n- Sect analysis (day/night chart)\n- Houses of joy (jubilation)\n- About-to-change-sign predictions\n- Complete 12-house data\n\n**Response time:** ~300ms | **Accuracy:** Swiss Ephemeris + Traditional calculations","operationId":"get_personal_analysis_api_v3_enhanced_charts_personal_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalAnalysisRequest"},"examples":{"comprehensive_analysis":{"summary":"Comprehensive Personal Analysis","description":"Complete traditional analysis with current transits and profections using standardized test subject","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"second":45,"city":"Kharkiv","country_code":"UA"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Part_of_Fortune","Part_of_Spirit"],"precision":4},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"dignity_focused":{"summary":"Dignity-Focused Analysis","description":"Emphasis on essential dignities and planetary conditions","value":{"subject":{"name":"Dignity Scholar","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":41.9028,"longitude":12.4964}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"precision":3},"orbs":{"major_aspects_deg":1.5,"minor_aspects_deg":0.5}}},"fixed_stars_analysis":{"summary":"Fixed Stars Analysis","description":"Personal analysis with emphasis on fixed star conjunctions","value":{"subject":{"name":"Star Gazer","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":0,"city":"Cairo","country_code":"EG"}},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Aldebaran","Regulus","Antares","Fomalhaut","Sirius"],"precision":2},"orbs":{"major_aspects_deg":2.5,"minor_aspects_deg":1.0}}},"night_chart_analysis":{"summary":"Night Chart - Sect Analysis","description":"Traditional analysis for night birth emphasizing nocturnal planets","value":{"subject":{"name":"Luna Nocturna","birth_data":{"year":1988,"month":7,"day":4,"hour":23,"minute":45,"second":0,"city":"Sydney","country_code":"AU"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Part_of_Fortune","Part_of_Spirit"],"precision":4},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"day_chart_analysis":{"summary":"Day Chart - Solar Emphasis","description":"Traditional analysis for day birth emphasizing diurnal planets","value":{"subject":{"name":"Sol Diurnus","birth_data":{"year":1995,"month":6,"day":21,"hour":12,"minute":0,"second":0,"latitude":48.8566,"longitude":2.3522}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":3},"orbs":{"major_aspects_deg":1.5,"minor_aspects_deg":0.5}}},"arabic_parts_focus":{"summary":"Arabic Parts Emphasis","description":"Analysis focusing on traditional Arabic Parts and Lots","value":{"subject":{"name":"Parts Master","birth_data":{"year":1987,"month":9,"day":23,"hour":15,"minute":30,"second":0,"city":"Baghdad","country_code":"IQ"}},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Part_of_Fortune","Part_of_Spirit"],"precision":5},"orbs":{"major_aspects_deg":3.0,"minor_aspects_deg":1.5}}},"mutual_reception_focus":{"summary":"Mutual Reception Analysis","description":"Emphasis on planetary mutual receptions and dispositor chains","value":{"subject":{"name":"Reception Scholar","birth_data":{"year":1991,"month":4,"day":10,"hour":6,"minute":30,"second":0,"city":"Florence","country_code":"IT"}},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node"],"precision":4},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"combustion_analysis":{"summary":"Combustion & Cazimi Analysis","description":"Focus on planets in combustion, cazimi, and under the beams","value":{"subject":{"name":"Solar Proximity","birth_data":{"year":1989,"month":8,"day":15,"hour":11,"minute":45,"second":0,"latitude":35.6762,"longitude":139.6503}},"options":{"house_system":"P","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Chiron"],"precision":6},"orbs":{"major_aspects_deg":1.0,"minor_aspects_deg":0.5}}},"sidereal_traditional":{"summary":"Sidereal Traditional Analysis","description":"Traditional Hellenistic techniques applied to Sidereal zodiac with Whole Sign houses","value":{"subject":{"name":"Sidereal Traditionalist","birth_data":{"year":1993,"month":12,"day":25,"hour":18,"minute":0,"second":0,"city":"Varanasi","country_code":"IN"}},"options":{"house_system":"W","zodiac_type":"Sidereal","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node"],"precision":3},"orbs":{"major_aspects_deg":2.5,"minor_aspects_deg":1.0}}},"profection_timing":{"summary":"Current Profection Analysis","description":"Personal analysis with current profection year timing","value":{"subject":{"name":"Timing Master","birth_data":{"year":1986,"month":3,"day":15,"hour":14,"minute":20,"second":0,"city":"Vienna","country_code":"AT"}},"calculation_time":{"year":2024,"month":3,"day":15,"hour":12,"minute":0,"second":0},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","Part_of_Fortune"],"precision":3},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}}}}},"required":true},"responses":{"200":{"description":"Personal traditional analysis completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalAnalysisResponse"},"examples":{"comprehensive_response":{"summary":"Complete Personal Analysis Response","description":"Traditional analysis with all components calculated","value":{"subject_data":{"name":"Oleg","year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","nation":"UA","lng":36.2527,"lat":49.9808,"tz_str":"Europe/Kiev"},"metadata":{"schema_version":"1.0","calculation_epoch_utc":"2024-05-11T15:30:00Z","timezone":"UTC","orbs":{"major_aspects_deg":2.0}},"ascendant":{"degree":15.45,"sign":"Leo","ruler":"Sun","house":1},"houses":[{"house":1,"sign":"Leo","degree":15.45},{"house":2,"sign":"Vir","degree":15.45}],"planets":[{"name":"Sun","quality":"Fixed","element":"Earth","sign":"Tau","sign_num":1,"position":20.82,"abs_pos":50.82,"emoji":"♉️","point_type":"Planet","house":"Tenth_House","retrograde":false,"dignities":{"domicile":false,"exaltation":false},"debilities":{"exile":false,"fall":false},"sect":"day","conditions":{"combust":false,"cazimi":false},"jubilation":false,"dispositor_chain":["Venus"],"about_to_change_sign":{"changing":false}}],"aspects":[{"planet_a":"Sun","planet_b":"Moon","aspect_type":"trine","orb":1.25,"applying":true,"reception_quality":{"quality":"neutral"},"dignity_context":{"both_dignified":false},"aspect_strength":0.85}],"fixed_stars":[{"star":"Aldebaran","planet":"Moon","orb":0.8,"star_longitude":69.47,"traditional_meaning":"Royal Watcher of the East"}],"lunar_phase":{"phase_name":"Waxing Gibbous","elongation_deg":130.5,"illumination_percent":85.2,"moon_age_days":10.7},"chronocrator":{"method":"Annual Profection","year_age":38,"sign":"Can","ruler":"Moon","house_themes":["home","family","emotional foundation"]},"priority_score":0.72,"activates":["Sun angular","Moon in domicile"],"house_crossings_next_72h":[],"life_areas":["career_success","creative_expression","leadership"],"start_utc":"2024-05-11T00:00:00Z","end_utc":"2024-05-11T23:59:59Z","daypart_hint":"afternoon"}}}}}},"400":{"description":"Invalid enhanced analysis parameters"},"422":{"description":"Validation error - check request format"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/enhanced_charts/personal-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/enhanced_charts/personal-analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/enhanced_charts/personal-analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/enhanced_charts/personal-analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/enhanced_charts/personal-analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/enhanced_charts/global-analysis":{"post":{"tags":["✨ Enhanced Traditional Analysis (Alt Path)"],"summary":"Get Global Analysis","description":"🌍 **Global Traditional Analysis** - Current planetary conditions without natal correlation\n\n**Perfect for:**\n- 🔮 Electional astrology (choosing optimal timing)\n- 📅 Universal astrological planning\n- 🌙 Lunar timing and void-of-course periods\n- 📊 Current sky analysis and research\n\n**What you get:**\n- **Current planetary positions** with traditional dignities\n- **Essential dignities** - domicile, exaltation, triplicity, term, decan\n- **Essential debilities** - exile and fall\n- **Planetary conditions** - combust, cazimi, under beams\n- **Current aspects** - between transiting planets\n- **Fixed star conjunctions** - 7 major stars\n- **Lunar phase data** - current Moon phase and elongation\n- **Sect analysis** - day/night determination\n- **Dispositor chains** - current rulership patterns\n- **Mutual receptions** - current planetary relationships\n\n**No Birth Data Required:**\n- Pure astronomical/astrological analysis\n- Universal timing information\n- Current planetary dignity states\n- Optimal for electional astrology\n\n**Response time:** ~200ms | **Accuracy:** Swiss Ephemeris + Traditional calculations","operationId":"get_global_analysis_api_v3_enhanced_charts_global_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalAnalysisRequest"},"examples":{"current_sky":{"summary":"Current Sky Analysis","description":"Current planetary conditions for electional astrology (uses current time)","value":{"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto"],"precision":3},"orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}}},"new_moon_timing":{"summary":"New Moon Electional","description":"Optimal timing analysis around New Moon for manifestation","value":{"calculation_time":{"year":2024,"month":4,"day":8,"hour":19,"minute":21,"second":0},"options":{"house_system":"A","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","Part_of_Fortune"],"precision":4},"orbs":{"major_aspects_deg":1.5,"minor_aspects_deg":0.5}}},"eclipse_analysis":{"summary":"Eclipse Period Analysis","description":"Global analysis during eclipse for major timing decisions","value":{"calculation_time":{"year":2024,"month":10,"day":14,"hour":18,"minute":55,"second":0},"options":{"house_system":"W","zodiac_type":"Tropic","active_points":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Mean_Node","True_Node","Mean_South_Node","True_South_Node"],"precision":5},"orbs":{"major_aspects_deg":3.0,"minor_aspects_deg":1.5}}}}}},"required":true},"responses":{"200":{"description":"Global traditional analysis completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalAnalysisResponse"},"examples":{"current_sky_response":{"summary":"Current Sky Analysis Response","description":"Complete global analysis with current planetary conditions","value":{"metadata":{"schema_version":"1.0","calculation_epoch_utc":"2024-05-11T12:30:00Z","timezone":"UTC","orbs":{"major_aspects_deg":2.0,"minor_aspects_deg":1.0}},"planets":[{"name":"Sun","sign":"Tau","degree":21.15,"absolute_longitude":51.15,"is_retrograde":false,"speed":0.9583,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":true,"ruler":"Venus"}},"debilities":{"exile":false,"fall":false},"sect":"day","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Venus"],"about_to_change_sign":{"changing":false,"degrees_to_change":8.85}},{"name":"Moon","sign":"Sco","degree":12.87,"absolute_longitude":222.87,"is_retrograde":false,"speed":13.2456,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":true,"ruler":"Mars"}},"debilities":{"exile":false,"fall":false},"sect":"night","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mars","Pluto"],"about_to_change_sign":{"changing":false,"degrees_to_change":17.13}},{"name":"Jupiter","sign":"Gem","degree":28.42,"absolute_longitude":88.42,"is_retrograde":false,"speed":0.2134,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":false}},"debilities":{"exile":true,"fall":false},"sect":"day","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mercury"],"about_to_change_sign":{"changing":true,"degrees_to_change":1.58}}],"aspects":[{"planet_a":"Sun","planet_b":"Moon","aspect_type":"opposition","orb":1.72,"applying":false,"reception_quality":{"quality":"neutral","score":0.0},"dignity_context":{"both_dignified":false,"either_dignified":false},"aspect_strength":0.91},{"planet_a":"Sun","planet_b":"Jupiter","aspect_type":"sextile","orb":0.88,"applying":true,"reception_quality":{"quality":"neutral","score":0.0},"dignity_context":{"both_dignified":false,"either_dignified":false},"aspect_strength":0.85}],"fixed_stars":[{"star":"Aldebaran","planet":"Moon","orb":1.2,"star_longitude":69.47,"traditional_meaning":"Royal Watcher of the East, brings honor when rising"}],"lunar_phase":{"phase_name":"Waning Gibbous","elongation_deg":171.72,"illumination_percent":95.4,"moon_age_days":14.05},"rarity":"High aspect density","priority_score":0.68,"life_areas":["relationships","values_resources","communication"],"start_utc":"2024-05-11T00:00:00Z","end_utc":"2024-05-11T23:59:59Z","daypart_hint":"afternoon"}},"eclipse_response":{"summary":"Eclipse Period Analysis Response","description":"Global analysis during eclipse showing heightened planetary activity","value":{"metadata":{"schema_version":"1.0","calculation_epoch_utc":"2024-10-14T18:55:00Z","timezone":"UTC","orbs":{"major_aspects_deg":3.0,"minor_aspects_deg":1.5}},"planets":[{"name":"Sun","sign":"Lib","degree":21.68,"absolute_longitude":201.68,"is_retrograde":false,"speed":1.0124,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":false}},"debilities":{"exile":false,"fall":true},"sect":"day","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Venus"],"about_to_change_sign":{"changing":false,"degrees_to_change":8.32}},{"name":"Moon","sign":"Ari","degree":21.71,"absolute_longitude":21.71,"is_retrograde":false,"speed":14.1892,"dignities":{"domicile":false,"exaltation":true,"triplicity":{"is_in_triplicity":true,"ruler":"Sun"}},"debilities":{"exile":false,"fall":false},"sect":"night","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mars"],"about_to_change_sign":{"changing":false,"degrees_to_change":8.29}},{"name":"Mean_Node","sign":"Ari","degree":22.45,"absolute_longitude":22.45,"is_retrograde":true,"speed":-0.0529,"dignities":{"domicile":false,"exaltation":false,"triplicity":{"is_in_triplicity":false}},"debilities":{"exile":false,"fall":false},"sect":"neutral","conditions":{"combust":false,"cazimi":false,"under_beams":false},"jubilation":false,"dispositor_chain":["Mars"],"about_to_change_sign":{"changing":false,"degrees_to_change":7.55}}],"aspects":[{"planet_a":"Sun","planet_b":"Moon","aspect_type":"opposition","orb":0.03,"applying":false,"reception_quality":{"quality":"mixed","score":0.5},"dignity_context":{"both_dignified":false,"either_dignified":true},"aspect_strength":0.99},{"planet_a":"Moon","planet_b":"Mean_Node","aspect_type":"conjunction","orb":0.74,"applying":true,"reception_quality":{"quality":"neutral","score":0.0},"dignity_context":{"both_dignified":false,"either_dignified":true},"aspect_strength":0.75}],"fixed_stars":[{"star":"Spica","planet":"Sun","orb":2.1,"star_longitude":203.78,"traditional_meaning":"Most benefic star, brings success and protection"}],"lunar_phase":{"phase_name":"Full Moon","elongation_deg":179.97,"illumination_percent":99.8,"moon_age_days":14.7},"rarity":"Eclipse configuration","priority_score":0.95,"life_areas":["transformation","relationships","karmic_lessons"],"start_utc":"2024-10-14T00:00:00Z","end_utc":"2024-10-14T23:59:59Z","daypart_hint":"evening"}}}}}},"400":{"description":"Invalid enhanced analysis parameters"},"422":{"description":"Validation error in global analysis request","content":{"application/json":{"examples":{"invalid_time_format":{"summary":"Invalid Date/Time Format","description":"Error when date/time parameters are invalid or out of range","value":{"success":false,"error":{"error_code":"INVALID_DATE_TIME","message":"Invalid date/time format","field":"calculation_time.month","value":13,"severity":"medium","suggestions":["Month must be between 1 and 12","Use format: YYYY-MM-DD HH:MM:SS","Check all date components are valid"]},"timestamp":"2024-05-11T12:30:45Z"}},"invalid_celestial_points":{"summary":"Invalid Active Points","description":"Error when unknown celestial bodies are specified","value":{"success":false,"error":{"error_code":"INVALID_CELESTIAL_BODY","message":"Invalid celestial body name","field":"options.active_points","value":"invalid_planet","severity":"low","suggestions":["Use standard names: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn","For nodes: Mean_Node, True_Node, Mean_South_Node, True_South_Node","For angles: Ascendant, Medium_Coeli, Imum_Coeli, Descendant","See /api/v3/glossary/active-points for complete list"]},"timestamp":"2024-05-11T12:30:45Z"}},"invalid_orb_values":{"summary":"Invalid Orb Configuration","description":"Error when orb values are outside acceptable ranges","value":{"success":false,"error":{"error_code":"INVALID_ORB_CONFIG","message":"Orb values must be positive numbers","field":"orbs.major_aspects_deg","value":-2.0,"severity":"low","suggestions":["Major aspect orbs: 0.5 to 10.0 degrees (recommended: 1.0-3.0)","Minor aspect orbs: 0.1 to 5.0 degrees (recommended: 0.5-1.5)","Use smaller orbs for tighter analysis"]},"timestamp":"2024-05-11T12:30:45Z"}},"invalid_house_system":{"summary":"Invalid House System","description":"Error when unsupported house system is specified","value":{"success":false,"error":{"error_code":"INVALID_HOUSE_SYSTEM","message":"Invalid house system code","field":"options.house_system","value":"INVALID","severity":"low","suggestions":["Use single-letter codes: P (Placidus), W (Whole Sign), K (Koch)","Popular systems: A (Equal), R (Regiomontanus), C (Campanus)","See /api/v3/glossary/house-systems for complete list"]},"timestamp":"2024-05-11T12:30:45Z"}}}}}}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/enhanced_charts/global-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/enhanced_charts/global-analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/enhanced_charts/global-analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/enhanced_charts/global-analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/enhanced_charts/global-analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/map":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Generate Astrocartography Map","description":"🗺️ **Generate Astrocartography SVG Map** - Planetary influence lines on world map\n\n**Perfect for:**\n- 🌍 Relocation astrology consultations\n- 📱 Travel planning applications\n- 🎯 Finding power locations worldwide\n- 📊 Geographic astrology analysis\n\n**What you get:**\n- **Planetary lines** - AC, MC, DS, IC lines for selected planets\n- **World map** - Accurate geographic projection with country boundaries\n- **Power zones** - Highlighted intersections of planetary lines\n- **City markers** - Major cities with population filtering\n- **Interactive data** - Coordinates and meanings for frontend integration\n- **Customizable** - Size, colors, projection, and styling options\n\n**Line Types:**\n- **AC (Ascendant)** - Where planet rises on eastern horizon\n- **MC (Midheaven)** - Where planet culminates overhead\n- **DS (Descendant)** - Where planet sets on western horizon\n- **IC (Imum Coeli)** - Where planet is at lowest point\n\n**Supported Planets:**\nSun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto,\nMean_Node, True_Node, Chiron\n\n**Map Projections:**\n- **Mercator** - Standard web mapping (default)\n- **Robinson** - Balanced world view\n- **Mollweide** - Equal-area projection\n- **Equirectangular** - Simple latitude/longitude grid\n\n**Response time:** ~800ms | **Format:** Scalable SVG with embedded data","operationId":"generate_astrocartography_map_api_v3_astrocartography_map_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrocartographyMapRequest"},"examples":{"world_map_basic":{"summary":"Basic World Map","description":"Standard astrocartography map with main planets","value":{"subject":{"name":"World Explorer","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"map_options":{"planets":["Sun","Moon","Venus","Jupiter","Mars"],"line_types":["AC","MC"],"map_projection":"mercator"},"visual_options":{"width":1200,"height":600,"theme":"modern","show_legend":true,"city_min_population":750000}}},"focused_region":{"summary":"Regional Focus - North America","description":"Focused map of North America with all line types","value":{"subject":{"name":"Regional Seeker","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":0,"latitude":40.7128,"longitude":-74.006}},"map_options":{"planets":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"line_types":["AC","MC","DS","IC"],"region":{"latitude_range":[25,70],"longitude_range":[-140,-50]}},"visual_options":{"width":1400,"height":800,"theme":"classic","highlight_power_zones":true}}},"high_precision":{"summary":"High Precision Analysis","description":"Detailed map with moderate precision for faster processing","value":{"subject":{"name":"Precision Astrologer","birth_data":{"year":1992,"month":11,"day":8,"hour":9,"minute":15,"second":30,"city":"Paris","country_code":"FR"}},"map_options":{"planets":["Sun","Moon","Mercury","Venus"],"line_types":["AC","MC"],"coordinate_precision":4},"visual_options":{"width":1200,"height":600,"theme":"dark","city_min_population":750000}}}}}},"required":true},"responses":{"200":{"description":"Successful astrocartography map generation with complete SVG and interactive data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrocartographyMapResponse"},"example":{"success":true,"svg_content":"","map_data":{"lines":[{"planet":"Sun","line_type":"AC","coordinates":[{"latitude":75.0,"longitude":-180.0},{"latitude":65.5,"longitude":-120.0},{"latitude":45.2,"longitude":-60.0},{"latitude":25.8,"longitude":0.0},{"latitude":15.3,"longitude":60.0},{"latitude":-5.2,"longitude":120.0},{"latitude":-25.7,"longitude":180.0}],"color":"#FFD700","meaning":"Solar vitality and leadership energy rises on the eastern horizon along this line","strength":"very_strong","keywords":["leadership","vitality","confidence","recognition"]},{"planet":"Moon","line_type":"AC","coordinates":[{"latitude":68.3,"longitude":-180.0},{"latitude":52.1,"longitude":-120.0},{"latitude":35.7,"longitude":-60.0},{"latitude":18.9,"longitude":0.0},{"latitude":2.4,"longitude":60.0},{"latitude":-15.8,"longitude":120.0},{"latitude":-32.1,"longitude":180.0}],"color":"#C0C0C0","meaning":"Emotional sensitivity and intuitive awareness heightened along this line","strength":"strong","keywords":["emotion","intuition","home","nurturing"]},{"planet":"Venus","line_type":"MC","coordinates":[{"latitude":90.0,"longitude":45.2},{"latitude":60.0,"longitude":45.2},{"latitude":30.0,"longitude":45.2},{"latitude":0.0,"longitude":45.2},{"latitude":-30.0,"longitude":45.2},{"latitude":-60.0,"longitude":45.2},{"latitude":-90.0,"longitude":45.2}],"color":"#00FF7F","meaning":"Love, beauty, and artistic expression culminate overhead along this line","strength":"strong","keywords":["love","beauty","art","harmony"]},{"planet":"Jupiter","line_type":"MC","coordinates":[{"latitude":90.0,"longitude":78.9},{"latitude":60.0,"longitude":78.9},{"latitude":30.0,"longitude":78.9},{"latitude":0.0,"longitude":78.9},{"latitude":-30.0,"longitude":78.9},{"latitude":-60.0,"longitude":78.9},{"latitude":-90.0,"longitude":78.9}],"color":"#1E90FF","meaning":"Expansion, opportunity, and wisdom reach their peak along this line","strength":"very_strong","keywords":["expansion","opportunity","wisdom","prosperity"]},{"planet":"Mars","line_type":"DS","coordinates":[{"latitude":45.8,"longitude":-180.0},{"latitude":38.2,"longitude":-120.0},{"latitude":28.7,"longitude":-60.0},{"latitude":16.3,"longitude":0.0},{"latitude":2.9,"longitude":60.0},{"latitude":-12.4,"longitude":120.0},{"latitude":-28.1,"longitude":180.0}],"color":"#FF4500","meaning":"Energy, action, and assertiveness set on the western horizon along this line","strength":"strong","keywords":["energy","action","courage","competition"]}],"power_zones":[{"center_coordinates":{"latitude":40.7128,"longitude":-74.006},"intersecting_lines":[{"planet":"Sun","line_type":"AC"},{"planet":"Jupiter","line_type":"MC"}],"combined_strength":8.7,"meaning":"Powerful zone for leadership, recognition, and expansion of influence","nearby_cities":[{"name":"New York","distance_km":12.5}],"radius_km":85.3},{"center_coordinates":{"latitude":51.5074,"longitude":-0.1278},"intersecting_lines":[{"planet":"Venus","line_type":"AC"},{"planet":"Moon","line_type":"IC"}],"combined_strength":7.2,"meaning":"Harmonious zone for relationships, creativity, and emotional fulfillment","nearby_cities":[{"name":"London","distance_km":8.7}],"radius_km":92.1}],"cities_shown":[{"name":"New York","country":"United States","country_code":"US","coordinates":{"latitude":40.7128,"longitude":-74.006},"population":8336817,"nearby_lines":[{"planet":"Sun","line_type":"AC","distance_km":45.2},{"planet":"Jupiter","line_type":"MC","distance_km":78.9}],"overall_score":8.4},{"name":"London","country":"United Kingdom","country_code":"GB","coordinates":{"latitude":51.5074,"longitude":-0.1278},"population":9648110,"nearby_lines":[{"planet":"Venus","line_type":"AC","distance_km":23.7},{"planet":"Moon","line_type":"IC","distance_km":67.3}],"overall_score":7.8},{"name":"Paris","country":"France","country_code":"FR","coordinates":{"latitude":48.8566,"longitude":2.3522},"population":2161000,"nearby_lines":[{"planet":"Venus","line_type":"MC","distance_km":156.8},{"planet":"Moon","line_type":"AC","distance_km":201.3}],"overall_score":6.9}]},"interactive_data":{"clickable_regions":[{"region_id":"sun-ac-north-america","coordinates":[{"latitude":45.0,"longitude":-120.0},{"latitude":50.0,"longitude":-110.0}],"tooltip":"Sun Ascendant Line - Leadership and vitality","detailed_info":{"planet":"Sun","line_type":"AC","strength":"very_strong"}}],"hover_zones":[{"zone_id":"power-zone-1","center":{"latitude":40.7128,"longitude":-74.006},"radius":85.3,"tooltip":"Sun-Jupiter Power Zone"}],"city_markers":[{"name":"New York","coordinates":{"latitude":40.7128,"longitude":-74.006}},{"name":"London","coordinates":{"latitude":51.5074,"longitude":-0.1278}},{"name":"Paris","coordinates":{"latitude":48.8566,"longitude":2.3522}}],"line_segments":[{"line_id":"sun-ac","start":{"latitude":75.0,"longitude":-180.0},"end":{"latitude":-25.7,"longitude":180.0}},{"line_id":"venus-mc","start":{"latitude":90.0,"longitude":45.2},"end":{"latitude":-90.0,"longitude":45.2}}]},"svg_metadata":{"width":1200,"height":600,"file_size_bytes":87432,"element_counts":{"lines":5,"cities":3,"power_zones":2,"text_elements":12,"path_elements":45,"circle_elements":8},"theme":"modern","generation_time_ms":743.2},"city_selection_stats":{"algorithm_used":"round_robin","total_candidates":15,"selected_count":3,"countries_represented":3,"geographic_diversity_score":0.75,"selection_criteria":{"min_population":750000,"search_radius_km":100,"max_cities_per_country":4,"max_cities_per_line":2}},"power_zone_algorithm":"intersection_strength_based","legend_sections":[{"name":"Planetary Lines","position":"top-center","items":5},{"name":"Line Types","position":"bottom-center","items":3},{"name":"Power Zones","position":"bottom-center","items":2}],"metadata":{"projection":"mercator","planets_shown":["Sun","Moon","Venus","Jupiter","Mars"],"line_types":["AC","MC","DS"],"total_lines":5,"power_zones":2,"generation_time":"2024-01-15T14:30:45Z","svg_size":{"width":1200,"height":600,"estimated_size_kb":85}}}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error in astrocartography map parameters","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INVALID_CELESTIAL_BODY","message":"Invalid celestial body name specified","field":"planets","value":"Plut0","severity":"medium","suggestions":["Use standard names: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto","See /api/v3/glossary/active-points for complete list"]},"timestamp":"2024-01-15T14:30:45Z"}}}},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/map\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/map\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/map\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/map\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/map\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/render":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Render Astrocartography Map","description":"🗺️ **Render Astrocartography Map** - Multi-format map generation\n\n**Output Formats:**\n- `svg` - Scalable vector (default) - best for web, interactive features\n- `png` - Raster with transparency - email reports (Outlook compatible!)\n- `jpg` - Compressed raster - social media sharing\n- `webp` - Modern format - 30% smaller than PNG\n- `pdf` - Print-ready vector - professional consultations\n\n**Size Options:**\n- `width` - Output width in pixels (100-4096)\n- `scale` - Resolution multiplier for HiDPI displays\n\n**🎨 Custom Colors:**\nOverride default theme colors for branded maps:\n- `background`, `text`, `primary`, `secondary`\n- `aspect_harmony`, `aspect_tension`\n\n**Use Cases:**\n- 📧 Email reports → `png` or `jpg` (Outlook compatible)\n- 🌐 Web display → `svg` (interactive, scalable)\n- 📱 Social media → `jpg` with width=1200\n- 🖨️ Print → `pdf` with scale=2.0\n- 🎨 White-label → `custom_colors` for brand consistency\n\n**Response time:** ~800-1200ms depending on format and complexity","operationId":"render_astrocartography_map_api_v3_astrocartography_render_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrocartographyRenderRequest"},"examples":{"svg_default":{"summary":"SVG Map (Default)","description":"Scalable vector map for web display","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"map_options":{"planets":["Sun","Moon","Venus","Mars","Jupiter"]},"visual_options":{"theme":"dark"},"render_options":{"format":"svg"}}},"png_email":{"summary":"PNG for Email/Reports","description":"Raster format for email reports, works in Outlook","value":{"subject":{"name":"Emma Wilson","birth_data":{"year":1990,"month":8,"day":22,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"map_options":{"planets":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"]},"visual_options":{"theme":"classic","show_cities":true,"city_min_population":1000000},"render_options":{"format":"png","width":1600,"scale":1.5}}},"pdf_print":{"summary":"PDF for Print","description":"Vector format for high-quality printing","value":{"subject":{"name":"James Chen","birth_data":{"year":1975,"month":12,"day":8,"hour":6,"minute":0,"city":"Tokyo","country_code":"JP"}},"visual_options":{"theme":"classic"},"render_options":{"format":"pdf","scale":2.0}}},"custom_branded":{"summary":"🎨 Custom Branded Map","description":"Map with custom brand colors for white-label apps","value":{"subject":{"name":"Brand Style","birth_data":{"year":1990,"month":6,"day":15,"hour":12,"minute":0,"city":"New York","country_code":"US"}},"map_options":{"planets":["Sun","Moon","Venus","Jupiter"]},"visual_options":{"theme":"dark"},"render_options":{"format":"png","width":1920,"custom_colors":{"background":"#0a0a1a","text":"#e0e0ff","primary":"#8b5cf6","secondary":"#06b6d4"}}}},"with_interpretations":{"summary":"🔮 Map with Life Area Interpretations","description":"Full-featured map with colored power zones, life area icons, and city markers","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"visual_options":{"theme":"dark","interpretation_icons":"below","interpretation_colored_zones":true,"show_city_life_area_icons":true},"render_options":{"format":"png","width":1800}}},"minimal_clean":{"summary":"🧹 Minimal Clean Map","description":"Clean map without interpretations - just lines and cities","value":{"subject":{"name":"Test","birth_data":{"year":1990,"month":3,"day":20,"hour":10,"minute":0,"city":"London","country_code":"GB"}},"visual_options":{"theme":"classic","interpretation_icons":"none","show_city_life_area_icons":false,"line_label_mode":"none"},"render_options":{"format":"svg"}}}}}},"required":true},"responses":{"200":{"description":"Astrocartography map image in requested format","content":{"application/json":{"schema":{}},"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/render\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/render\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/render\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/render\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/render\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/lines":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Get Astrocartography Lines","description":"📊 **Raw Astrocartography Line Data** - Coordinate data without visualization\n\n**Perfect for:**\n- 🔧 Custom map implementations\n- 📱 Mobile app integration\n- 🎯 Precise coordinate analysis\n- 📊 Data processing and analysis\n\n**What you get:**\n- **Precise coordinates** - Latitude/longitude points for each line\n- **Line metadata** - Planet, type, color, meaning, strength\n- **Calculation info** - Ephemeris, precision, coordinate system details\n- **Birth location** - Original birth coordinates and city info\n- **Keywords** - Astrological themes for each line\n\n**Coordinate Density:**\n- **20-100** - Basic mapping (fast)\n- **100-300** - Standard precision (recommended)\n- **300-500** - High precision (detailed analysis)\n\n**Use Cases:**\n- Build custom interactive maps\n- Integrate with GIS systems\n- Create mobile visualizations\n- Perform statistical analysis\n\n**Response time:** ~300ms | **Accuracy:** Swiss Ephemeris precision","operationId":"get_astrocartography_lines_api_v3_astrocartography_lines_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrocartographyLinesRequest"},"examples":{"basic_lines":{"summary":"Basic Planetary Lines","description":"Raw coordinate data for main planets and angles","value":{"subject":{"name":"Data Analyst","birth_data":{"year":1988,"month":3,"day":25,"hour":12,"minute":0,"second":0,"city":"Sydney","country_code":"AU"}},"options":{"planets":["Sun","Moon","Venus","Jupiter"],"line_types":["AC","MC"],"coordinate_precision":4},"coordinate_density":50}},"high_density":{"summary":"High Density Coordinates","description":"Maximum coordinate density for precise mapping","value":{"subject":{"name":"Precision Mapper","birth_data":{"year":1995,"month":7,"day":4,"hour":16,"minute":30,"second":0,"latitude":35.6762,"longitude":139.6503}},"options":{"planets":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn"],"line_types":["AC","MC","DS","IC"],"coordinate_precision":6,"region":{"latitude_range":[-90,90],"longitude_range":[-180,180]}},"coordinate_density":500}}}}},"required":true},"responses":{"200":{"description":"Successful astrocartography lines calculation with precise coordinate data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrocartographyLinesResponse"},"example":{"success":true,"lines":[{"planet":"Sun","line_type":"AC","coordinates":[{"latitude":70.2,"longitude":-180.0},{"latitude":65.7,"longitude":-150.0},{"latitude":58.3,"longitude":-120.0},{"latitude":47.8,"longitude":-90.0},{"latitude":35.2,"longitude":-60.0},{"latitude":20.1,"longitude":-30.0},{"latitude":12.4,"longitude":0.0},{"latitude":8.7,"longitude":30.0},{"latitude":-2.3,"longitude":60.0},{"latitude":-15.8,"longitude":90.0},{"latitude":-28.9,"longitude":120.0},{"latitude":-42.1,"longitude":150.0},{"latitude":-55.4,"longitude":180.0}],"color":"#FFD700","meaning":"The Sun Ascendant line represents where solar energy rises on the eastern horizon. Living near this line enhances leadership qualities, vitality, confidence, and public recognition. This is an excellent line for career advancement and personal visibility.","strength":"very_strong","keywords":["leadership","vitality","confidence","recognition","authority","self-expression"]},{"planet":"Moon","line_type":"AC","coordinates":[{"latitude":62.8,"longitude":-180.0},{"latitude":57.4,"longitude":-150.0},{"latitude":49.1,"longitude":-120.0},{"latitude":38.6,"longitude":-90.0},{"latitude":26.3,"longitude":-60.0},{"latitude":12.9,"longitude":-30.0},{"latitude":4.7,"longitude":0.0},{"latitude":-1.2,"longitude":30.0},{"latitude":-8.9,"longitude":60.0},{"latitude":-18.5,"longitude":90.0},{"latitude":-29.7,"longitude":120.0},{"latitude":-41.3,"longitude":150.0},{"latitude":-53.2,"longitude":180.0}],"color":"#C0C0C0","meaning":"The Moon Ascendant line enhances emotional sensitivity, intuition, and connection to home and family. This line is favorable for nurturing activities, real estate, hospitality, and any work involving caring for others.","strength":"strong","keywords":["emotion","intuition","home","nurturing","family","security"]},{"planet":"Venus","line_type":"MC","coordinates":[{"latitude":80.0,"longitude":25.4},{"latitude":70.0,"longitude":25.4},{"latitude":60.0,"longitude":25.4},{"latitude":50.0,"longitude":25.4},{"latitude":40.0,"longitude":25.4},{"latitude":30.0,"longitude":25.4},{"latitude":20.0,"longitude":25.4},{"latitude":10.0,"longitude":25.4},{"latitude":0.0,"longitude":25.4},{"latitude":-10.0,"longitude":25.4},{"latitude":-20.0,"longitude":25.4},{"latitude":-30.0,"longitude":25.4},{"latitude":-40.0,"longitude":25.4},{"latitude":-50.0,"longitude":25.4},{"latitude":-60.0,"longitude":25.4}],"color":"#00FF7F","meaning":"The Venus Midheaven line brings harmony, beauty, and artistic success to the career and public reputation. This line is excellent for creative professions, relationship counseling, luxury goods, and any work involving aesthetics or diplomacy.","strength":"strong","keywords":["love","beauty","art","harmony","relationships","luxury"]},{"planet":"Jupiter","line_type":"MC","coordinates":[{"latitude":80.0,"longitude":95.7},{"latitude":70.0,"longitude":95.7},{"latitude":60.0,"longitude":95.7},{"latitude":50.0,"longitude":95.7},{"latitude":40.0,"longitude":95.7},{"latitude":30.0,"longitude":95.7},{"latitude":20.0,"longitude":95.7},{"latitude":10.0,"longitude":95.7},{"latitude":0.0,"longitude":95.7},{"latitude":-10.0,"longitude":95.7},{"latitude":-20.0,"longitude":95.7},{"latitude":-30.0,"longitude":95.7},{"latitude":-40.0,"longitude":95.7},{"latitude":-50.0,"longitude":95.7},{"latitude":-60.0,"longitude":95.7}],"color":"#1E90FF","meaning":"The Jupiter Midheaven line represents expansion, opportunity, and wisdom in career matters. This line is highly favorable for teaching, publishing, international business, law, and higher education. Success comes through knowledge and ethical practices.","strength":"very_strong","keywords":["expansion","opportunity","wisdom","prosperity","teaching","international"]},{"planet":"Mars","line_type":"DS","coordinates":[{"latitude":48.3,"longitude":-180.0},{"latitude":43.7,"longitude":-150.0},{"latitude":37.2,"longitude":-120.0},{"latitude":28.9,"longitude":-90.0},{"latitude":19.1,"longitude":-60.0},{"latitude":8.4,"longitude":-30.0},{"latitude":-2.7,"longitude":0.0},{"latitude":-14.3,"longitude":30.0},{"latitude":-26.8,"longitude":60.0},{"latitude":-39.5,"longitude":90.0},{"latitude":-52.1,"longitude":120.0},{"latitude":-64.6,"longitude":150.0},{"latitude":-76.8,"longitude":180.0}],"color":"#FF4500","meaning":"The Mars Descendant line emphasizes action, competition, and assertiveness in partnerships and relationships. This line can bring dynamic energy but may also increase conflicts. Good for competitive sports, military, and leadership roles.","strength":"strong","keywords":["energy","action","courage","competition","conflict","assertiveness"]},{"planet":"Mercury","line_type":"IC","coordinates":[{"latitude":45.9,"longitude":-165.8},{"latitude":41.2,"longitude":-165.8},{"latitude":35.6,"longitude":-165.8},{"latitude":28.7,"longitude":-165.8},{"latitude":20.3,"longitude":-165.8},{"latitude":10.8,"longitude":-165.8},{"latitude":0.5,"longitude":-165.8},{"latitude":-10.2,"longitude":-165.8},{"latitude":-21.4,"longitude":-165.8},{"latitude":-33.1,"longitude":-165.8},{"latitude":-45.2,"longitude":-165.8},{"latitude":-57.6,"longitude":-165.8},{"latitude":-70.1,"longitude":-165.8}],"color":"#32CD32","meaning":"The Mercury IC line influences the home environment with communication, learning, and mental activity. This line is favorable for home-based businesses, writing, teaching, and any work involving information or communication from your private base.","strength":"moderate","keywords":["communication","learning","writing","networking","information","flexibility"]},{"planet":"Saturn","line_type":"AC","coordinates":[{"latitude":55.4,"longitude":-180.0},{"latitude":49.8,"longitude":-150.0},{"latitude":42.1,"longitude":-120.0},{"latitude":32.7,"longitude":-90.0},{"latitude":21.9,"longitude":-60.0},{"latitude":10.2,"longitude":-30.0},{"latitude":-2.1,"longitude":0.0},{"latitude":-15.3,"longitude":30.0},{"latitude":-29.2,"longitude":60.0},{"latitude":-43.7,"longitude":90.0},{"latitude":-58.9,"longitude":120.0},{"latitude":-74.5,"longitude":150.0}],"color":"#8B4513","meaning":"The Saturn Ascendant line brings discipline, responsibility, and serious focus to personal identity and life direction. This line can create challenges but also builds lasting achievements through hard work and perseverance.","strength":"strong","keywords":["discipline","responsibility","structure","achievement","limitation","maturity"]}],"birth_location":{"latitude":-33.8688,"longitude":151.2093,"city":"Sydney","country":"AU","marker_color":"#FF0000"},"calculation_info":{"ephemeris":"swiss_ephemeris","coordinate_system":"WGS84","precision_decimal_places":4,"coordinate_density":50,"calculation_time":"2024-01-15T14:30:45.123Z"}}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error in astrocartography lines parameters","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INVALID_COORDINATE_DENSITY","message":"Coordinate density must be between 20 and 500","field":"coordinate_density","value":"750","severity":"medium","suggestions":["Use coordinate density between 20-500 for optimal performance","Lower values (20-100) for faster processing","Higher values (300-500) for detailed analysis"]},"timestamp":"2024-01-15T14:30:45Z"}}}},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/lines\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/lines\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/lines\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/lines\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/lines\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/location-analysis":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Analyze Location","description":"🎯 **Analyze Specific Location** - Detailed astrological analysis for any location\n\n**Perfect for:**\n- 🏠 Relocation decision making\n- 🎯 Evaluating potential moves\n- 📊 Comparing location options\n- 🔍 Understanding local influences\n\n**What you get:**\n- **Nearby lines** - Planetary lines within orb tolerance\n- **Relocated chart** - How your natal chart changes at this location\n- **Life area ratings** - Scores for career, love, creativity, health, etc.\n- **Overall score** - Comprehensive location rating (0-10)\n- **Detailed analysis** - Strengths, challenges, and opportunities\n- **Summary** - Key insights and recommendations\n\n**Life Areas Analyzed:**\n- **Career** - Professional success and recognition\n- **Relationships** - Love, partnerships, social connections\n- **Creativity** - Artistic expression and inspiration\n- **Health** - Physical and mental wellbeing\n- **Spirituality** - Growth and higher learning\n- **Finances** - Material prosperity and resources\n\n**Analysis Factors:**\n- Planetary line proximity and strength\n- House changes in relocated chart\n- Angular planet emphasis\n- Aspect pattern modifications\n- Traditional dignity considerations\n\n**Response time:** ~500ms | **Accuracy:** Professional grade analysis","operationId":"analyze_location_api_v3_astrocartography_location_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationAnalysisRequest"},"examples":{"city_analysis":{"summary":"Analyze Specific City","description":"Complete astrological analysis of living in Los Angeles","value":{"subject":{"name":"Location Seeker","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"location":{"city":"Los Angeles","country_code":"US"},"analysis_options":{"orb_tolerance":2.0,"include_minor_aspects":false}}},"coordinate_analysis":{"summary":"Analyze by Coordinates","description":"Analysis using exact latitude/longitude coordinates","value":{"subject":{"name":"Coordinate Explorer","birth_data":{"year":1985,"month":12,"day":25,"hour":10,"minute":15,"second":0,"latitude":51.5074,"longitude":-0.1278}},"location":{"latitude":48.8566,"longitude":2.3522},"analysis_options":{"orb_tolerance":1.5,"include_minor_aspects":true}}}}}},"required":true},"responses":{"200":{"description":"Successful location analysis with astrological insights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationAnalysisResponse"},"example":{"success":true,"location_info":{"city":"Los Angeles","country":"United States","country_code":"US","state":"California","coordinates":{"latitude":34.0522,"longitude":-118.2437},"timezone":"America/Los_Angeles","population":3898747,"elevation_m":71,"climate_zone":"Mediterranean","region":"West Coast"},"nearby_lines":[{"planet":"Sun","line_type":"AC","distance_km":78.3,"orb_degrees":0.7,"strength":"very_strong","meaning":"Strong solar energy enhances leadership qualities, confidence, and public recognition in Los Angeles. Excellent for entertainment industry and creative leadership roles."},{"planet":"Venus","line_type":"MC","distance_km":142.7,"orb_degrees":1.3,"strength":"strong","meaning":"Venus at the Midheaven brings harmony, beauty, and artistic success to career endeavors. Perfect for entertainment, beauty, luxury, and relationship-focused professions."},{"planet":"Jupiter","line_type":"DS","distance_km":203.5,"orb_degrees":1.8,"strength":"moderate","meaning":"Jupiter influence on relationships and partnerships brings expansion opportunities through connections with others. Favorable for business partnerships and international relationships."},{"planet":"Mars","line_type":"IC","distance_km":89.1,"orb_degrees":0.8,"strength":"strong","meaning":"Mars energy at the foundation brings dynamic activity to home and private life. Can increase real estate opportunities but may also bring more activity and competition to domestic sphere."}],"relocated_chart":{"new_ascendant":"Leo 15°23'","new_midheaven":"Taurus 08°17'","house_changes":[{"planet":"Sun","original_house":10,"new_house":1,"significance":"Sun moves to 1st house, dramatically increasing personal magnetism and leadership presence"},{"planet":"Venus","original_house":7,"new_house":10,"significance":"Venus elevates to 10th house, bringing beauty, harmony, and artistic recognition to career"},{"planet":"Jupiter","original_house":2,"new_house":7,"significance":"Jupiter moves to partnership sector, expanding opportunities through relationships and collaborations"}],"angular_planets":["Sun","Venus","Mars"],"emphasis_changes":{"increased_emphasis":["Personal magnetism","Creative leadership","Public recognition","Artistic career"],"decreased_emphasis":["Behind-scenes work","Private achievements","Hidden talents"]}},"life_area_ratings":{"career":9.2,"love":8.7,"creativity":9.5,"health":7.8,"spirituality":6.9,"finance":8.1,"home":7.5,"learning":7.2,"travel":8.9,"communication":7.3,"relationships":8.4,"identity":8.0},"overall_score":8.4,"summary":"Los Angeles is an exceptionally powerful location for your astrological profile, with a remarkable overall compatibility score of 8.4/10. The proximity to your Sun Ascendant line (only 78km away) creates a dynamic energy field that dramatically enhances your natural leadership qualities, personal magnetism, and capacity for public recognition. Your relocated chart shows the Sun moving into the 1st house, making you a natural focal point wherever you go. Venus at the Midheaven (142km away) brings extraordinary potential for creative and artistic career success, making this an ideal location for entertainment industry pursuits. The combination of solar vitality and Venusian creativity creates a perfect storm for artistic leadership and public acclaim. Jupiter's influence on partnerships suggests that your greatest opportunities will come through collaborations and relationships formed in this location.","detailed_analysis":{"planetary_influences":{"Sun_AC":{"planet":"Sun","line_type":"AC","distance_km":78.3,"influence_strength":0.91,"closest_point":{"latitude":34.1,"longitude":-118.3},"meaning":"Solar energy rises on the eastern horizon, enhancing leadership qualities and personal magnetism","keywords":["leadership","vitality","confidence","recognition"]},"Venus_MC":{"planet":"Venus","line_type":"MC","distance_km":142.7,"influence_strength":0.84,"closest_point":{"latitude":34.2,"longitude":-118.1},"meaning":"Venus culminates overhead bringing artistic success and beauty to career endeavors","keywords":["creativity","beauty","harmony","artistic_career"]},"Jupiter_DS":{"planet":"Jupiter","line_type":"DS","distance_km":203.5,"influence_strength":0.72,"closest_point":{"latitude":33.9,"longitude":-118.4},"meaning":"Jupiter influence on partnerships brings expansion opportunities through connections","keywords":["expansion","partnership","opportunity","growth"]},"Mars_IC":{"planet":"Mars","line_type":"IC","distance_km":89.1,"influence_strength":0.78,"closest_point":{"latitude":34.0,"longitude":-118.2},"meaning":"Mars energy at the foundation brings dynamic activity to home and private life","keywords":["action","energy","real_estate","drive"]}},"recommendations":{"career_moves":["Pursue entertainment, media, or creative leadership roles","Consider luxury brand partnerships or beauty industry opportunities","Leverage your enhanced charisma for public speaking or performance","Explore international collaborations and partnerships"],"lifestyle_suggestions":["Embrace your increased visibility and natural magnetism","Invest in personal branding and creative self-expression","Network actively in creative and entertainment circles","Consider real estate investments given Mars-IC energy"],"timing_advice":["Best creative projects launched during Leo season (July-August)","Partnership opportunities peak during Libra season (September-October)","Real estate moves favored during Mars-favorable periods"],"potential_challenges":["Increased competition in creative fields - use Venus diplomacy","Higher public scrutiny - maintain authentic self-expression","Domestic life may become more active and demanding","Balance personal desires with partnership needs"]},"power_zones":[{"zone_name":"Hollywood Creative Triangle","center_coordinates":{"latitude":34.0928,"longitude":-118.3287},"radius_km":25,"combined_strength":9.3,"description":"Intersection of Sun-AC and Venus-MC lines creates the most powerful zone for entertainment industry success","optimal_activities":["Film/TV production","Music creation","Artistic collaboration","Creative leadership"]},{"zone_name":"Beverly Hills Luxury Sector","center_coordinates":{"latitude":34.0736,"longitude":-118.4004},"radius_km":15,"combined_strength":8.7,"description":"Venus-Jupiter confluence creates powerful luxury and high-end creative opportunities","optimal_activities":["Luxury brand work","High-end creative services","Exclusive partnerships","Premium lifestyle businesses"]}]}}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error in location analysis parameters","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INVALID_COORDINATES","message":"Invalid latitude or longitude coordinates","field":"coordinates","value":"latitude: 95.0","severity":"high","suggestions":["Latitude must be between -90 and 90 degrees","Longitude must be between -180 and 180 degrees","Use decimal degrees format (e.g., 40.7128, -74.0060)"]},"timestamp":"2024-01-15T14:30:45Z"}}}},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/location-analysis\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/location-analysis\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/location-analysis\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/location-analysis\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/location-analysis\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/line-meanings":{"get":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Get Line Meanings","description":"📚 **Planetary Line Meanings Reference** - Complete interpretation guide\n\n**Perfect for:**\n- 📖 Learning astrocartography interpretations\n- 🔧 Building user interfaces with tooltips\n- 📱 Educational astrology applications\n- 🎯 Understanding line significance\n\n**What you get:**\n- **Complete meanings** - All planet/line type combinations\n- **Keywords** - Key themes for each line\n- **Strength ratings** - Relative power of different lines\n- **Life areas** - Which areas of life are emphasized\n- **Detailed descriptions** - In-depth explanations\n- **Interpretation guide** - How to read and use the data\n\n**Coverage:**\n- **7 Traditional Planets** - Sun through Saturn\n- **4 Line Types** - AC, MC, DS, IC\n- **28 Total combinations** - Complete reference set\n- **Strength levels** - Very strong, strong, moderate, weak\n- **Orb guidelines** - Distance tolerances for line effects\n\n**Use Cases:**\n- Tooltip content for interactive maps\n- Educational content for astrology apps\n- Reference material for consultations\n- Automated interpretation systems\n\n**Response time:** ~50ms | **Content:** Complete reference database","operationId":"get_line_meanings_api_v3_astrocartography_line_meanings_get","responses":{"200":{"description":"Complete planetary line meanings and interpretation guide","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LineMeaningsResponse"},"example":{"success":true,"line_meanings":{"Sun":{"AC":{"meaning":"Solar energy rises on the eastern horizon, enhancing personal magnetism, leadership qualities, and self-confidence. This line brings vitality, recognition, and the ability to shine in public. Excellent for careers requiring visibility and authority.","keywords":["leadership","vitality","confidence","recognition","authority","self-expression"],"strength":"very_strong","life_areas":["career","creativity","health"],"orb_range_km":150,"color":"#FFD700"},"MC":{"meaning":"The Sun culminates at the highest point in the sky, bringing maximum recognition, career success, and public honor. This is one of the most powerful lines for professional achievement and social status.","keywords":["career","recognition","honor","success","reputation","achievement"],"strength":"very_strong","life_areas":["career","home","spirituality"],"orb_range_km":200,"color":"#FFD700"},"DS":{"meaning":"Solar energy sets in the west, emphasizing partnerships, relationships, and collaborative ventures. This line brings leadership through others and success in joint endeavors.","keywords":["partnership","collaboration","relationships","teamwork","cooperation","balance"],"strength":"strong","life_areas":["love","career","travel"],"orb_range_km":150,"color":"#FFA500"},"IC":{"meaning":"The Sun at the lowest point brings focus to home, family roots, and private foundations. This line enhances domestic life, real estate matters, and connection to ancestry.","keywords":["home","family","roots","foundation","property","ancestry"],"strength":"strong","life_areas":["home","finance","spirituality"],"orb_range_km":150,"color":"#FF8C00"}},"Moon":{"AC":{"meaning":"Lunar energy rises, enhancing emotional sensitivity, intuition, and psychic receptivity. This line strengthens connection to the public, women, and nurturing activities. Excellent for hospitality, healthcare, and caring professions.","keywords":["emotion","intuition","nurturing","public","sensitivity","caring"],"strength":"strong","life_areas":["health","home","spirituality"],"orb_range_km":120,"color":"#C0C0C0"},"MC":{"meaning":"The Moon at the Midheaven brings public recognition through nurturing, caring, or domestic matters. Career success in fields involving women, children, food, housing, or emotional healing.","keywords":["nurturing","public","caring","domestic","healing","service"],"strength":"strong","life_areas":["career","health","home"],"orb_range_km":150,"color":"#C0C0C0"},"DS":{"meaning":"Emotional focus on partnerships and close relationships. This line enhances empathy in one-on-one connections and success in counseling or therapeutic relationships.","keywords":["empathy","partnership","counseling","emotional connection","therapeutic","understanding"],"strength":"moderate","life_areas":["love","health","spirituality"],"orb_range_km":120,"color":"#A9A9A9"},"IC":{"meaning":"Deep emotional connection to home and roots. This line strengthens family bonds, creates a nurturing domestic environment, and enhances connection to ancestral wisdom.","keywords":["family","roots","nurturing","domestic","ancestral","emotional foundation"],"strength":"strong","life_areas":["home","spirituality","health"],"orb_range_km":120,"color":"#C0C0C0"}},"Venus":{"AC":{"meaning":"Venusian energy rises, enhancing personal charm, attractiveness, and artistic abilities. This line brings beauty, harmony, and success in creative or luxury fields.","keywords":["beauty","charm","art","harmony","luxury","attractiveness"],"strength":"strong","life_areas":["love","creativity","finance"],"orb_range_km":100,"color":"#00FF7F"},"MC":{"meaning":"Venus culminates at the career point, bringing success in beauty, arts, luxury goods, or relationship-focused professions. Public recognition for aesthetic talents.","keywords":["artistic success","beauty industry","luxury","harmony","aesthetic","creative career"],"strength":"very_strong","life_areas":["creativity","career","finance"],"orb_range_km":150,"color":"#00FF7F"},"DS":{"meaning":"Focus on beautiful, harmonious partnerships and collaborative artistic ventures. This line attracts loving relationships and creative partnerships.","keywords":["harmonious partnership","creative collaboration","loving relationships","artistic cooperation","beauty","balance"],"strength":"strong","life_areas":["love","creativity","travel"],"orb_range_km":100,"color":"#32CD32"},"IC":{"meaning":"Beautiful, harmonious home environment with focus on aesthetics, comfort, and luxury. This line enhances domestic beauty and may indicate profitable real estate.","keywords":["beautiful home","luxury","comfort","aesthetics","domestic harmony","valuable property"],"strength":"moderate","life_areas":["home","finance","creativity"],"orb_range_km":100,"color":"#32CD32"}},"Jupiter":{"AC":{"meaning":"Expansive energy rises, bringing optimism, wisdom, and opportunities for growth. This line enhances teaching ability, international connections, and philosophical pursuits.","keywords":["expansion","wisdom","teaching","international","philosophy","opportunity"],"strength":"very_strong","life_areas":["learning","travel","spirituality"],"orb_range_km":200,"color":"#1E90FF"},"MC":{"meaning":"Jupiter at the Midheaven brings the most expansive career opportunities, wisdom-based success, and recognition for teaching or philosophical work. Excellent for higher education, law, or international business.","keywords":["career expansion","wisdom recognition","teaching success","international business","higher education","legal success"],"strength":"very_strong","life_areas":["career","learning","finance"],"orb_range_km":250,"color":"#1E90FF"},"DS":{"meaning":"Expansive partnerships and international relationships. This line brings growth through others, beneficial business partnerships, and cross-cultural connections.","keywords":["international partnership","beneficial relationships","cultural exchange","business expansion","wisdom sharing","mutual growth"],"strength":"strong","life_areas":["love","travel","career"],"orb_range_km":200,"color":"#4169E1"},"IC":{"meaning":"Expansive home environment with emphasis on learning, culture, and possibly multiple residences. This line can bring prosperity through real estate or family wisdom.","keywords":["expansive home","cultural richness","family wisdom","multiple properties","educational environment","prosperous foundation"],"strength":"strong","life_areas":["home","finance","learning"],"orb_range_km":200,"color":"#4169E1"}},"Mars":{"AC":{"meaning":"Dynamic martial energy rises, enhancing courage, assertiveness, and competitive drive. This line brings leadership through action and success in physical or competitive fields.","keywords":["courage","action","competition","leadership","assertiveness","energy"],"strength":"strong","life_areas":["career","health","travel"],"orb_range_km":120,"color":"#FF4500"},"MC":{"meaning":"Mars at the career point brings success through action, competition, and leadership. Excellent for military, sports, engineering, or any field requiring decisive action.","keywords":["active career","competitive success","military leadership","engineering","decisive action","bold leadership"],"strength":"very_strong","life_areas":["career","health","finance"],"orb_range_km":150,"color":"#FF4500"},"DS":{"meaning":"Dynamic energy in partnerships, potentially bringing both passion and conflict. This line can create competitive or challenging relationships that stimulate growth.","keywords":["passionate partnership","competitive relationships","dynamic interaction","challenging growth","active cooperation","energetic collaboration"],"strength":"strong","life_areas":["love","career","health"],"orb_range_km":120,"color":"#DC143C"},"IC":{"meaning":"Active, energetic home environment with potential for renovation, construction, or conflict. This line can bring real estate opportunities but may also increase domestic activity.","keywords":["active home","renovation","construction","real estate opportunity","domestic energy","family dynamics"],"strength":"moderate","life_areas":["home","finance","health"],"orb_range_km":120,"color":"#DC143C"}},"Saturn":{"AC":{"meaning":"Disciplined saturnian energy rises, bringing structure, responsibility, and long-term achievement. This line develops maturity and creates lasting success through persistence.","keywords":["discipline","responsibility","structure","maturity","persistence","long-term success"],"strength":"strong","life_areas":["career","learning","finance"],"orb_range_km":150,"color":"#8B4513"},"MC":{"meaning":"Saturn at the Midheaven creates the most structured and enduring career success. Achievement comes through discipline, authority, and long-term commitment. Excellent for traditional professions.","keywords":["structured career","authority","traditional success","long-term achievement","professional discipline","enduring reputation"],"strength":"very_strong","life_areas":["career","finance","learning"],"orb_range_km":200,"color":"#8B4513"},"DS":{"meaning":"Serious, committed partnerships with emphasis on loyalty and responsibility. This line can create age differences or traditional relationship structures.","keywords":["serious partnership","commitment","loyalty","responsibility","traditional relationship","mature cooperation"],"strength":"moderate","life_areas":["love","career","home"],"orb_range_km":150,"color":"#A0522D"},"IC":{"meaning":"Structured, disciplined home environment with emphasis on tradition and security. This line creates solid foundations but may feel restrictive or demanding.","keywords":["structured home","tradition","security","solid foundation","family responsibility","conservative environment"],"strength":"strong","life_areas":["home","finance","spirituality"],"orb_range_km":150,"color":"#A0522D"}}},"line_types":{"AC":"Ascendant - Where the planet rises on the eastern horizon. Affects personal identity, appearance, and how you present yourself to the world.","MC":"Midheaven - Where the planet culminates at the highest point. Influences career, reputation, public recognition, and life direction.","DS":"Descendant - Where the planet sets on the western horizon. Governs partnerships, relationships, and how you interact with others.","IC":"Imum Coeli - Where the planet reaches its lowest point. Rules home, family, roots, and private foundation."},"interpretation_guide":{"strength_levels":{"very_strong":"Lines within 100km have maximum effect. Life themes are prominently activated.","strong":"Lines within 100-200km have significant effect. Notable influence on life areas.","moderate":"Lines within 200-300km have moderate effect. Subtle but meaningful influence.","weak":"Lines beyond 300km have minimal effect. Background influence only."},"orb_guidelines":{"tight_orb":"0-50km: Maximum intensity, immediate effects","close_orb":"50-100km: Strong effects, clearly noticeable","moderate_orb":"100-200km: Significant effects, important influence","wide_orb":"200-300km: Subtle effects, background themes","very_wide_orb":"300km+: Minimal effects, distant influence"},"combination_effects":{"multiple_lines":"When multiple lines are nearby, effects blend and amplify. Look for synergistic themes.","conflicting_energies":"Opposing planetary energies (e.g., Saturn-Jupiter) create dynamic tension and growth opportunities.","harmonic_combinations":"Compatible planets (e.g., Sun-Jupiter, Venus-Moon) create flowing, beneficial energy.","power_zones":"Line intersections within 50km create powerful energy vortexes with combined planetary themes."},"practical_application":{"relocation_timing":"Consider current planetary transits when moving to a new astrocartography line.","career_planning":"MC lines are most powerful for career advancement and professional recognition.","relationship_focus":"DS lines are optimal for finding partners and improving existing relationships.","personal_development":"AC lines enhance personal growth and self-expression abilities.","home_establishment":"IC lines are ideal for creating a strong foundation and establishing roots."}}}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error in line meanings request","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INVALID_REQUEST","message":"Invalid parameters for line meanings","field":"request","value":"malformed","severity":"low","suggestions":["This endpoint requires no parameters","Simply call GET /api/v3/astrocartography/line-meanings"]},"timestamp":"2024-01-15T14:30:45Z"}}}},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/astrocartography/line-meanings\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/line-meanings\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/line-meanings\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/line-meanings\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/line-meanings\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/supported-features":{"get":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Get Supported Features","description":"🔍 **Supported Astrocartography Features** - Available functionality overview\n\n**Perfect for:**\n- 🔧 API integration planning\n- 📱 Feature discovery for applications\n- 🎯 Understanding system capabilities\n- 📊 Version compatibility checking\n\n**What you get:**\n- **Line types** - Available astrocartography line calculations\n- **Planets** - All supported celestial bodies\n- **Map projections** - Geographic projection options\n- **Themes** - Visual styling options\n- **Export formats** - Available output formats\n- **Limitations** - System constraints and maximums\n- **Version info** - API version and capabilities\n\n**Current Features:**\n- Standard astrocartography lines (AC, MC, DS, IC)\n- 13+ celestial bodies including planets and points\n- Multiple map projections and visual themes\n- High-precision coordinate calculations\n- Interactive data for frontend integration\n\n**Future Features:**\n- Paran lines (simultaneous rising/setting)\n- Local space astrocartography\n- Geodetic equivalent projections\n- Additional export formats (PNG, PDF)\n\n**Response time:** ~25ms | **Content:** Complete feature matrix","operationId":"get_supported_features_api_v3_astrocartography_supported_features_get","responses":{"200":{"description":"Complete overview of supported astrocartography features and capabilities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportedFeaturesResponse"},"example":{"success":true,"features":{"line_types":["AC","MC","DS","IC"],"planets":["Sun","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Mean_Node","True_Node","Chiron","Mean_Lilith","True_Lilith"],"map_projections":["mercator","robinson","mollweide","equirectangular","natural_earth","winkel_tripel"],"themes":["modern","classic","dark","light","minimal","detailed","high_contrast","earth_tones"],"export_formats":["svg","json","coordinates"],"analysis_types":["location_analysis","line_meanings","power_zones","city_search","life_area_ratings"],"coordinate_systems":["WGS84","geographic"],"ephemeris_engines":["Swiss Ephemeris"],"house_systems":["P","W","K","A","R","C","O","X","T","M"],"calculation_methods":["topocentric","geocentric","atmospheric_refraction","precession_correction","nutation_correction"],"interactive_features":["clickable_regions","hover_zones","city_markers","line_segments","power_zone_highlighting","tooltip_data","detailed_popups"],"life_areas":["career","love","creativity","health","spirituality","finance","home","learning","travel","communication","relationships","identity"],"city_databases":["world_cities","geonames","natural_earth"],"advanced_features":["power_zone_detection","line_intersection_analysis","orb_calculations","strength_assessments","multi_line_synthesis","relocated_chart_comparison"]},"limitations":{"max_cities_search":5000,"max_comparison_locations":10,"coordinate_precision":6,"svg_max_size":"2400x1200","max_coordinate_density":500,"max_planets_per_request":15,"max_orb_distance_km":500,"min_city_population":1000,"max_power_zones_per_map":50,"calculation_timeout_seconds":30,"max_line_segments_per_line":1000,"supported_date_range":"1800-2200 CE","coordinate_accuracy_meters":100,"elevation_data_resolution_km":1,"time_zone_accuracy":"IANA standard"},"version_info":{"api_version":"3.1.0","astrocartography_version":"1.2.0","ephemeris":"Swiss Ephemeris 2.10.03","coordinate_system":"WGS84","last_updated":"2024-01-15","feature_level":"professional","calculation_engine":"Kerykeion 4.10.1","map_rendering":"Custom SVG Engine v2.1","city_database_version":"GeoNames 2024.01","supported_languages":["en","fr","pt","it","zh","es","ru","tr","de","hi","uk","ar","en-US","en-GB","en-ARCHAIC","pt-BR","pt-PT","es-MX","es-ES","fr-FR","fr-CA","zh-CN","zh-TW"],"precision_level":"arc_second","quality_assurance":"Swiss Ephemeris verified","performance_optimizations":["coordinate_caching","line_simplification","intelligent_city_selection","adaptive_precision","power_zone_clustering"],"compatibility":{"browsers":["Chrome 90+","Firefox 88+","Safari 14+","Edge 90+"],"mobile_support":true,"svg_features":["interactive_elements","responsive_design","scalable_graphics"],"data_formats":["JSON","GeoJSON","CSV coordinates"]},"upcoming_features":["Paran astrocartography (Phase 4)","Local space astrocartography (Phase 4)","Geodetic equivalent projections (Phase 5)","PNG/PDF export formats (Phase 5)","Real-time transit overlays (Phase 6)","Historical date comparisons (Phase 6)","3D globe visualization (Future)","AR/VR astrocartography (Future)"]}}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error in supported features request","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INVALID_REQUEST","message":"Invalid parameters for supported features","field":"request","value":"malformed","severity":"low","suggestions":["This endpoint requires no parameters","Simply call GET /api/v3/astrocartography/supported-features"]},"timestamp":"2024-01-15T14:30:45Z"}}}},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X GET \"https://api.astrology-api.io/api/v3/astrocartography/supported-features\" \\\n -H \"Accept: application/json\" \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/supported-features\";\n\ntry {\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Accept': 'application/json'\n }\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/supported-features\";\n\naxios.get(url)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/supported-features\"\n\n# Make the GET request\nresponse = requests.get(url)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/supported-features\"\n \n resp, err := http.Get(url)\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/search-locations":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Search Optimal Locations","description":"🔍 **Search Optimal Locations** - Find best cities based on astrological criteria\n\n**Perfect for:**\n- 🎯 Finding the best cities for career growth\n- 💕 Discovering romantic destinations\n- 🎨 Locating creative inspiration hubs\n- 💰 Identifying financial opportunity zones\n- 🧘 Finding spiritual growth centers\n- 🏥 Locating health and wellness havens\n\n**Search criteria:**\n- **Life area focus** - career, love, creativity, health, spirituality, finance, home, learning, or overall\n- **Minimum population** - filter by city size (default: 750,000)\n- **Maximum results** - number of cities to return (1-50, default: 5)\n\n**What you get:**\n- **Ranked cities** with real astrological compatibility scores\n- **Life area ratings** specific to your search criteria\n- **Key planetary influences** affecting each location\n- **Practical information** - population, coordinates, country\n- **Personalized summary** for each recommended city\n\n**Analysis method:** Real astrocartography calculations with Swiss Ephemeris\n**Response time:** ~3-8s | **Cities analyzed:** 30+ major world cities","operationId":"search_optimal_locations_api_v3_astrocartography_search_locations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchLocationsRequest"},"examples":{"career_search":{"summary":"Find career hotspots","description":"Search for best cities for professional growth","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"search_criteria":{"life_area":"career","min_score":6.0},"location_filters":{"min_population":500000},"result_options":{"limit":5}}},"love_destinations":{"summary":"Find romantic cities","description":"Search for best cities for love and relationships","value":{"subject":{"name":"Emma","birth_data":{"year":1992,"month":8,"day":22,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"search_criteria":{"life_area":"love"},"result_options":{"limit":10}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchLocationsResponse"}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/search-locations\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/search-locations\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/search-locations\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/search-locations\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/search-locations\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/compare-locations":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Compare Locations","description":"⚖️ **Compare Multiple Locations** - Side-by-side comprehensive location analysis\n\n**Perfect for:**\n- 🏙️ Choosing between 2-10 relocation destinations\n- 📊 Data-driven relocation decisions with detailed comparisons\n- 🎯 Understanding strengths/weaknesses of each location\n- 🌍 Finding best locations for specific life areas (career, love, etc.)\n\n**What you get:**\n- **Comparison Matrix** - Side-by-side scores for all life areas x locations\n- **Overall Rankings** - Best to worst locations ranked by total astrological support\n- **Area-Specific Rankings** - Best location for each life area (career, love, health, etc.)\n- **Recommendations** - Best overall, most balanced, specialized choices\n- **Detailed Analysis** - Full planetary influences and life area ratings for each location\n- **Smart Summary** - Human-readable summary of key findings\n\n**Algorithm (based on astrology advisor):**\n1. **Line Proximity Score (35%)** - Distance to planetary lines using exponential decay: influence = e^(-distance_km / 350)\n2. **Angular Planets Score (30%)** - How angular each planet is at the relocated location\n3. **Power Zone Score (20%)** - Nearby line intersections (planetary energy combinations)\n4. **Benefic Balance Score (15%)** - Balance of benefic vs malefic planetary influences\n\n**Life Area Scoring:**\n- Uses standardized life areas from app/data/life_areas.py\n- Each area has primary_planets, secondary_planets, and preferred_lines\n- Scores normalized to 0-100 scale with ratings: excellent (75+), very_good (60+), good (45+), moderate (30+), weak (15+), minimal (<15)\n\n**Comparison options:**\n- Compare 2-10 locations (minimum 2, maximum 10)\n- Focus on specific life areas or compare all 13 areas\n- Get detailed breakdown of planetary influences\n- Rankings both overall and per life area\n\n**Response includes:**\n- locations: Full analysis for each location\n- comparison_matrix: Life areas x locations with scores and ranks\n- rankings: Overall rankings and per-area rankings\n- best_overall: Highest scoring location\n- recommendations: Best for each area, balanced choice, specialized options\n- summary: Human-readable comparison summary\n\n**Response time:** ~2-5 seconds for 2 cities, ~5-15 seconds for 5-10 cities | **Accuracy:** Professional grade Swiss Ephemeris","operationId":"compare_locations_api_v3_astrocartography_compare_locations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareLocationsRequest"},"examples":{"two_cities":{"summary":"Compare two cities for relocation","description":"Compare London and New York to see which location offers better astrological support across different life areas","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"locations":[{"city":"London","country_code":"GB"},{"city":"New York","country_code":"US"}]}},"multiple_cities_career_focus":{"summary":"Compare 5 cities with career focus","description":"Comprehensive comparison of 5 major cities focusing on career, finance, and professional life areas","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"locations":[{"city":"London","country_code":"GB"},{"city":"New York","country_code":"US"},{"city":"Tokyo","country_code":"JP"},{"city":"Dubai","country_code":"AE"},{"city":"Singapore","country_code":"SG"}],"comparison_criteria":{"life_areas":["career","finance","power","communication"],"include_detailed_breakdown":true}}},"love_and_relationships":{"summary":"Compare cities for love and relationships","description":"Find the best location for romantic relationships and social connections","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"locations":[{"city":"Paris","country_code":"FR"},{"city":"Rome","country_code":"IT"},{"city":"Barcelona","country_code":"ES"},{"city":"Vienna","country_code":"AT"}],"comparison_criteria":{"life_areas":["love","relationships","creativity","home"],"include_detailed_breakdown":true}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareLocationsResponse"}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/compare-locations\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/compare-locations\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/compare-locations\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/compare-locations\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/compare-locations\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/relocation-chart":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Get Relocation Chart","description":"🏠 **Relocated Natal Chart** - Shows how your birth chart changes in a new location\n\n**Perfect for:**\n- 🌍 Planning international moves or relocations\n- 🏡 Choosing the best city for career, relationships, or personal growth\n- ✈️ Understanding how travel destinations affect your energy\n- 🎯 Astrocartography validation (checking angular planets at specific locations)\n- 📚 Educational purposes - learning relocation astrology principles\n\n**What you get:**\n- **Location comparison** - Birth location vs. relocated location details\n- **Angle shifts** - How Ascendant and Midheaven change (degrees of shift)\n- **House cusps** - All 12 house cusps for both natal and relocated charts\n- **Planetary positions** - Which planets changed houses, which stayed the same\n- **Angular planets** - Planets within 10 degrees of Ascendant, MC, Descendant, IC in relocated chart\n- **House changes** - Complete list of planets that moved to different houses\n- **Key factors** - Interpretation highlights for the most significant changes\n\n**Key concept:**\nRelocation charts use the SAME birth moment (UTC) but DIFFERENT geographic coordinates.\nPlanetary positions remain identical - only the angles (ASC/MC/DS/IC) and house cusps change.\nThis shows how location affects the *expression* of your natal energies, not the energies themselves.\n\n**Interpretation guide:**\n- **Angular planets** (near ASC/MC/DS/IC) become more prominent and powerful\n- **House changes** shift the life area focus of planetary energies\n- **Ascendant shift > 10 degrees** = noticeable change in self-expression and identity\n- **Midheaven shift > 10 degrees** = significant impact on career and public life\n\n**Response time:** ~200-500ms | **Accuracy:** Professional grade Swiss Ephemeris","operationId":"get_relocation_chart_api_v3_astrocartography_relocation_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelocationChartRequest"},"examples":{"relocate_to_london":{"summary":"Relocate Oleg from Kharkiv to London","description":"Shows how Oleg's natal chart changes when relocated to London. Planetary positions stay the same (same birth moment in UTC), but house cusps and angles shift based on the new geographic coordinates.","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"options":{"target_location":{"city":"London","country_code":"GB"}}}},"relocate_to_new_york":{"summary":"Relocate from London to New York","description":"Demonstrates significant house and angular shifts when moving across the Atlantic. Different time zone and latitude create major changes in house placements and angular planets.","value":{"subject":{"name":"Sarah","birth_data":{"year":1990,"month":8,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"options":{"target_location":{"city":"New York","country_code":"US"},"show_changes":true,"highlight_angular_changes":true}}},"relocate_with_coordinates":{"summary":"Relocate using precise coordinates","description":"Use exact latitude/longitude coordinates for precise relocation calculations instead of city names.","value":{"subject":{"name":"Michael","birth_data":{"year":1988,"month":3,"day":21,"hour":10,"minute":45,"latitude":40.7128,"longitude":-74.006}},"options":{"target_location":{"latitude":34.0522,"longitude":-118.2437,"city":"Los Angeles","country_code":"US"}}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelocationChartResponse"}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/relocation-chart\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/relocation-chart\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/relocation-chart\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/relocation-chart\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/relocation-chart\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/power-zones":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Find Power Zones","description":"⚡ **Find Power Zones** - Discover concentrated astrological influence locations\n\n**Perfect for:**\n- 🎯 Finding locations with combined planetary energies\n- 💼 Career success zones (Sun-Jupiter, Sun-Mars intersections)\n- ❤️ Love and harmony zones (Venus-Jupiter, Moon-Venus intersections)\n- 💰 Wealth and prosperity zones (Jupiter-Pluto, Venus-Jupiter intersections)\n- 🌟 Personal growth hotspots\n\n**What are Power Zones?**\nPower zones occur where two or more planetary lines intersect, creating concentrated\nastrological influence. Think of them as energetic \"hotspots\" where multiple planetary\nthemes combine and amplify.\n\n**Scoring Algorithm:**\n- Planet weights: Sun/Moon (1.0), Jupiter (0.9), Venus (0.85), Mars (0.8)\n- Line weights: AC/MC (1.0), DS (0.8), IC (0.75)\n- Tightness factor: Based on intersection precision (100km orb)\n- Synergy bonuses: Benefic combos get 1.2-1.3x multiplier\n\n**Search Options:**\n- **min_strength** (0-1): Minimum strength threshold (default: 0.25)\n- **max_zones** (1-100): Maximum number of zones to return (default: 20)\n- **max_distance_km** (50-500): Search radius for nearby cities (default: 100)\n- **preferred_combinations**: Filter for specific planet pairs, e.g. [[\"Sun\", \"Jupiter\"]]\n- **exclude_challenging**: Skip Mars-Saturn, Mars-Pluto combinations (default: false)\n- **life_areas**: Filter by category: career, love, finance, spirituality, etc.\n\n**Life Area Categories:**\n- career: Sun-Jupiter, Sun-Mars, Sun-Saturn\n- love: Venus-Jupiter, Moon-Venus, Sun-Venus\n- finance: Jupiter-Venus, Saturn-Venus, Jupiter-Pluto\n- communication: Mercury-Jupiter, Sun-Mercury\n- spirituality: Jupiter-Neptune, Moon-Neptune\n- transformation: Mars-Pluto, Sun-Pluto\n- creativity: Venus-Neptune, Sun-Venus\n\n**Response time:** ~800ms | **Data:** Intersections, strengths, nearby cities","operationId":"find_power_zones_api_v3_astrocartography_power_zones_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PowerZonesRequest"},"examples":{"benefic_zones":{"summary":"Find benefic power zones worldwide","description":"Search for fortune zones created by Sun-Jupiter and Venus-Jupiter intersections","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"search_options":{"min_strength":0.5,"max_zones":10,"preferred_combinations":[["Sun","Jupiter"],["Venus","Jupiter"]],"exclude_challenging":true}}},"career_zones":{"summary":"Find career success power zones","description":"Focus on Sun-Jupiter, Sun-Mars, and Sun-Saturn combinations","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"search_options":{"min_strength":0.4,"max_zones":15,"life_areas":["career"],"preferred_combinations":[["Sun","Jupiter"],["Sun","Mars"],["Sun","Saturn"]]}}},"all_zones":{"summary":"Find all strong power zones","description":"Get all planetary line intersections above minimum strength threshold","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"search_options":{"min_strength":0.6,"max_zones":20,"max_distance_km":150}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PowerZonesResponse"}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/power-zones\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/power-zones\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/power-zones\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/power-zones\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/power-zones\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/paran-map":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Generate Paran Map","description":"🌟 **Paran Astrocartography** - Latitude bands where planets are simultaneously angular\n\n**Perfect for:**\n- 🎯 Finding locations with multiple planetary influences\n- 📚 Advanced astrocartography analysis\n- 🗺️ Exploring horizontal (latitude) patterns vs standard vertical lines\n\n**What you get:**\n- **Paran Lines** - Latitude bands where specified planets are simultaneously on angles (MC/IC)\n- **Planet Pairs** - Primary planet combined with secondary planets\n- **Strength Ratings** - Based on planetary nature, angles involved, and orb tightness\n- **Interpretations** - Meaning of each paran combination\n- **Top 5 Strongest** - Most powerful parans for quick reference\n\n**How parans work:**\n- Standard astrocartography = vertical longitude lines (one planet on one angle)\n- Parans = horizontal latitude bands (two planets on angles simultaneously)\n- When Planet1 is on MC/IC AND Planet2 is on MC/IC at the same moment\n\n**Options:**\n- `primary_planet` - Main planet (default: Sun)\n- `secondary_planets` - List of planets to pair with primary (default: Venus, Jupiter, Mars)\n- `paran_types` - Filter by angle combinations: MC/MC, MC/IC, IC/MC, IC/IC\n\n**Response time:** ~200ms | **Accuracy:** Swiss Ephemeris precision","operationId":"generate_paran_map_api_v3_astrocartography_paran_map_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParanMapRequest"},"examples":{"sun_venus_jupiter":{"summary":"Sun with Venus and Jupiter parans","description":"Calculate parans where Sun is on MC/IC and Venus or Jupiter are simultaneously angular. Perfect for finding locations with love, success, and creativity potential.","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"paran_options":{"primary_planet":"Sun","secondary_planets":["Venus","Jupiter"],"paran_types":["MC/MC","MC/IC"]}}},"moon_jupiter":{"summary":"Moon-Jupiter parans","description":"Emotional abundance and good fortune parans. All MC/IC combinations for maximum insight.","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":7,"day":20,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"paran_options":{"primary_planet":"Moon","secondary_planets":["Jupiter","Venus"]}}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParanMapResponse"}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/paran-map\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/paran-map\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/paran-map\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/paran-map\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/paran-map\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/astrodynes":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Calculate Astrodynes","description":"📊 **Astrodynes Calculation** - Church of Light quantitative astrology\n\n**Perfect for:**\n- 📈 Quantifying planetary power and harmony in a chart\n- 🗺️ Comparing natal vs relocated chart strength\n- 🔬 Objective astrological analysis using the Church of Light system\n- 📚 Research and statistical astrology\n\n**What you get:**\n- **Planet Astrodynes** - Power and harmony for each planet\n- **Sign Totals** - Power distribution across zodiac signs\n- **House Totals** - Power distribution across houses\n- **Aspect Analysis** - Power and harmony of each aspect\n- **Element Balance** - Fire, Earth, Air, Water distribution\n- **Quality Balance** - Cardinal, Fixed, Mutable distribution\n- **Trinity Balance** - Life, Wealth, Association, Psychism (Church of Light house groupings)\n- **Comparison** - Natal vs relocated differences (when relocation provided)\n\n**Astrodynes methodology:**\n- Based on Elbert Benjamine (C.C. Zain) and W.M.A. Drake's system\n- Power = House position + Aspect contributions\n- Harmony = Aspect nature + Planet modifiers (Jupiter/Venus add harmony, Saturn/Mars add discord)\n- Essential dignities add/subtract harmony\n\n**Response time:** ~300ms | **System:** Church of Light (1950)","operationId":"calculate_astrodynes_api_v3_astrocartography_astrodynes_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrodynesRequest"},"examples":{"natal_only":{"summary":"Natal chart astrodynes","description":"Calculate astrodynes power and harmony for natal chart only","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}}}},"with_relocation":{"summary":"Natal vs relocated comparison","description":"Calculate astrodynes for both natal and relocated chart, with comparison","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"relocation":{"city":"New York","country_code":"US"}}},"with_minor_aspects":{"summary":"Include minor aspects","description":"Extended aspect set including semi-sextile, quincunx, etc.","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":7,"day":20,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"options":{"aspects":["conjunction","sextile","square","trine","opposition","semi_sextile","semi_square","sesquiquadrate","quincunx"],"include_dignities":true}}}}}},"required":true},"responses":{"200":{"description":"Successful Astrodynes calculation with power and harmony values","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrodynesResponse"},"examples":{"natal_response":{"summary":"Natal chart astrodynes","description":"Complete power and harmony analysis for natal chart","value":{"success":true,"natal":{"planets":[{"name":"Mars","power":13.6,"harmony":2.5,"house_power":13.6,"aspect_power":0.0,"sign":"Gem","house":7},{"name":"Venus","power":11.92,"harmony":4.2,"house_power":11.92,"aspect_power":0.0,"sign":"Ari","house":4},{"name":"Sun","power":8.99,"harmony":0.0,"house_power":8.99,"aspect_power":0.0,"sign":"Tau","house":6}],"elements":{"Fire":{"power":31.77,"harmony":5.2,"percentage":32.04},"Earth":{"power":17.6,"harmony":-1.5,"percentage":17.75},"Air":{"power":30.84,"harmony":3.1,"percentage":31.1},"Water":{"power":18.94,"harmony":-2.0,"percentage":19.1}},"trinities":{"Life":{"power":20.8,"harmony":2.5,"percentage":20.98},"Wealth":{"power":16.26,"harmony":-0.5,"percentage":16.4},"Association":{"power":34.77,"harmony":4.0,"percentage":35.07},"Psychism":{"power":27.32,"harmony":-1.2,"percentage":27.55}},"house_types":{"angular":{"power":53.98,"percentage":54.44},"succedent":{"power":18.47,"percentage":18.63},"cadent":{"power":26.7,"percentage":26.93}},"totals":{"power":99.14,"harmony":4.8}},"location_info":{"natal":{"city":"Kharkiv","country_code":"UA","latitude":49.98,"longitude":36.25}},"metadata":{"calculation_time_ms":160.32,"house_system":"P","method":"Church of Light (Benjamine/Drake)"}}}}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error in astrodynes parameters","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INVALID_BIRTH_DATA","message":"Invalid birth data provided","field":"birth_data.city","suggestions":["Provide a valid city name","Use latitude/longitude instead"]}}}}},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/astrocartography/astrodynes/compare":{"post":{"tags":["🗺️ Astrocartography & Relocation"],"summary":"Compare Astrodynes Locations","description":"🌍 **Astrodynes Location Comparison** - Compare multiple cities quantitatively\n\n**Perfect for:**\n- 🗺️ Finding the best location for relocation\n- 📊 Objective comparison of multiple cities\n- 🏆 Ranking locations by power and harmony\n- 🔬 Data-driven relocation decisions\n\n**What you get:**\n- **Natal Reference** - Your natal chart astrodynes as baseline\n- **Location Summaries** - Total power/harmony for each location\n- **Planet Highlights** - Strongest, most harmonious, most discordant planets per location\n- **Element/Trinity Dominants** - Which elements and life areas are emphasized\n- **Rankings** - Locations ranked by total harmony, power, and specific factors\n- **Recommendations** - Best locations for different priorities\n\n**How it works:**\n1. Calculates natal chart astrodynes (reference)\n2. Calculates relocated chart for each location\n3. Compares power and harmony changes\n4. Ranks locations by various criteria\n\n**Response time:** ~500ms for 3 locations | **System:** Church of Light","operationId":"compare_astrodynes_locations_api_v3_astrocartography_astrodynes_compare_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrodynesCompareRequest"},"examples":{"three_cities":{"summary":"Compare 3 major cities","description":"Compare astrodynes across New York, London, and Tokyo","value":{"subject":{"name":"Oleg","birth_data":{"year":1985,"month":5,"day":11,"hour":18,"minute":15,"city":"Kharkiv","country_code":"UA"}},"locations":[{"city":"New York","country_code":"US"},{"city":"London","country_code":"GB"},{"city":"Tokyo","country_code":"JP"}]}},"career_focus":{"summary":"Career-focused comparison","description":"Compare locations for career potential using Whole Sign houses","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":7,"day":20,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"locations":[{"city":"San Francisco","country_code":"US"},{"city":"Singapore","country_code":"SG"},{"city":"Dubai","country_code":"AE"},{"city":"Berlin","country_code":"DE"}],"options":{"house_system":"W"}}}}}},"required":true},"responses":{"200":{"description":"Successful multi-location Astrodynes comparison","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrodynesCompareResponse"},"examples":{"comparison_response":{"summary":"Three cities comparison","description":"Astrodynes comparison across New York, London, Tokyo","value":{"success":true,"natal":{"totals":{"power":99.14,"harmony":4.8}},"locations":[{"location":{"city":"Tokyo","country_code":"JP"},"total_power":96.81,"total_harmony":5.2,"strongest_planet":{"name":"Mars","power":14.2},"dominant_element":"Fire","dominant_trinity":"Association"},{"location":{"city":"London","country_code":"GB"},"total_power":95.51,"total_harmony":3.8,"strongest_planet":{"name":"Venus","power":13.5},"dominant_element":"Air","dominant_trinity":"Life"},{"location":{"city":"New York","country_code":"US"},"total_power":88.45,"total_harmony":2.1,"strongest_planet":{"name":"Sun","power":12.8},"dominant_element":"Earth","dominant_trinity":"Wealth"}],"rankings":{"by_harmony":[{"rank":1,"city":"Tokyo","harmony":5.2},{"rank":2,"city":"London","harmony":3.8},{"rank":3,"city":"New York","harmony":2.1}],"by_power":[{"rank":1,"city":"Tokyo","power":96.81},{"rank":2,"city":"London","power":95.51},{"rank":3,"city":"New York","power":88.45}]},"recommendations":{"best_for_harmony":{"city":"Tokyo","reason":"Highest overall harmony"},"best_for_power":{"city":"Tokyo","reason":"Most intense planetary influences"}},"metadata":{"calculation_time_ms":4.03,"locations_compared":3,"method":"Church of Light (Benjamine/Drake)"}}}}}}},"400":{"description":"Invalid astrocartography parameters"},"422":{"description":"Validation error","content":{"application/json":{"example":{"success":false,"error":{"error_code":"INSUFFICIENT_LOCATIONS","message":"At least 2 locations required for comparison"}}}}},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes/compare\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes/compare\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes/compare\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes/compare\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/astrocartography/astrodynes/compare\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horoscope/sign/daily":{"post":{"tags":["🌟 Horoscopes & Predictions"],"summary":"Get Daily Sun Sign Horoscope","description":"🌟 **Daily Sun-Sign Horoscope** - Fast, cached daily predictions\n\n**Perfect for:**\n- 📱 Mobile apps requiring quick daily horoscope updates\n- 🌐 Websites with generic daily astrology content\n- 📊 High-volume applications needing cached responses\n- 🎯 Users wanting simple sun-sign based guidance\n\n**Key Features:**\n- ⚡ **Ultra-fast response** - Cached and pre-calculated\n- 🌍 **Multi-language** - 10+ languages supported\n- 📈 **Life areas analysis** - 6 key life categories rated 1-5 stars\n- 🔮 **Lucky elements** - Colors, numbers, stones, directions, times\n- 🌙 **Lunar insights** - Moon phase and sign influences\n- 💡 **Practical tips** - 3 actionable daily suggestions\n\n**Response includes:**\n- Overall daily theme and 1-5 star rating\n- Detailed predictions for: Identity, Health, Career, Love, Relationships, Finance\n- Key planetary influences affecting the day\n- Lucky elements (colors, numbers, stones, directions, times)\n- Moon phase and sign information\n- Practical daily tips and advice\n\n**Use Cases:**\n- **Daily app notifications** - \"Your Aries horoscope for today...\"\n- **Website daily content** - Cached for all 12 signs\n- **Social media automation** - Batch generate for posting\n- **Newsletter content** - Include in daily/weekly digests\n\n**Performance:**\n- Response time: <100ms (cached)\n- Cache duration: 24 hours\n- Supports all 12 zodiac signs\n- Updates daily at midnight UTC\n\n**Languages:** English, French, Portuguese, Italian, Chinese, Spanish, Russian, Turkish, German, Hindi\n**Traditions:** Universal, Psychological, Event-oriented, Classical","operationId":"get_daily_sun_sign_horoscope_api_v3_horoscope_sign_daily_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SunSignDailyRequest"},"examples":{"aries_today":{"summary":"Aries Daily Horoscope - Today","description":"Get today's horoscope for Aries with life area predictions","value":{"sign":"Aries","date":"2024-01-15","language":"en","tradition":"universal"}},"leo_specific_date":{"summary":"Leo Daily Horoscope - Specific Date","description":"Get horoscope for Leo on a specific date","value":{"sign":"Leo","date":"2024-03-21","language":"en","tradition":"psychological"}}}}},"required":true},"responses":{"200":{"description":"Daily horoscope with life area predictions and astrological insights","content":{"application/json":{"schema":{},"examples":{"leo_powerful_day":{"summary":"Leo - High Energy Day","description":"A powerful Leo day with strong planetary support and excellent career prospects","value":{"date":"2024-01-15","sign":"Leo","overall_theme":"Dynamic leadership and creative breakthrough","overall_rating":5,"life_areas":[{"area":"identity","title":"Radiant Self-Expression","prediction":"Your natural charisma is at its peak today. The Sun's favorable position amplifies your confidence and magnetism, making this an ideal time to step into leadership roles or showcase your talents.","rating":5,"keywords":["confidence","leadership","charisma","self-expression"]},{"area":"career","title":"Professional Recognition","prediction":"Mars trine your Sun brings dynamic energy to your career sector. Expect recognition from superiors, successful negotiations, or breakthrough moments in ongoing projects. Your bold approach yields excellent results.","rating":5,"keywords":["recognition","success","breakthrough","advancement"]},{"area":"love","title":"Passionate Connections","prediction":"Venus forms a harmonious aspect with your ruler, enhancing romance and attraction. Single Leos may encounter someone special through creative pursuits. Couples enjoy renewed passion and playful energy.","rating":4,"keywords":["romance","attraction","passion","creativity"]},{"area":"health","title":"Vital Energy Flow","prediction":"Your vitality is strong with excellent heart and circulation energy. Perfect day for vigorous exercise, dance, or activities that make you feel alive and energized. Listen to your body's natural rhythms.","rating":4,"keywords":["vitality","energy","circulation","exercise"]},{"area":"finance","title":"Generous Abundance","prediction":"Jupiter's influence suggests opportunities for increased income through creative ventures. Your generous nature attracts prosperity, but avoid impulsive luxury purchases. Focus on investments that reflect your values.","rating":3,"keywords":["prosperity","generosity","investment","luxury"]},{"area":"relationships","title":"Social Magnetism","prediction":"Your warm, generous spirit draws people toward you. Excellent day for networking, social events, or reconnecting with friends. Your natural ability to inspire others creates lasting bonds.","rating":4,"keywords":["magnetism","networking","inspiration","friendship"]}],"planetary_influences":[{"planet":"Sun","aspect_type":"dignity","description":"The Sun in its own sign Leo radiates pure solar energy, enhancing confidence and leadership abilities","strength":5},{"planet":"Mars","aspect_type":"trine","description":"Mars trine Sun brings dynamic energy and successful action in career matters","strength":4},{"planet":"Venus","aspect_type":"sextile","description":"Venus sextile Sun enhances charm, creativity, and romantic opportunities","strength":3}],"lucky_elements":{"colors":["gold","orange","bright yellow"],"numbers":[1,8,19,28],"stones":["citrine","sunstone","tiger's eye"],"directions":["east","south"],"times":["sunrise","noon","golden hour"]},"moon":{"phase":"Waxing Crescent","sign":"Aries","prediction":"The Waxing Crescent Moon in Aries supports growth and momentum. Your Leo efforts gain traction and begin showing early results.","illumination":25.5},"tips":["Schedule important meetings or presentations during peak solar hours","Wear gold or bright colors to amplify your natural radiance","Take on leadership roles in group projects or social situations"]}},"scorpio_introspective_day":{"summary":"Scorpio - Deep Transformation","description":"A Scorpio day focused on internal transformation and psychological insights with mixed planetary influences","value":{"date":"2024-01-15","sign":"Scorpio","overall_theme":"Psychological depth and transformative insights","overall_rating":3,"life_areas":[{"area":"identity","title":"Inner Transformation","prediction":"Pluto's influence encourages deep self-examination today. You may uncover hidden aspects of your personality or resolve long-standing psychological patterns. Trust your intuitive insights about personal growth.","rating":4,"keywords":["transformation","insight","psychology","growth"]},{"area":"career","title":"Behind-the-Scenes Progress","prediction":"Saturn's aspect suggests slow but steady progress in professional matters. Focus on research, investigation, or projects requiring depth and patience rather than flashy presentations.","rating":3,"keywords":["research","investigation","patience","depth"]},{"area":"love","title":"Intense Emotional Connections","prediction":"Venus-Pluto aspects bring intensity to romantic connections. Existing relationships may experience profound bonding or necessary confrontations. Single Scorpios attract magnetic, complex individuals.","rating":3,"keywords":["intensity","bonding","magnetism","depth"]},{"area":"health","title":"Detoxification Focus","prediction":"Your body's natural elimination processes are highlighted. Excellent day for detox practices, hydration, or addressing reproductive and elimination system health. Listen to subtle body signals.","rating":4,"keywords":["detoxification","elimination","healing","intuition"]},{"area":"finance","title":"Shared Resource Scrutiny","prediction":"Financial matters involving joint resources, debts, or investments require careful attention. Avoid major financial commitments but do investigate and research potential opportunities thoroughly.","rating":2,"keywords":["shared resources","investigation","caution","research"]},{"area":"relationships","title":"Truth and Authenticity","prediction":"Relationships benefit from honest, authentic communication. Surface-level interactions feel unsatisfying. Seek deeper connections and meaningful conversations that reveal true nature.","rating":4,"keywords":["authenticity","honesty","depth","meaning"]}],"planetary_influences":[{"planet":"Pluto","aspect_type":"conjunction","description":"Pluto's transformative energy in your sign brings deep psychological insights and personal evolution","strength":4},{"planet":"Saturn","aspect_type":"square","description":"Saturn square brings challenges that require patience and structured approaches to overcome","strength":3},{"planet":"Mars","aspect_type":"opposition","description":"Mars opposition may bring conflicts or tensions that require diplomatic resolution","strength":2}],"lucky_elements":{"colors":["deep red","burgundy","black"],"numbers":[4,13,22,31],"stones":["obsidian","garnet","bloodstone"],"directions":["north","underground"],"times":["midnight","early morning","twilight"]},"void_of_course_moon":{"start_time":"15:30","end_time":"18:45","advice":"Avoid making important decisions during this period. Focus on reflection and inner work instead."},"moon":{"phase":"Third Quarter","sign":"Cancer","prediction":"Third Quarter Moon in Cancer brings re-evaluation energy. Assess what to keep and what to release in emotional matters.","illumination":50.0},"tips":["Engage in deep meditation or psychological self-analysis","Avoid superficial social activities; seek meaningful connections","Use this energy for research, investigation, or healing work"]}}}}}},"400":{"description":"Invalid horoscope parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horoscope/sign/daily\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/sign/daily\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/sign/daily\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horoscope/sign/daily\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horoscope/sign/daily\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horoscope/personal/daily":{"post":{"tags":["🌟 Horoscopes & Predictions"],"summary":"Get Personalized Daily Horoscope","description":"🎯 **Personalized Daily Horoscope** - Complete birth chart analysis\n\n**Perfect for:**\n- 🔍 Professional astrology applications requiring precision\n- 👤 Personalized user experiences with exact birth data\n- 📊 Advanced astrological analysis with transits\n- 🎨 Premium horoscope services with deep insights\n\n**Key Features:**\n- 🎯 **Highly personalized** - Uses complete birth chart\n- 📍 **Location-aware** - Exact birth coordinates for house calculations\n- 🌌 **Transit analysis** - Current planetary positions vs natal chart\n- 🏠 **House-based predictions** - Predictions based on actual house placements\n- 📈 **Aspect activation** - Real natal aspects triggered by transits\n- 🔮 **Multiple techniques** - Traditional and modern approaches\n\n**Advanced Options:**\n- Include current planetary transits to natal chart\n- Optional secondary progressions (for deeper timing)\n- Multiple astrological traditions supported\n- Precise house system calculations\n\n**Response includes:**\n- Personalized predictions based on actual natal chart\n- Transit activations to natal planets and points\n- House-based life area analysis\n- Personalized lucky elements based on natal chart\n- Exact timing considerations for the individual\n- Custom advice based on natal chart patterns\n\n**Performance:**\n- Response time: 200-500ms (calculated on-demand)\n- Not cached (personalized for each individual)\n- Requires complete birth data including time and location\n- More accurate than sun-sign horoscopes\n\n**Use Cases:**\n- **Premium astrology apps** - Subscription-based personalized content\n- **Professional consultations** - Daily guidance for clients\n- **Relationship apps** - Personalized compatibility insights\n- **Life coaching apps** - Daily guidance based on astrological timing","operationId":"get_personalized_daily_horoscope_api_v3_horoscope_personal_daily_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedHoroscopeRequest"},"examples":{"today_no_date":{"summary":"Today's Horoscope (Auto Date)","description":"Personalized horoscope without specifying date - automatically uses today","value":{"subject":{"name":"Emma Thompson","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"horoscope_type":"daily","language":"en","tradition":"universal","include_transits":true,"include_progressions":false}},"today_analysis":{"summary":"Specific Date Analysis - London","description":"Personalized daily horoscope for a specific date using full birth chart data","value":{"subject":{"name":"Emma Thompson","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"second":0,"city":"London","country_code":"GB"}},"date":"2024-01-15","horoscope_type":"daily","language":"en","tradition":"universal","include_transits":true,"include_progressions":false}},"precise_timing":{"summary":"High Precision Analysis - New York","description":"Personalized horoscope with exact birth time and progressive techniques","value":{"subject":{"name":"Michael Rodriguez","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"second":30,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}},"date":"2024-03-20","horoscope_type":"daily","language":"en","tradition":"psychological","include_transits":true,"include_progressions":false}},"german_language":{"summary":"German Language - Berlin","description":"Daily horoscope in German. Supported: en, fr, de, es, it, pt, ru, hi, tr, uk","value":{"subject":{"name":"Hans Müller","birth_data":{"year":1988,"month":10,"day":5,"hour":11,"minute":30,"city":"Berlin","country_code":"DE"}},"language":"de","tradition":"universal"}}}}},"required":true},"responses":{"200":{"description":"Personalized daily horoscope based on complete birth chart analysis","content":{"application/json":{"schema":{},"examples":{"personalized_london":{"summary":"Emma's Personal Daily Horoscope - London","description":"Highly personalized daily horoscope using complete birth chart data with transit analysis","value":{"date":"2024-01-15","overall_theme":"Communication breakthroughs and relationship harmony through Venus-Mercury conjunction","overall_rating":4,"life_areas":[{"area":"identity","title":"Authentic Self-Expression","prediction":"With transiting Jupiter sextile your natal Sun, you're experiencing a period of authentic self-expression and personal growth. Your confidence in sharing your unique perspective is growing stronger.","rating":4,"keywords":["authenticity","growth","confidence","expression"],"reasoning":"Jupiter sextile natal Sun in 5th house enhances creative self-expression and personal confidence"},{"area":"communication","title":"Eloquent Expression","prediction":"Mercury conjunct Venus in your 7th house creates beautiful, harmonious communication. Perfect day for important conversations, negotiations, or creative writing. Your words carry both logic and charm.","rating":5,"keywords":["eloquence","harmony","negotiation","creativity"],"reasoning":"Transit Mercury conjunct Venus activating natal 7th house cusp"},{"area":"love","title":"Romantic Communication","prediction":"The Venus-Mercury conjunction in your partnership sector brings romantic conversations and potential relationship developments. Express your feelings with both honesty and grace.","rating":5,"keywords":["romance","partnership","expression","honesty"],"reasoning":"Venus-Mercury conjunction transiting natal 7th house"},{"area":"career","title":"Collaborative Success","prediction":"Saturn trine your MC suggests steady progress through collaborative efforts. Your professional relationships are key to advancement. Focus on building lasting partnerships rather than solo achievements.","rating":4,"keywords":["collaboration","progress","partnerships","advancement"],"reasoning":"Saturn trine natal Midheaven supports structured professional growth"},{"area":"health","title":"Mental-Emotional Balance","prediction":"With Moon sextile your natal Mercury, your mental and emotional health are in harmony. Excellent day for stress reduction through creative activities or meaningful conversations.","rating":4,"keywords":["balance","harmony","stress-relief","creativity"]},{"area":"finance","title":"Partnership Opportunities","prediction":"Financial opportunities may come through partnerships or joint ventures. The Venus-Mercury conjunction in your relationship sector suggests profitable collaborations, but get everything in writing.","rating":3,"keywords":["partnerships","collaboration","opportunities","documentation"]}],"planetary_influences":[{"planet":"Mercury","aspect_type":"conjunction","description":"Mercury conjunct Venus in 7th house enhances communication in all partnerships","strength":5,"natal_planet":"7th House Cusp","aspect_name":"Conjunction","orb":2.3,"reasoning":"This conjunction activates your natal partnership sector, making it an ideal time for important relationship conversations"},{"planet":"Jupiter","aspect_type":"sextile","description":"Jupiter sextile natal Sun expands personal confidence and creative expression","strength":4,"natal_planet":"Sun","aspect_name":"Sextile","orb":1.8},{"planet":"Saturn","aspect_type":"trine","description":"Saturn trine MC brings structured progress in career matters","strength":3,"natal_planet":"Medium_Coeli","aspect_name":"Trine","orb":3.1}],"lucky_elements":{"colors":["soft pink","light blue","sage green"],"numbers":[6,15,24,33],"stones":["rose quartz","amazonite","prehnite"],"directions":["west","northwest"],"times":["10:30 AM","3:15 PM","6:45 PM"]},"moon":{"phase":"Waxing Crescent","sign":"Pisces","prediction":"The Waxing Crescent Moon in Pisces enhances intuition and creative flow. Trust your inner guidance in partnership matters.","illumination":15.0},"tips":["Schedule important conversations or negotiations around 3:15 PM when the Venus-Mercury conjunction is strongest","Focus on partnership and collaborative projects today","Express your creative ideas through writing or speaking"]}}}}}},"400":{"description":"Invalid horoscope parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horoscope/personal/daily\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/daily\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/daily\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horoscope/personal/daily\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horoscope/personal/daily\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horoscope/personal/weekly":{"post":{"tags":["🌟 Horoscopes & Predictions"],"summary":"Get Personalized Weekly Horoscope","description":"🌟 **Personalized Weekly Horoscope** - Week ahead based on birth chart\n\n**Perfect for:**\n- 💎 Premium astrology apps with personalized subscriptions\n- 📧 Weekly email forecasts to clients\n- 🎯 Professional astrological consultations\n- 📱 Apps offering detailed weekly planning\n\n**What makes it personal:**\n- **Natal chart transits** - Real planetary movements to YOUR birth chart\n- **House activation** - Which life areas are emphasized THIS week\n- **Personal timing** - When YOU should act based on YOUR chart\n- **Individual patterns** - Aspects unique to YOUR natal placements\n\n**What you get:**\n- Personalized week overview based on actual transits\n- Day-by-day highlights for your specific chart\n- Life areas activated by current planetary positions\n- Personal lucky elements derived from natal chart\n- Customized advice based on your astrological makeup\n\n**Response time:** ~300ms | **Requires:** Complete birth data with time","operationId":"get_personalized_weekly_horoscope_api_v3_horoscope_personal_weekly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedHoroscopeRequest"},"examples":{"current_week_universal":{"summary":"Current Week - Universal Tradition","description":"Get personalized weekly horoscope for current week using universal astrological tradition","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}}}},"specific_week_psychological":{"summary":"Specific Week - Psychological Tradition","description":"Weekly forecast for specific week using psychological/Jungian approach","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"target_date":"2025-01-13","language":"en","tradition":"psychological"}},"coordinates_based":{"summary":"Using Coordinates - Classical Tradition","description":"Weekly horoscope using precise coordinates instead of city name","value":{"subject":{"name":"Michael","birth_data":{"year":1985,"month":8,"day":22,"hour":18,"minute":45,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}},"target_date":"2025-01-20","language":"en","tradition":"classical"}},"french_language":{"summary":"French Language (root level)","description":"Weekly horoscope in French using root-level parameter","value":{"subject":{"name":"Marie","birth_data":{"year":1992,"month":3,"day":8,"hour":9,"minute":15,"city":"Paris","country_code":"FR"}},"language":"fr","tradition":"universal"}},"spanish_via_options":{"summary":"Spanish Language (via options)","description":"Language can also be set inside 'options' object for API consistency","value":{"subject":{"name":"Carlos","birth_data":{"year":1995,"month":7,"day":20,"hour":16,"minute":45,"city":"Madrid","country_code":"ES"}},"options":{"language":"es","tradition":"universal"}}}}}},"required":true},"responses":{"200":{"description":"Personalized weekly horoscope based on complete birth chart with transit analysis","content":{"application/json":{"schema":{},"examples":{"emma_taurus_week":{"summary":"Emma (Taurus) - Balanced Week with Creative Peak","description":"Personalized weekly forecast showing natal chart-based predictions with transit aspects","value":{"success":true,"data":{"subject":"Emma","sign":"Taurus","timeframe":"weekly","weekly_theme":"You seek stability and find purpose in creating something tangible and lasting. Your identity is grounded in the material world, and you are here to learn about value, patience, and the simple pleasures of life. This week, honor the rhythm that keeps you centered.","overall_rating":3,"time_window":{"start":"2025-01-13","end":"2025-01-19","timeframe":"weekly","days":7},"life_areas":[{"area":"creativity","title":"🎨 Creativity","prediction":"Exceptional week for creative breakthroughs and artistic mastery. Your imagination soars and creates works that truly inspire others.","rating":5,"keywords":["creativity","art","inspiration","artistic","expression"],"reasoning":"Natal Sun in Taurus • ruled by Venus • guides powerful weekly momentum"},{"area":"finance","title":"💰 Finance","prediction":"Strong financial energy supports prosperity this week. Good opportunities for increasing income or making wise investments.","rating":4,"keywords":["money","wealth","prosperity","abundance","resources"]}],"planetary_influences":[{"planet":"Venus","aspect_type":"trine","description":"A harmonious flow where transiting Venus beautifully enhances your natal Sun. Your identity and purpose are naturally enhanced.","strength":2,"natal_planet":"Sun","aspect_name":"Venus trine Sun","orb":0.79,"area":"love"}],"lucky_elements":{"colors":["white","silver","sea green"],"numbers":[1,3,5,8],"stones":["pearl","moonstone","selenite"],"directions":["southeast","northeast"],"times":["06:01","10:06","13:09"]},"moon":{"phase":"Waning Crescent","sign":"Cancer","illumination":1.0,"prediction":"Waning Crescent Moon in Cancer whispers intuitive closure."},"tips":["This is your week to shine and make significant progress. Trust your instincts and embrace the positive energy.","Focus on creative projects this week - your artistic energy is at its peak."]}}}}}}},"400":{"description":"Invalid horoscope parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horoscope/personal/weekly\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/weekly\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/weekly\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horoscope/personal/weekly\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horoscope/personal/weekly\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horoscope/personal/monthly":{"post":{"tags":["🌟 Horoscopes & Predictions"],"summary":"Get Personalized Monthly Horoscope","description":"🌙 **Personalized Monthly Horoscope** - Month ahead based on birth chart\n\n**Perfect for:**\n- 📅 Monthly planning and goal-setting apps\n- 📧 Monthly newsletter forecasts to subscribers\n- 🎯 Professional astrological monthly consultations\n- 📊 Long-term trend analysis and planning\n\n**What makes it personal:**\n- **Natal chart transits** - Slow-moving planets affecting YOUR chart\n- **Lunar cycle integration** - New & Full Moons in relation to YOUR houses\n- **Monthly timing** - Best periods for action based on YOUR chart\n- **House activations** - Which life sectors dominate THIS month\n- **Progressive patterns** - Long-term developments in YOUR life\n\n**What you get:**\n- Personalized month overview based on actual planetary transits\n- New Moon and Full Moon dates with personal significance\n- Life areas emphasized throughout the month\n- Major planetary influences for the entire month\n- Personal lucky elements derived from natal chart\n- Strategic advice for monthly planning\n\n**Response time:** ~350ms | **Requires:** Complete birth data with time","operationId":"get_personalized_monthly_horoscope_api_v3_horoscope_personal_monthly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedHoroscopeRequest"},"examples":{"current_month_universal":{"summary":"Current Month - Universal Tradition","description":"Get personalized monthly horoscope for current month using universal tradition","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}}}},"specific_month_psychological":{"summary":"Specific Month - Psychological Tradition","description":"Monthly forecast for January 2025 using psychological/Jungian approach","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"target_date":"2025-01-15","language":"en","tradition":"psychological"}},"coordinates_classical":{"summary":"Using Coordinates - Classical Tradition","description":"Monthly horoscope using precise coordinates for birth location","value":{"subject":{"name":"Sophia","birth_data":{"year":1992,"month":3,"day":21,"hour":9,"minute":15,"latitude":48.8566,"longitude":2.3522,"timezone":"Europe/Paris"}},"target_date":"2025-02-10","language":"en","tradition":"classical"}}}}},"required":true},"responses":{"200":{"description":"Personalized monthly horoscope based on complete birth chart with lunar cycle analysis","content":{"application/json":{"schema":{},"examples":{"emma_taurus_month":{"summary":"Emma (Taurus) - Productive Month with Financial Growth","description":"Personalized monthly forecast showing natal chart-based predictions with New/Full Moon analysis","value":{"success":true,"data":{"subject":"Emma","sign":"Taurus","timeframe":"monthly","monthly_theme":"You seek stability and find purpose in creating something tangible and lasting. Your identity is grounded in the material world. This month, build upon your foundations with patience and persistence.","overall_rating":4,"time_window":{"start":"2025-01-01","end":"2025-01-31","timeframe":"monthly","days":31},"new_moon_date":"2025-01-06","full_moon_date":"2025-01-20","life_areas":[{"area":"finance","title":"💰 Finance","prediction":"Exceptional month for financial growth and building wealth. Jupiter's influence brings opportunities for increased income and wise investments.","rating":5,"keywords":["prosperity","investments","wealth","abundance","stability"],"reasoning":"Natal Sun in Taurus • ruled by Jupiter, Venus • guides powerful monthly momentum"},{"area":"career","title":"💼 Career","prediction":"Strong professional progress throughout the month. Your practical skills and reliability are recognized and rewarded.","rating":4,"keywords":["achievement","recognition","progress","stability"]}],"planetary_influences":[{"planet":"Jupiter","aspect_type":"trine","description":"Jupiter trine natal Venus brings expansion in financial matters and relationships. Opportunities flow naturally this month.","strength":4,"natal_planet":"Venus","aspect_name":"Jupiter trine Venus","orb":2.1,"area":"finance"}],"lucky_elements":{"colors":["emerald green","rose pink","earth brown"],"numbers":[6,15,24,33],"stones":["emerald","rose quartz","jade"],"directions":["north","northeast"]},"moon":{"phase":"Waxing Gibbous","sign":"Virgo","illumination":78.0,"prediction":"Waxing Gibbous Moon in Virgo supports practical planning and organization."}}}}}}}},"400":{"description":"Invalid horoscope parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horoscope/personal/monthly\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/monthly\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/monthly\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horoscope/personal/monthly\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horoscope/personal/monthly\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horoscope/personal/yearly":{"post":{"tags":["🌟 Horoscopes & Predictions"],"summary":"Get Personalized Yearly Horoscope","description":"🎆 **Personalized Yearly Horoscope** - Year ahead based on birth chart\n\n**Perfect for:**\n- 📅 Annual planning and New Year forecasts\n- 🎯 Long-term goal setting and life planning\n- 💼 Career and business strategy planning\n- 📧 Annual forecast reports to clients\n- 🔮 Professional yearly consultations\n\n**What makes it personal:**\n- **Long-term transits** - Slow-moving planets affecting YOUR chart all year\n- **Quarterly breakdown** - How the year unfolds for YOU by quarters\n- **Annual timing** - Best periods for major decisions in YOUR life\n- **Life cycle patterns** - Where YOU are in major astrological cycles\n- **Saturn/Jupiter returns** - Personal milestone years identified\n\n**What you get:**\n- Personalized year overview based on natal chart\n- Quarterly breakdown with focus areas and ratings\n- Life areas emphasized throughout the year\n- Major long-term planetary influences\n- Personal lucky elements for the year\n- Strategic advice for annual planning\n\n**Response time:** ~400ms | **Requires:** Complete birth data with time","operationId":"get_personalized_yearly_horoscope_api_v3_horoscope_personal_yearly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedHoroscopeRequest"},"examples":{"current_year_universal":{"summary":"Current Year - Universal Tradition","description":"Get personalized yearly horoscope for current year using universal tradition","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}}}},"specific_year_2025":{"summary":"Specific Year (2025) - Psychological Tradition","description":"Yearly forecast for 2025 using psychological/Jungian approach","value":{"subject":{"name":"Emma","birth_data":{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"London","country_code":"GB"}},"target_date":"2025-06-15","language":"en","tradition":"psychological"}},"next_year_classical":{"summary":"Next Year (2026) - Classical Tradition","description":"Yearly horoscope for 2026 using classical astrological approach","value":{"subject":{"name":"Alexander","birth_data":{"year":1988,"month":11,"day":3,"hour":22,"minute":10,"latitude":55.7558,"longitude":37.6173,"timezone":"Europe/Moscow"}},"target_date":"2026-01-01","language":"en","tradition":"classical"}}}}},"required":true},"responses":{"200":{"description":"Personalized yearly horoscope based on complete birth chart with long-term transit analysis","content":{"application/json":{"schema":{},"examples":{"emma_taurus_year":{"summary":"Emma (Taurus) - Transformative Year Ahead","description":"Personalized yearly forecast showing natal chart-based predictions with quarterly breakdown","value":{"success":true,"data":{"subject":"Emma","sign":"Taurus","timeframe":"yearly","yearly_theme":"You seek stability and find purpose in creating something tangible and lasting. This year brings opportunities for building lasting foundations and achieving concrete results through patience and persistence.","overall_rating":4,"time_window":{"start":"2025-01-01","end":"2025-12-31","timeframe":"yearly","days":365},"quarterly_breakdown":[{"quarter":"Q1","focus":"Foundation Building","rating":4},{"quarter":"Q2","focus":"Growth & Expansion","rating":3},{"quarter":"Q3","focus":"Consolidation","rating":4},{"quarter":"Q4","focus":"Achievement","rating":5}],"life_areas":[{"area":"career","title":"💼 Career","prediction":"Professional advancement through steady effort and strategic planning. Major opportunities in Q4.","rating":5,"keywords":["advancement","strategy","achievement","recognition"]}],"planetary_influences":[{"planet":"Jupiter","aspect_type":"trine","description":"Jupiter trine natal Sun throughout the year brings expansion and good fortune in career matters.","strength":4,"natal_planet":"Sun"}]}}}}}}},"400":{"description":"Invalid horoscope parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horoscope/personal/yearly\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/yearly\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/personal/yearly\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horoscope/personal/yearly\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":""},{"lang":"Go","label":"Go + net/http","source":"package main\n\nimport (\n \"bytes\"\n \"encoding/json\"\n \"fmt\"\n \"io\"\n \"net/http\"\n)\n\nfunc main() {\n url := \"https://api.astrology-api.io/api/v3/horoscope/personal/yearly\"\n \n data := map[string]interface{}{\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n \n jsonData, err := json.Marshal(data)\n if err != nil {\n fmt.Printf(\"❌ Error marshaling JSON: %v\\n\", err)\n return\n }\n \n resp, err := http.Post(url, \"application/json\", bytes.NewBuffer(jsonData))\n if err != nil {\n fmt.Printf(\"❌ Error making request: %v\\n\", err)\n return\n }\n defer resp.Body.Close()\n \n body, err := io.ReadAll(resp.Body)\n if err != nil {\n fmt.Printf(\"❌ Error reading response: %v\\n\", err)\n return\n }\n \n if resp.StatusCode == 200 {\n fmt.Println(\"✅ Success!\")\n var result map[string]interface{}\n json.Unmarshal(body, &result)\n prettyJSON, _ := json.MarshalIndent(result, \"\", \" \")\n fmt.Println(string(prettyJSON))\n } else {\n fmt.Printf(\"❌ Error: %d\\n\", resp.StatusCode)\n fmt.Println(string(body))\n }\n}"}]}},"/api/v3/horoscope/sign/weekly":{"post":{"tags":["🌟 Horoscopes & Predictions"],"summary":"Get Weekly Sun Sign Horoscope","description":"📅 **Weekly Sun-Sign Horoscope** - 7-day astrological outlook\n\n**Perfect for:**\n- 📱 Weekly planning and scheduling apps\n- 📰 Weekly horoscope columns and newsletters\n- 🌐 Weekly website content updates\n- 📊 Medium-term trend analysis\n\n**Key Features:**\n- 📆 **Week-long analysis** - Major themes and key dates\n- 🌌 **Planetary patterns** - Medium-speed planet movements\n- 📈 **Daily highlights** - Important dates within the week\n- 🎯 **Weekly goals** - Best days for different activities\n- 🌙 **Lunar cycle integration** - Weekly moon phase impacts\n\n**Response includes:**\n- Overall weekly theme and rating\n- Key dates and their significance\n- Life area predictions for the week\n- Major planetary influences\n- Weekly advice and planning suggestions","operationId":"get_weekly_sun_sign_horoscope_api_v3_horoscope_sign_weekly_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request"},"examples":{"gemini_current_week":{"summary":"Gemini Weekly Horoscope - Current Week","description":"Get weekly horoscope for Gemini starting from current Monday","value":{"sign":"Gemini","start_date":"2024-01-15","language":"en","tradition":"universal"}}}}},"required":true},"responses":{"200":{"description":"Weekly horoscope with transit events and life area predictions","content":{"application/json":{"schema":{},"examples":{"gemini_communication_week":{"summary":"Gemini - Communication & Learning Focus","description":"A dynamic week for Gemini with strong Mercury influences and networking opportunities","value":{"week_start":"2024-01-15","week_end":"2024-01-21","sign":"Gemini","weekly_theme":"Mental agility and communication mastery drive success","overall_rating":4,"events":[{"date":"2024-01-16","transiting_planet":"Mercury","aspect_type":"sextile","stationed_planet":"Sun","orb":2.1,"interpretation":"Mercury sextile Sun enhances mental clarity and communication skills. Perfect day for presentations, writing, or learning new subjects. Your quick wit and adaptability shine.","aspect_direction":"applying"},{"date":"2024-01-18","transiting_planet":"Venus","aspect_type":"trine","stationed_planet":"Mercury","orb":1.8,"interpretation":"Venus trine Mercury brings harmony to all communications and social interactions. Excellent for networking events, romantic conversations, or creative collaborations.","aspect_direction":"exact"},{"date":"2024-01-20","transiting_planet":"Mars","aspect_type":"square","stationed_planet":"Mercury","orb":3.2,"interpretation":"Mars square Mercury may bring hasty communications or mental restlessness. Think before speaking and double-check important messages. Channel mental energy into physical activities.","aspect_direction":"separating"}],"life_areas":[{"area":"communication","interpretation":"This week highlights your natural communication gifts. Mercury's favorable aspects early in the week make it ideal for important conversations, presentations, or launching communication projects. However, be mindful of the Mars-Mercury square on Friday which could lead to misunderstandings if you're not careful with your words.","keywords":["eloquence","networking","writing","clarity"]},{"area":"learning","interpretation":"Your curiosity and learning capacity are enhanced this week. Perfect time to start new courses, research projects, or explore subjects that have always interested you. The Venus-Mercury trine midweek supports creative learning approaches.","keywords":["curiosity","research","education","creativity"]},{"area":"career","interpretation":"Professional success comes through your ability to communicate ideas clearly and build connections. Focus on collaborative projects and networking opportunities. The week's planetary influences favor roles involving writing, teaching, or information sharing.","keywords":["collaboration","networking","communication","ideas"]},{"area":"relationships","interpretation":"Social connections flourish this week, especially mid-week when Venus harmonizes with Mercury. Your wit and charm attract interesting people. However, be mindful of scattered energy preventing deep connections.","keywords":["social","charm","connections","variety"]}],"lucky_elements":{"colors":["bright yellow","silver","light green"],"numbers":[3,12,21,30],"stones":["citrine","clear quartz","agate"],"directions":["east","northeast"],"times":["morning","early afternoon"]},"weekly_advice":"Embrace your natural curiosity and communication skills this week. The Mercury influences make it an excellent time for learning, networking, and sharing your ideas. Focus on Tuesday and Wednesday for important communications, but be more careful with your words on Friday. Let your mental agility guide you toward new opportunities and connections."}}}}}},"400":{"description":"Invalid horoscope parameters"},"422":{"description":"Validation error - check request format"},"501":{"description":"Feature not yet implemented"}},"x-codeSamples":[{"lang":"Shell","label":"cURL + jq","source":"curl -X POST \"https://api.astrology-api.io/api/v3/horoscope/sign/weekly\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"subject\": {\"name\": \"John Doe\", \"birth_data\": {\"year\": 1990, \"month\": 5, \"day\": 15, \"hour\": 14, \"minute\": 30, \"city\": \"London\", \"country_code\": \"GB\"}}, \"options\": {\"house_system\": \"P\", \"zodiac_type\": \"Tropic\", \"active_points\": [\"Sun\", \"Moon\", \"Mercury\", \"Venus\", \"Mars\", \"Jupiter\", \"Saturn\"], \"precision\": 2}}' \\\n | jq ."},{"lang":"JavaScript","label":"JavaScript + fetch","source":"// Using fetch API (Node.js 18+ or browser)\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/sign/weekly\";\n\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\ntry {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify(data)\n });\n \n const result = await response.json();\n \n if (response.ok) {\n console.log('✅ Success:', result);\n } else {\n console.error('❌ Error:', response.status, result);\n }\n} catch (error) {\n console.error('❌ Network error:', error);\n}"},{"lang":"JavaScript","label":"Node.js + axios","source":"// Using axios library\nconst axios = require('axios');\n\nconst url = \"https://api.astrology-api.io/api/v3/horoscope/sign/weekly\";\nconst data = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n};\n\naxios.post(url, data)\n .then(response => {\n console.log('✅ Success:', response.data);\n })\n .catch(error => {\n if (error.response) {\n console.error('❌ Error:', error.response.status, error.response.data);\n } else {\n console.error('❌ Network error:', error.message);\n }\n });"},{"lang":"Python","label":"Python + requests","source":"import requests\nimport json\n\n# API endpoint\nurl = \"https://api.astrology-api.io/api/v3/horoscope/sign/weekly\"\n\n# Request data\ndata = {\n \"subject\": {\n \"name\": \"John Doe\",\n \"birth_data\": {\n \"year\": 1990,\n \"month\": 5,\n \"day\": 15,\n \"hour\": 14,\n \"minute\": 30,\n \"city\": \"London\",\n \"country_code\": \"GB\"\n }\n },\n \"options\": {\n \"house_system\": \"P\",\n \"zodiac_type\": \"Tropic\",\n \"active_points\": [\n \"Sun\",\n \"Moon\",\n \"Mercury\",\n \"Venus\",\n \"Mars\",\n \"Jupiter\",\n \"Saturn\"\n ],\n \"precision\": 2\n }\n}\n\n# Make the request\nresponse = requests.post(\n url,\n headers={\"Content-Type\": \"application/json\"},\n json=data\n)\n\n# Handle response\nif response.status_code == 200:\n result = response.json()\n print(\"✅ Success!\")\n print(json.dumps(result, indent=2))\nelse:\n print(f\"❌ Error: {response.status_code}\")\n print(response.text)"},{"lang":"PHP","label":"PHP + cURL","source":"