Composite Chart API
Create a symbolic midpoint chart from two sets of natal planetary longitudes. The endpoint uses a declared shorter-arc method, so your product can explain exactly what the combined positions represent.
POST /v1/astrology/composite50,000 credits per monthly allowance · no trial · no automatic overage charges. Plan details ↗
What this API provides.
Calculate shorter-arc midpoint composite planets and aspects from two birth charts. Get explicit method metadata and antipodal ambiguity warnings.
Composite zodiac signs and sign degrees
Major aspects within the calculated midpoint chart
Explicit handling of ambiguous antipodal midpoints
Send
- person1.birth and person2.birth with known local birth times
- Each person’s IANA time zone and geographic coordinates
- Optional locale for the separate symbolic reading
Receive
- method: shorter_arc_midpoint
- Composite planets and their internal aspects
- Warnings where an exact opposite pair has no unique shorter-arc midpoint
See the calculated chart.
The original renderer uses the exact positions in this example. These are computed charts, not stock diagrams. JSON remains the authoritative source.
Real input. Real output.
Precomputed by the actual calculation engine and response formatter, using synthetic example data. No purchased access or paid provider call was needed.
{
"locale": "en",
"person1": {
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
},
"person2": {
"birth": {
"date": "1992-02-10",
"time": "08:15:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
}
}{
"request_id": "ab3478a3ef8bceefccea3bf11108034c",
"api_version": "v1",
"locale": "en",
"data": {
"method": "shorter_arc_midpoint",
"planets": {
"sun": {
"longitude": 10.49969078,
"sign": "aries",
"sign_degree": 10.49969078
},
"moon": {
"longitude": 26.09712249,
"sign": "aries",
"sign_degree": 26.09712249
},
"mercury": {
"longitude": 358.95188045,
"sign": "pisces",
"sign_degree": 28.95188045
},
"venus": {
"longitude": 334.68697332,
"sign": "pisces",
"sign_degree": 4.68697332
},
"mars": {
"longitude": 323.38852218,
"sign": "aquarius",
"sign_degree": 23.38852218
},
"jupiter": {
"longitude": 131.36785809,
"sign": "leo",
"sign_degree": 11.36785809
},
"saturn": {
"longitude": 302.85757572,
"sign": "aquarius",
"sign_degree": 2.85757572
}
},
"houses": null,
"aspects": [
{
"body1": "sun",
"body2": "jupiter",
"aspect": "trine",
"angle": 120
},
{
"body1": "sun",
"body2": "uranus",
"aspect": "square",
"angle": 90
}
],
"warnings": []
},
"interpretation": {
"locale": "en",
"kind": "astrology/composite",
"disclaimer": "Symbolic reflection, not a verified prediction or professional advice.",
"coverage": {
"total_facts": 19,
"selected_facts": 19,
"omitted_count": 0,
"selection_method": "all-source-facts-v1",
"full_numeric_data_unchanged": true
},
"method": {
"engine": "celestack-original-rules-v1",
"corpus": "celestack-original-compositional-v1",
"corpus_version": "2026-11-17.2",
"fallback_locale": null,
"editorial_status": "agent-authored; independent linguistic review pending",
"predictive_validity": "symbolic interpretations are not scientifically validated predictions",
"chinese_solar_terms": "numeric calendar output only; no rule paragraphs in this corpus"
},
"items": [
{
"fact_id": "astrology/composite.planets.sun",
"title": "Midpoint composite chart · Sun · Aries",
"text": "Context: Midpoint composite chart. Sun · Aries · 10.49969° within the sign. Zodiac: tropical. Symbolic focus: self-expression and direction. Try a small direct action and leave room to listen.",
"source": {
"longitude": 10.49969078,
"sign": "aries",
"sign_degree": 10.49969078,
"id": "astrology/composite.planets.sun",
"type": "astro_placement",
"planet": "sun",
"frame": "tropical",
"at": null,
"context": [
"composite_chart"
]
}
}
]
},
"warnings": [],
"credits_used": 5
}The response preview selects whole fields and array entries for readability; no numeric values have been replaced. The full download preserves all fields, arrays and interpretation. The request_id is synthetic, and credits_used shows the configured successful-request cost; no credits were consumed.
cURL request — use your own API key and a new idempotency key
curl --request POST 'https://api.celestackapi.com/v1/astrology/composite' \
+ --header 'Authorization: Bearer YOUR_API_KEY' \
+ --header 'Content-Type: application/json' \
+ --header 'Idempotency-Key: composite-chart-api-example-001' \
+ --data '{
"locale": "en",
"person1": {
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
},
"person2": {
"birth": {
"date": "1992-02-10",
"time": "08:15:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
}
}'Example computed 2026-11-17. Full fixture manifest, engine versions and SHA-256 checksums ↗
Ways to use it.
- A midpoint chart view alongside synastry
- Developer-controlled relationship chart narratives
- A transparent alternative to an unexplained combined chart score
12 response locales
English, Ukrainian, Japanese, Spanish, French, German, Portuguese, Arabic, Italian, Hindi, Chinese and Korean.
Calculation values remain language-independent. Localized rule text is agent-authored; independent native-language review remains pending. Machine-readable field names stay stable.
Limits and interpretation.
- This is not a Davison time-space relationship chart.
- Composite houses, ascendant and midheaven are not calculated by this endpoint.
- The result is a symbolic construction, not the sky at an actual shared birth event.
Interpretive content is for symbolic reflection and entertainment. It is not a verified personal prediction or professional advice. Read the API conventions ↗
Choose your billing.
Both options include 50,000 credits per monthly allowance, resetting monthly. No trial and no automatic overage. Custom needs use a contact form.
Saved results: 7-day retention, up to 128 MiB per organization on this initial shared deployment, with a 512 MiB shared retained-result limit. Capacity can return a temporary error; there are no automatic extra charges. Production artifacts have separate retention. All usage and resource limits ↗. Checkout availability is shown in your account.
Frequently asked questions.
Which composite method is used?
The endpoint takes the midpoint along the shorter ecliptic arc for each corresponding pair of natal planets. The method is returned as shorter_arc_midpoint.
Are houses included?
No. This composite profile returns planetary midpoints and aspects. It does not invent a location, ascendant or house cusps for the midpoint construction.
What if a pair of planets is exactly opposite?
There is no unique shorter arc in that case. The ambiguous composite position is null and an explicit antipodal midpoint warning is returned.
What does access cost?
Access is USD 39.99 per month or USD 199 billed annually, with no trial. Both billing options provide 50,000 credits per monthly allowance. 5 credits per successful request or job. Daily credit, attempt, rate and resource limits apply. There are no automatic overage charges.