How to Build a Natal Chart App with Free Western Astrology API — Aspects, Houses & Synastry

import requests

url = "https://astroask-vedic-western-astrology-api.p.rapidapi.com/api/v1/western"

payload = {
    "date": "2002-11-11T00:00:00",
    "lat": 40.7128,   # New York latitude
    "lng": -74.0060,  # New York longitude
    "houseSystem": "placidus",
    "format": "json"
}

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "astroask-vedic-western-astrology-api.p.rapidapi.com",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(data)

const url = "https://astroask-vedic-western-astrology-api.p.rapidapi.com/api/v1/western";

const payload = {
    date: "2002-11-11T00:00:00",
    lat: 40.7128,
    lng: -74.0060,
    houseSystem: "placidus",
    format: "json"
};

const response = await fetch(url, {
    method: "POST",
    headers: {
        "x-rapidapi-key": "YOUR_API_KEY",
        "x-rapidapi-host": "astroask-vedic-western-astrology-api.p.rapidapi.com",
        "Content-Type": "application/json"
    },
    body: JSON.stringify(payload)
});

const data = await response.json();
console.log(data);

curl -X POST "https://astroask-vedic-western-astrology-api.p.rapidapi.com/api/v1/western" \
  -H "x-rapidapi-key: YOUR_API_KEY" \
  -H "x-rapidapi-host: astroask-vedic-western-astrology-api.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{"date": "2002-11-11T00:00:00", "lat": 40.7128, "lng": -74.0060, "houseSystem": "placidus"}'

{"success":true,"data":{"planets":[{"planet":"Sun","signName":"Scorpio","tropicalLongitude":228.19,"house":3,"isRetrograde":false},{"planet":"Moon","signName":"Aquarius","tropicalLongitude":305.41,"house":6,"isRetrograde":false},{"planet":"Mercury","signName":"Scorpio","tropicalLongitude":215.87,"house":3,"isRetrograde":false}//...all10planets(SunthroughPluto)],"houses":{"houses":[{"house":1,"sign":"Libra","cusp":195.52},{"house":2,"sign":"Scorpio","cusp":225.31}//...all12houses],"ascendant":{"sign":"Libra","degree":15.52},"midheaven":{"sign":"Cancer","degree":78.23}},"aspects":[{"planet1":"Sun","planet2":"Moon","aspect":"Square","angle":82.78,"orb":7.22,"isApplying":true},{"planet1":"Venus","planet2":"Mars","aspect":"Trine","angle":119.45,"orb":0.55,"isApplying":false}//...allmajoraspects],"patterns":[{"type":"Stellium","planets":["Sun","Mercury","Venus"],"sign":"Scorpio","description":"3 planets in Scorpio — intense focus on transformation"}]}}

def get_chart_aspects(birth_data):
    """Get all aspects in a natal chart."""
    chart = get_natal_chart(birth_data)
    aspects = chart['aspects']

    # Filter for major aspects only
    major_aspects = [a for a in aspects if a['aspect'] in 
        ['Conjunction', 'Trine', 'Square', 'Sextile', 'Opposition']]

    # Sort by orb (tightest aspects first — most powerful)
    major_aspects.sort(key=lambda a: a['orb'])

    return {
        "total_aspects": len(aspects),
        "major_aspects": major_aspects,
        "tightest_aspect": major_aspects[0] if major_aspects else None
    }

# Default — Placidus
payload = {"date": "2002-11-11T00:00:00", "lat": 40.7128, "lng": -74.0060}

# Explicit house system
payload = {
    "date": "2002-11-11T00:00:00",
    "lat": 40.7128,
    "lng": -74.0060,
    "houseSystem": "whole_sign"  # Options: placidus, koch, equal, whole_sign, campanus, regiomontanus
}

def analyze_chart_patterns(birth_data):
    """Detect major chart patterns in a natal chart."""
    chart = get_natal_chart(birth_data)
    patterns = chart['patterns']

    result = {
        "has_grand_trine": any(p['type'] == 'Grand Trine' for p in patterns),
        "has_t_square": any(p['type'] == 'T-Square' for p in patterns),
        "has_yod": any(p['type'] == 'Yod' for p in patterns),
        "has_stellium": any(p['type'] == 'Stellium' for p in patterns),
        "pattern_count": len(patterns),
        "patterns": patterns
    }

    if result['has_grand_trine']:
        result['advice'] = "You have natural gifts — focus on developing them"
    elif result['has_t_square']:
        result['advice'] = "Your challenges drive your greatest growth"

    return result

# For detailed pattern analysis, use the patterns endpoint
url = "https://astroask-vedic-western-astrology-api.p.rapidapi.com/api/v1/western/patterns"

payload = {"date": "2002-11-11T00:00:00"}

response = requests.post(url, json=payload, headers=headers)
patterns = response.json()

# Returns: grandTrines, grandCrosses, tSquares, yods, stelliums
print(f"Grand Trines: {patterns['data']['summary']['grandTrineCount']}")
print(f"T-Squares: {patterns['data']['summary']['tSquareCount']}")

url = "https://astroask-vedic-western-astrology-api.p.rapidapi.com/api/v1/compatibility"

payload = {
    "person1": {
        "date": "2002-11-11T00:00:00",
        "lat": 40.7128,
        "lng": -74.0060
    },
    "person2": {
        "date": "1999-05-15T14:30:00",
        "lat": 34.0522,
        "lng": -118.2437
    },
    "system": "western"  # Key: use "western" for tropical synastry
}

response = requests.post(url, json=payload, headers=headers)
synastry = response.json()

print(synastry)

def get_relationship_report(person1_data, person2_data):
    """Generate a Western synastry compatibility report."""
    synastry = get_synastry(person1_data, person2_data, system="western")

    # Find the strongest aspects between charts
    interaspects = synastry['data']['interaspects']

    # Categorize by type
    harmonious = [a for a in interaspects if a['aspect'] in ['Trine', 'Sextile', 'Conjunction']]
    challenging = [a for a in interaspects if a['aspect'] in ['Square', 'Opposition']]

    return {
        "harmonious_connections": len(harmonious),
        "challenging_connections": len(challenging),
        "strongest_aspect": min(interaspects, key=lambda a: a['orb']),
        "summary": generate_summary(harmonious, challenging)
    }

url = "https://astroask-vedic-western-astrology-api.p.rapidapi.com/api/v1/western/solar-return"

payload = {
    "date": "2002-11-11T00:00:00",  # Birth date
    "lat": 40.7128,
    "lng": -74.0060,
    "targetYear": 2026  # Which year to calculate
}

response = requests.post(url, json=payload, headers=headers)
solar_return = response.json()

print(f"Solar Return 2026 themes:")
print(f"  Ascendant: {solar_return['data']['ascendant']['sign']}")
print(f"  Sun house: {solar_return['data']['sunHouse']}")
print(f"  Moon sign: {solar_return['data']['moonSign']}")

# Get the chart as SVG
payload = {
    "date": "2002-11-11T00:00:00",
    "lat": 40.7128,
    "lng": -74.0060,
    "format": "svg",           # Return SVG instead of JSON
    "theme": "dark",           # "light" or "dark"
    "showTable": true,         # Show planet positions table
    "width": 800,
    "height": 800,
    "wheelSize": 600,
    "rotateToAscendant": true, # Ascendant at 9 o'clock
    "planetRenderMode": "glyph",  # "glyph" (symbols) or "text"
    "signRenderMode": "glyph"     # "glyph" (symbols) or "text"
}

response = requests.post(url, json=payload, headers=headers)
svg_data = response.json()

# Save the SVG
with open("natal_chart.svg", "w") as f:
    f.write(svg_data['data']['svg'])

<div id="natal-chart"></div>

<script>
// After fetching the API response
const chartSvg = data.data.svg;
document.getElementById('natal-chart').innerHTML = chartSvg;
</script>

function NatalChart({ birthData }) {
  const [chartSvg, setChartSvg] = useState('');

  useEffect(() => {
    fetch('/api/western', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ ...birthData, format: 'svg', theme: 'dark' })
    })
    .then(res => res.json())
    .then(data => setChartSvg(data.data.svg));
  }, [birthData]);

  return (
    <div 
      className="natal-chart-container"
      dangerouslySetInnerHTML={{ __html: chartSvg }} 
    />
  );
}

@app.route('/api/compatibility-check')
def compatibility_check():
    """Check synastry between two users."""
    synastry = get_synastry(
        user1.birth_data, 
        user2.birth_data, 
        system="western"
    )

    interaspects = synastry['data']['interaspects']

    # Calculate compatibility score
    harmonious = len([a for a in interaspects if a['aspect'] in ['Trine', 'Sextile']])
    challenging = len([a for a in interaspects if a['aspect'] in ['Square', 'Opposition']])

    score = min(100, max(0, 50 + (harmonious * 10) - (challenging * 5)))

    return {
        "compatibility_score": score,
        "harmonious_aspects": harmonious,
        "challenging_aspects": challenging,
        "strongest_connection": min(interaspects, key=lambda a: a['orb']),
        "summary": generate_synastry_summary(interaspects)
    }

@app.route('/api/daily-horoscope')
def daily_horoscope():
    """Generate personalized daily horoscope using transits."""
    # Get current transits to user's natal chart
    transits = get_transits(user.birth_data, target_date=today)

    # Find active transits (tight orbs)
    active_transits = [t for t in transits if t['orb'] < 3]

    prompt = f"""
    User's natal chart: {user.birth_chart}
    Active transits today: {active_transits}

    Write a personalized daily horoscope based on these transits.
    Be specific about which planetary aspects are active.
    """

    return {"horoscope": ai_generate(prompt)}

@app.route('/api/year-ahead')
def year_ahead():
    """Generate solar return + progressions report."""
    solar_return = get_solar_return(user.birth_data, target_year=2026)
    progressions = get_progressions(user.birth_data, target_date=today)

    return {
        "solar_return": {
            "themes": solar_return['data']['themes'],
            "focus_area": solar_return['data']['sunHouse'],
            "opportunities": solar_return['data']['aspects']
        },
        "progressions": {
            "progressed_moon_sign": progressions['data']['progressedMoonSign'],
            "solar_arc_aspects": progressions['data']['solarArcAspects']
        },
        "advice": generate_year_advice(solar_return, progressions)
    }

// Embed natal chart in any website
function embedChart(containerId, birthData, options = {}) {
  const defaultOptions = {
    format: 'svg',
    theme: 'dark',
    width: 500,
    height: 500,
    wheelSize: 400,
    showTable: true,
    rotateToAscendant: true
  };

  const payload = { ...birthData, ...defaultOptions, ...options };

  fetch('https://astroask-vedic-western-astrology-api.p.rapidapi.com/api/v1/western', {
    method: 'POST',
    headers: {
      'x-rapidapi-key': 'YOUR_API_KEY',
      'x-rapidapi-host': 'astroask-vedic-western-astrology-api.p.rapidapi.com',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
  })
  .then(res => res.json())
  .then(data => {
    document.getElementById(containerId).innerHTML = data.data.svg;
  });
}

// Usage
embedChart('my-chart', {
  date: '2002-11-11T00:00:00',
  lat: 40.7128,
  lng: -74.0060
}, { theme: 'dark', width: 600 });

# ✅ CORRECT — use local birth time
{"date": "2002-11-11T14:30:00", "lat": 40.7128, "lng": -74.0060}

# ❌ WRONG — don't convert to UTC yourself
{"date": "2002-11-11T19:30:00Z", "lat": 40.7128, "lng": -74.0060}

# Western — tropical zodiac (Aries starts at vernal equinox)
response = requests.post(".../api/v1/western", ...)

# Vedic — sidereal zodiac (accounts for precession)
response = requests.post(".../api/v1/kundali", ...)

HOUSE_SYSTEMS = {
    "placidus": "Most popular (default)",
    "koch": "German school",
    "equal": "Simple 30° houses",
    "whole_sign": "Modern revival — each sign = one house",
    "campanus": "Space-based division",
    "regiomontanus": "Medieval tradition"
}

# ❌ WRONG — city center approximation
{"lat": 40.7, "lng": -74.0}

# ✅ CORRECT — precise coordinates
{"lat": 40.7128, "lng": -74.0060}

from functools import lru_cache

@lru_cache(maxsize=1000)
def get_natal_chart(date, lat, lng):
    # Only calls API once per unique birth data
    return api_call(date, lat, lng)

# Get only strong aspects (orb < 5°)
strong_aspects = [a for a in aspects if a['orb'] < 5]

response = requests.post(url, json=payload, headers=headers)
data = response.json()

if not data.get('success'):
    error = data.get('error', 'Unknown error')
    print(f"API Error: {error}")
    return None