Composite Chart API that Reveals Your Relationship Personality
Relationship Composite Charts via Planetary Midpoints in <300ms
Complete Your Astrology Stack
Composite API works best combined with our other tools. Add
Relationship Composite Charts via Planetary Midpoints in <300ms
Composite API works best combined with our other tools. Add
Built for scale, optimized for speed
Everything for professional relationship entity analysis
Start free, scale as you grow. No hidden fees, no surprises.
For small apps and personal projects
For growing apps and medium traffic
For enterprise-scale applications
All plans include comprehensive documentation and SDKs
Questions? Talk to our team
Everything developers need to add relationship entity analysis
Composite charts are like DNA tests for relationships - they reveal the unique personality that emerges when two people come together. Unlike synastry (how two people interact), composite charts show the relationship itself as a third entity using midpoint calculations between planetary positions. For dating app developers, this means offering 'birth chart for your relationship' features that analyze relationship dynamics, purpose, timing, and evolutionary phases with Swiss Ephemeris precision.
Composite chart calculation works like mathematical magic - it finds the exact midpoint between each planet in two birth charts to create a unified chart representing the relationship entity.
Think of it like averaging GPS coordinates: if person A's Venus is at 15° Aries and person B's Venus is at 15° Gemini, the composite Venus lands at 0° Taurus.
This process happens for all 10 planets plus key points, creating a complete birth chart for the relationship itself.
Our API automatically handles complex calculations like crossing zodiac boundaries, retrograde considerations, and house system variations.
The result is a relationship chart showing the partnership's personality, strengths, challenges, and evolutionary purpose.
While synastry analyzes how two individual charts interact ('your planets affect their chart'), composite charts create an entirely new entity representing the relationship itself.
It's like the difference between studying two separate people in conversation versus studying the conversation as its own living thing.
Synastry shows attraction patterns and compatibility; composite reveals the relationship's soul purpose, shared mission, and how the partnership will evolve over time.
Professional astrologers use both methods together - synastry for initial compatibility, composite for deeper relationship understanding.
Our API provides both analyses, but composite charts often reveal surprising insights about relationships that appear incompatible in synastry yet have deep spiritual connections.
Integrating composite chart analysis takes 3-6 hours for basic implementation.
Step 1: Collect birth data from both users (date, time, location required).
Step 2: Send paired user data to /composite endpoint with optional settings for house system and calculation method.
Step 3: Display relationship chart, aspects, interpretations, and timing guidance.
Advanced features include relationship phases, composite progressions, and solar returns for anniversary analysis.
Technical benefits include <300ms response time for real-time relationship analysis, complete JSON response with chart positions and human-readable interpretations, plus built-in visualization data for chart rendering.
Most platforms start with basic composite personality analysis then add premium features like relationship timing and evolutionary patterns.
Most astrology APIs offer basic planetary positions without interpretation.
We deliver complete relationship intelligence with professional composite analysis including 100+ calculations, house overlays, aspect patterns, and Arabic parts - all in one API call.
Speed advantage: what takes professional astrologers 2-4 hours of manual calculation, we deliver in <300ms.
Accuracy advantage: Swiss Ephemeris precision with support for 23 house systems and multiple calculation methods (standard midpoints, Davison method, progressive composite).
Business advantage: built specifically for developers with complete documentation, code examples, and relationship app integration guides.
Cultural advantage: supports Western, Vedic, and Hellenistic composite techniques for global markets.
Add 'Your Relationship Chart' features showing couples their unique partnership personality, timing, and evolutionary patterns
Generate professional composite analysis for couple therapy sessions with relationship strengths, challenges, and growth opportunities
Automate composite chart generation for professional astrologers offering relationship readings and compatibility consultations
Analyze business partnership dynamics, timing, and compatibility for professional relationship consulting services
| API Response Time | <300ms average, <500ms p99 for complete analysis |
| Calculation Methods | Standard midpoints, Davison method, progressive composite |
| House Systems | 23 house systems including Placidus, Whole Sign, Koch |
| Planetary Bodies | 10 planets + nodes, asteroids, Arabic parts (97+ points) |
| Relationship Features | Timing, phases, solar returns, progressions |
| Cultural Support | Western, Vedic, Hellenistic composite traditions |
| Required Birth Data | Date, time, location for both individuals |
| Accuracy Level | Swiss Ephemeris precision with timezone handling |
| Output Format | JSON with positions, aspects, interpretations |
| Integration Time | 3-6 hours basic, 1-2 days with advanced features |
| Feature | Astrology API | Others |
|---|---|---|
| Response Time | <300ms full composite | 2-3 seconds or manual calculation |
| Calculation Methods | 3 composite methods supported | Basic midpoints only |
| Relationship Intelligence | 100+ calculations with interpretations | 15-20 basic calculations |
| House Systems | 23 house systems | 4-6 house systems |
| Arabic Parts | 97+ composite Arabic parts | None or basic only |
| Cultural Methods | Western, Vedic, Hellenistic | Western only |
| Developer Support | Complete docs with app examples | Basic API reference |
| Price | $37/month for 55K analyses | $99-299/month for basic features |
Analyze how two individuals interact and complement composite analysis
Individual birth chart analysis as foundation for composite calculations
Relationship timing guidance with composite progressions
Comprehensive relationship analysis combining multiple methods
Individual and relationship forecasts with composite insights
Complete technical reference for all astrology endpoints
Everything you need to know about relationship analysis