Synastry Cards API

POST/api/v1/western/synastrycards

Full URL

https://api.freeastroapi.com/api/v1/western/synastrycards

OpenSynastry Demo App

An open-source Next.js demo app built with this endpoint. Clone it to get started quickly.

Synastry Cards API

This endpoint is structured for mobile client consumption, optimizing for card-based user interfaces. Instead of returning the raw calculation matrix required by the standard Synastry endpoint, it shifts the computing burden to the backend. It evaluates the astrological aspects, scores the relationship across six domains, and returns pre-formatted strings and state drivers ready for immediate UI binding.

The cards endpoint supports the same sidereal settings as the main synastry routes: settings.zodiac and settings.sidereal_ayanamsa.

Context switch:Add ?relationship_context=friendship to return friendship-specific domains, friendship-safe summary copy, and friendship_synastry interpretation blocks. Minor aspect cards are excluded by default; add &include_minor_cards=true if you want semisextile, semisquare, and sesquiquadrate cards included.

Architecture & Logic

The response structure relies on a multi-pass evaluation system that categorizes mathematical aspects into human-readable data points:

Domain Drivers: Arrays indicating exactly which astrological aspect is influencing specific domains (Romance, Communication, Stability, Intimacy, Growth, Tension).
Synastry Bands: Deterministic Theme, Core, and Shadow strings derived from the interaction of the highest and lowest scoring domains.
Archetypes: The relationship is classified into one of 14 deterministic buckets based on strict scoring thresholds.

Domains & Drivers

Every aspect in the response is mapped to one or more domains. The summary.scores object gives you the aggregate score per domain (0–100), and summary.drivers_by_domain gives you the ranked list of aspect keys responsible for that score.

Default Romantic Domains

romance

Romance

Physical attraction, desire, and the quality of the passion between the two people.

communication

Communication

Mental compatibility, how they exchange ideas, argue, and understand each other.

stability

Stability

Long-term reliability and the structural groundedness of the connection.

intimacy

Intimacy

Emotional depth, vulnerability, and the degree of internal closeness.

growth

Growth

How much the relationship stretches both people philosophically and personally.

tension

Tension

The accumulated friction. Higher is not necessarily bad and indicates intensity.

Friendship Domains

social_chemistry

Social Chemistry

How naturally the two friends move into plans, shared settings, and group dynamics.

communication

Communication

How clearly they talk, interpret tone, and recover from misunderstandings.

stability

Stability

Reliability, follow through, and how easy the friendship is to maintain over time.

emotional_boundaries

Emotional Boundaries

How well both people handle privacy, sensitivity, and personal space in the friendship.

shared_growth

Shared Growth

How much the friendship opens perspective, momentum, and useful change.

tension

Tension

The accumulated friction. Higher is not necessarily bad and indicates intensity.

How Drivers Work

Each entry in drivers_by_domain is an aspect key ordered by absolute influence. The first key in the array is the primary driver. You can use these keys to cross-reference the full aspects[] array and retrieve the title, insight, and polarity of each driver for display in a breakdown view.

"drivers_by_domain": {
  "social_chemistry": ["aspect.a_venus_trine_b_mars"],
  "stability": ["angle_contact.a_uranus_trine_b_mc", "aspect.a_sun_trine_b_saturn"],
  ...
}

Synastry Bands

Always returned. The summary.bands object contains three pre-computed narrative strings. No configuration needed.

bond_toneThe overarching theme of the relationship, uniting the highest scoring domain with the tension level.

core_dynamicHow the top two positive domains interact — the functional pattern of the connection.

watch_forThe main vulnerability, derived from the weakest domain and friction level.

Request Parameters

Parameter	Type	Required	Description
person_a	Person	Yes	First person's birth data. Location requires `city` (lat/lng are optional).
person_b	Person	Yes	Second person's birth data.
settings	SynastrySettings	No	Calculation settings and inclusion flags
response_format	"full" \| "flat"	No	Default: full. Use flat for no-code platforms: returns shallow root fields plus a single text field containing the summary, scores, bands, card labels, and interpretation blocks.

relationship_context

Optional query parameter. Use romantic for the default response or friendship to switch domains, bands, archetype labels, and interpretation blocks to the friendship taxonomy.

include_minor_cards

Optional query parameter. Defaults to false. Set true to allow minor aspect cards such as semisextiles, semisquares, and sesquiquadrates into the ranked card response.

Synastry Settings (Defaults)

Parameter	Type	Required	Description
zodiac	string	No	tropical (default) or sidereal.
sidereal_ayanamsa	string	No	When zodiac is sidereal: lahiri, raman, kp, fagan_bradley, or yukteshwar.
house_system	string	No	placidus (default), whole_sign, etc.
aspect_set	string	No	major (default, 5 aspects), major_plus (+quincunx), extended (+minor)

Quick Integration

curl -X POST "https://api.freeastroapi.com/api/v1/western/synastrycards" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_KEY" \
 -d '{
    "person_a": { "datetime": "1990-05-15T14:30:00", "location": { "city": "New York, USA" }, "tz_str": "AUTO" },
    "person_b": { "datetime": "1992-08-20T09:15:00", "location": { "city": "Los Angeles, USA" }, "tz_str": "AUTO" },
    "response_format": "full",
    "settings": {
        "zodiac": "sidereal",
        "sidereal_ayanamsa": "lahiri",
        "aspect_set": "major_plus"
    }
}'

# Friendship mode
curl -X POST "https://api.freeastroapi.com/api/v1/western/synastrycards?relationship_context=friendship" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_KEY" \
 -d '{
    "person_a": { "datetime": "1990-05-15T14:30:00", "location": { "city": "New York, USA" }, "tz_str": "AUTO" },
    "person_b": { "datetime": "1992-08-20T09:15:00", "location": { "city": "Los Angeles, USA" }, "tz_str": "AUTO" },
    "response_format": "full",
    "settings": {
        "zodiac": "sidereal",
        "sidereal_ayanamsa": "lahiri",
        "aspect_set": "major_plus"
    }
}'

Ready-to-Render Response

{
  "meta": {
    "report_id": "cacb0cbd-573c-436a-acd3-77d27a641bac",
    "calculation": {
      "zodiac": "tropical",
      "house_system": "placidus"
    },
    "generated_at": "2026-02-20T11:39:12Z"
  },
  "summary": {
    "archetype": {
      "id": "long-term_anchor",
      "label": "Long-Term Anchor",
      "one_liner": "Stability and commitment guide your relationship. You instinctively think in terms of future building and shared responsibility."
    },
    "scores": {
      "overall": 53,
      "romance": 49,
      "communication": 55,
      "stability": 64,
      "intimacy": 55,
      "growth": 41,
      "tension": 39
    },
    "score_meta": {
      "tension_higher_is_more": true
    },
    "strengths": [
      "angle_contact.a_uranus_trine_b_mc",
      "aspect.a_moon_trine_b_mars",
      "aspect.a_sun_trine_b_saturn"
    ],
    "challenges": [
      "aspect.a_mars_opposition_b_jupiter",
      "aspect.a_neptune_opposition_b_mars",
      "angle_contact.a_venus_square_b_asc"
    ],
    "drivers_by_domain": {
      "romance": [
        "aspect.a_mars_opposition_b_jupiter",
        "aspect.a_neptune_opposition_b_mars",
        "aspect.a_moon_trine_b_mars"
      ],
      "communication": [
        "aspect.a_uranus_sextile_b_mercury"
      ],
      "stability": [
        "angle_contact.a_uranus_trine_b_mc",
        "aspect.a_sun_trine_b_saturn",
        "aspect.a_saturn_sextile_b_pluto"
      ],
      "intimacy": [
        "aspect.a_pluto_trine_b_mars",
        "aspect.a_saturn_sextile_b_pluto"
      ],
      "growth": [
        "aspect.a_mars_opposition_b_jupiter",
        "angle_contact.a_uranus_trine_b_mc",
        "aspect.a_uranus_square_b_jupiter"
      ],
      "tension": [
        "aspect.a_mars_opposition_b_jupiter",
        "aspect.a_neptune_opposition_b_mars",
        "aspect.a_uranus_square_b_jupiter"
      ]
    },
    "aspects_returned": 16,
    "aspects_total": 39,
    "narrative": "A Long-Term Anchor connection with balanced energy across most dimensions.",
    "bands": {
      "rules_version": "synastry_bands_v1",
      "bond_tone": "Structured Intensity",
      "core_dynamic": "Security allows emotional depth.",
      "watch_for": "Lessons repeat quietly."
    },
    "domain_states": {
      "romance": "Emerging",
      "intimacy": "Active",
      "stability": "Active",
      "communication": "Active",
      "growth": "Emerging",
      "tension": "Charged"
    }
  },
  "aspects": [
    {
      "aspect_id": "79ff150308f5",
      "key": "aspect.a_mars_opposition_b_jupiter",
      "label": "Mars Opposition Jupiter",
      "rank": 1,
      "strength": 1,
      "strength_label": "very_strong",
      "polarity": "challenging",
      "polarity_score": -0.9766,
      "abs_polarity": 0.9766,
      "domains": [
        "growth",
        "romance",
        "tension"
      ],
      "default_block": "challenging",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Eager Action Sparks Joy",
          "one_liner": "Ideas quickly become shared adventures, keeping life lively.",
          "insight": "When one suggests a new activity, both jump in eagerly. This shared enthusiasm fills days with spontaneous fun."
        },
        "challenging": {
          "title": "Rushed Plans Cause Stress",
          "one_liner": "Quick decisions can leave one partner feeling pressured.",
          "insight": "When one insists on a fast decision, the other feels overwhelmed, turning excitement into tension."
        }
      }
    },
    {
      "aspect_id": "9b4bbee1f258",
      "key": "angle_contact.a_uranus_trine_b_mc",
      "label": "Uranus Trine Midheaven",
      "rank": 2,
      "strength": 0.9737,
      "strength_label": "very_strong",
      "polarity": "supportive",
      "polarity_score": 0.9475,
      "abs_polarity": 0.9475,
      "domains": [
        "growth",
        "stability"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Embracing New Adventures",
          "one_liner": "Spontaneous plans bring excitement.",
          "insight": "When one proposes a last minute adventure, the other often joins in eagerly, making everyday life feel lively and unpredictable."
        },
        "challenging": {
          "title": "Sudden Plan Shifts",
          "one_liner": "Unexpected changes can unsettle.",
          "insight": "When one partner abruptly changes plans, it can make the other feel overlooked and uncertain about their role in shared activities."
        }
      }
    },
    {
      "aspect_id": "93d8eed7036c",
      "key": "aspect.a_neptune_opposition_b_mars",
      "label": "Neptune Opposition Mars",
      "rank": 3,
      "strength": 0.9474,
      "strength_label": "very_strong",
      "polarity": "challenging",
      "polarity_score": -0.8662,
      "abs_polarity": 0.8662,
      "domains": [
        "romance",
        "tension"
      ],
      "default_block": "challenging",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Ideas Spark Action",
          "one_liner": "One shares ideas, the other eagerly acts on them.",
          "insight": "When one partner shares a creative idea, the other quickly takes steps to make it happen. This dynamic brings excitement to their shared projects."
        },
        "challenging": {
          "title": "Different Speeds Clash",
          "one_liner": "One dreams, the other pushes forward, causing tension.",
          "insight": "As one partner dreams up possibilities, the other's urge to act can feel overwhelming, leaving the dreamer feeling rushed and misunderstood."
        }
      }
    },
    {
      "aspect_id": "db7db64a0a4c",
      "key": "aspect.a_moon_trine_b_mars",
      "label": "Moon Trine Mars",
      "rank": 4,
      "strength": 0.8947,
      "strength_label": "strong",
      "polarity": "supportive",
      "polarity_score": 0.8109,
      "abs_polarity": 0.8109,
      "domains": [
        "romance"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Emotions Fuel Actions",
          "one_liner": "One partner senses the mood while the other takes decisive steps, making daily plans feel effortless together.",
          "insight": "When discussing evening plans, if one senses the other's mood, decisions on what to do often feel seamless. This sensitivity smooths daily life."
        },
        "challenging": {
          "title": "Impulse Meets Mood",
          "one_liner": "Spontaneous decisions by one partner can clash with the other's reflective mood, leading to feelings of pressure.",
          "insight": "If one partner suddenly decides on an activity while the other is reflective, it can lead to feeling misunderstood, causing frustration or withdrawal."
        }
      }
    },
    {
      "aspect_id": "938b0c6aca55",
      "key": "aspect.a_sun_trine_b_saturn",
      "label": "Sun Trine Saturn",
      "rank": 5,
      "strength": 0.8421,
      "strength_label": "strong",
      "polarity": "supportive",
      "polarity_score": 0.7742,
      "abs_polarity": 0.7742,
      "domains": [
        "stability"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Consistency reassures",
          "one_liner": "Your steady routines offer a reliable pattern that eases daily stress and provides a sense of calm.",
          "insight": "When one partner sticks to a set schedule, like making morning coffee, both feel a comforting sense of normalcy. This reliability reduces uncertainty in daily life."
        },
        "challenging": {
          "title": "Expectations tighten",
          "one_liner": "Rigid expectations can create pressure in daily interactions, leading to feelings of constraint.",
          "insight": "When one expects tasks to be done a certain way and points it out, the other might feel constrained and undervalued, as if their efforts are not trusted."
        }
      }
    },
    {
      "aspect_id": "974a6da9e160",
      "key": "aspect.a_pluto_trine_b_mars",
      "label": "Pluto Trine Mars",
      "rank": 6,
      "strength": 0.9211,
      "strength_label": "strong",
      "polarity": "supportive",
      "polarity_score": 0.5758,
      "abs_polarity": 0.5758,
      "domains": [
        "intimacy",
        "romance"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Shared Determination Shines",
          "one_liner": "Joint projects benefit from your mutual drive.",
          "insight": "When one partner's determination kicks in, the other feels energized to keep going. This shared drive helps you both tackle tasks effectively."
        },
        "challenging": {
          "title": "Overwhelming Discussions",
          "one_liner": "Forceful talks can leave one feeling drained.",
          "insight": "When one partner pushes a topic too hard, the other feels pressured and struggles to voice their thoughts, leading to emotional fatigue."
        }
      }
    },
    {
      "aspect_id": "17065ce1ca7a",
      "key": "aspect.a_venus_trine_b_neptune",
      "label": "Venus Trine Neptune",
      "rank": 7,
      "strength": 0.7368,
      "strength_label": "moderate",
      "polarity": "supportive",
      "polarity_score": 0.6003,
      "abs_polarity": 0.6003,
      "domains": [
        "romance"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Effort effortlessly appreciated",
          "one_liner": "Small acts of kindness naturally fill your days.",
          "insight": "When one buys the other's favorite snack, it brings a quiet warmth that makes daily life more welcoming."
        },
        "challenging": {
          "title": "Unspoken needs cause tension",
          "one_liner": "Assuming unspoken needs are known can lead to feeling unseen.",
          "insight": "Expecting moods to be understood without words can leave one partner feeling invisible when it doesn't happen."
        }
      }
    },
    {
      "aspect_id": "0ab34c88ce8d",
      "key": "aspect.a_saturn_sextile_b_pluto",
      "label": "Saturn Sextile Pluto",
      "rank": 8,
      "strength": 0.7895,
      "strength_label": "moderate",
      "polarity": "supportive",
      "polarity_score": 0.4378,
      "abs_polarity": 0.4378,
      "domains": [
        "stability",
        "intimacy"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Reliable Planning",
          "one_liner": "You build a dependable framework for shared goals.",
          "insight": "During breakfast discussions, you both outline plans. This routine empowers you to tackle challenges together, creating stability."
        },
        "challenging": {
          "title": "Silent Pressure",
          "one_liner": "Unspoken expectations during work can cause tension.",
          "insight": "When one focuses intensely, the other may feel emotionally distant. This can feel isolating, as reassurance becomes rare."
        }
      }
    },
    {
      "aspect_id": "a33bc11e561b",
      "key": "angle_contact.a_venus_square_b_asc",
      "label": "Venus Square Ascendant",
      "rank": 9,
      "strength": 0.6842,
      "strength_label": "moderate",
      "polarity": "challenging",
      "polarity_score": -0.4866,
      "abs_polarity": 0.4866,
      "domains": [
        "romance"
      ],
      "default_block": "challenging",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Effort Enhances Attraction",
          "one_liner": "Appreciating each other's style boosts admiration.",
          "insight": "Complimenting each other's outfits before going out makes both feel noticed, enhancing attraction."
        },
        "challenging": {
          "title": "Clashing Social Desires",
          "one_liner": "Different social needs can cause isolation.",
          "insight": "When one stays in and the other wants to go out, the one left behind feels disconnected and unseen."
        }
      }
    },
    {
      "aspect_id": "4ad99cb0e452",
      "key": "aspect.a_venus_trine_b_uranus",
      "label": "Venus Trine Uranus",
      "rank": 10,
      "strength": 0.5263,
      "strength_label": "moderate",
      "polarity": "supportive",
      "polarity_score": 0.4822,
      "abs_polarity": 0.4822,
      "domains": [
        "romance"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Fresh Ideas Bond",
          "one_liner": "Trying new things keeps life lively.",
          "insight": "When one suggests something unconventional, the other eagerly joins in. This shared enthusiasm keeps life exciting and avoids stale routines."
        },
        "challenging": {
          "title": "Routine Tensions Arise",
          "one_liner": "Sudden changes unsettle plans.",
          "insight": "When one changes a routine without notice, it unsettles the other, causing feelings of instability and discomfort."
        }
      }
    },
    {
      "aspect_id": "d27c2d0fb78c",
      "key": "aspect.a_uranus_square_b_jupiter",
      "label": "Uranus Square Jupiter",
      "rank": 11,
      "strength": 0.6053,
      "strength_label": "moderate",
      "polarity": "challenging",
      "polarity_score": -0.4546,
      "abs_polarity": 0.4546,
      "domains": [
        "growth",
        "tension"
      ],
      "default_block": "challenging",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "New Ideas Spark Joy",
          "one_liner": "Trying new things together energizes daily life.",
          "insight": "When one suggests a new activity, both engage eagerly, turning ordinary days into exciting adventures."
        },
        "challenging": {
          "title": "Impulsivity Causes Tension",
          "one_liner": "Sudden actions can unsettle the partner seeking stability.",
          "insight": "When one makes a snap decision, the other feels unsteady, leading to frustration and unease."
        }
      }
    },
    {
      "aspect_id": "8bfb6b0d154d",
      "key": "aspect.a_neptune_square_b_jupiter",
      "label": "Neptune Square Jupiter",
      "rank": 12,
      "strength": 0.5526,
      "strength_label": "moderate",
      "polarity": "challenging",
      "polarity_score": -0.4393,
      "abs_polarity": 0.4393,
      "domains": [
        "growth"
      ],
      "default_block": "challenging",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Ideas Spark Conversations",
          "one_liner": "New ideas lead to lively exchanges.",
          "insight": "When one shares a plan, the other adds creativity. This keeps discussions fresh and engaging, breaking daily monotony."
        },
        "challenging": {
          "title": "Planning Tensions",
          "one_liner": "Different visions cause planning stress.",
          "insight": "When one imagines a different future, it can feel disheartening. This often happens when expectations clash in planning."
        }
      }
    },
    {
      "aspect_id": "8d91e143516c",
      "key": "aspect.a_jupiter_square_b_venus",
      "label": "Jupiter Square Venus",
      "rank": 13,
      "strength": 0.7105,
      "strength_label": "moderate",
      "polarity": "challenging",
      "polarity_score": -0.3449,
      "abs_polarity": 0.3449,
      "domains": [
        "growth",
        "romance"
      ],
      "default_block": "challenging",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Spontaneous Adventures",
          "one_liner": "Last minute plans spark excitement in your routine.",
          "insight": "One suggests a surprise outing, breaking the usual weekend pattern. This spontaneity brings joy and keeps things lively."
        },
        "challenging": {
          "title": "Spending Tensions",
          "one_liner": "Different spending habits lead to frustration.",
          "insight": "When one insists on splurging and the other resists, it creates tension. This clash over finances can feel isolating for both."
        }
      }
    },
    {
      "aspect_id": "2b152a678b50",
      "key": "angle_contact.a_mc_sextile_b_saturn",
      "label": "Midheaven Sextile Saturn",
      "rank": 14,
      "strength": 0.6316,
      "strength_label": "moderate",
      "polarity": "supportive",
      "polarity_score": 0.3577,
      "abs_polarity": 0.3577,
      "domains": [
        "stability"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Structure Supports Ambition",
          "one_liner": "Daily task organization builds trust and eases worries.",
          "insight": "One partner takes charge of organizing tasks, creating a dependable routine that allows both to focus on their goals without fearing missed details."
        },
        "challenging": {
          "title": "Clash Over Routine",
          "one_liner": "Consistency clashes with spontaneity, causing tension.",
          "insight": "When one insists on a strict schedule and the other suggests a sudden change, it triggers frustration and a sense of being controlled."
        }
      }
    },
    {
      "aspect_id": "ae02a88047ff",
      "key": "angle_contact.a_sun_sextile_b_asc",
      "label": "Sun Sextile Ascendant",
      "rank": 15,
      "strength": 0.5789,
      "strength_label": "moderate",
      "polarity": "supportive",
      "polarity_score": 0.3517,
      "abs_polarity": 0.3517,
      "domains": [
        "romance",
        "growth"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Easy demeanor",
          "one_liner": "Your natural ease together makes daily interactions smoother and helps you adjust plans without fuss.",
          "insight": "When you naturally tune into each other's moods, it helps you adjust plans without fuss, making shared routines more enjoyable."
        },
        "challenging": {
          "title": "At times too relaxed",
          "one_liner": "Overlooking details can lead to small misunderstandings that feel unexpectedly frustrating for both of you.",
          "insight": "When one partner forgets a commitment due to being overly relaxed, it can feel like the other is not prioritized, leading to quiet resentment."
        }
      }
    },
    {
      "aspect_id": "2f4a3b9f33ba",
      "key": "aspect.a_uranus_sextile_b_mercury",
      "label": "Uranus Sextile Mercury",
      "rank": 16,
      "strength": 0.4737,
      "strength_label": "moderate",
      "polarity": "supportive",
      "polarity_score": 0.3181,
      "abs_polarity": 0.3181,
      "domains": [
        "communication"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Ideas Spark Quickly",
          "one_liner": "Casual ideas ignite swift, logical exchanges.",
          "insight": "One mentions a wild idea, the other refines it with logic. This dynamic makes tough problems seem easy."
        },
        "challenging": {
          "title": "Clash of Thought Speeds",
          "one_liner": "Fast conclusions meet slow processing, causing tension.",
          "insight": "Quick jumps to conclusions can overwhelm, leaving the slower thinker feeling rushed and unheard."
        }
      }
    }
  ]
}

Friendship Response Example

{
  "meta": {
    "report_id": "f3bbf3e1-8dbf-4f1f-90f5-5a2a12e67e5d",
    "calculation": {
      "zodiac": "tropical",
      "house_system": "placidus"
    },
    "generated_at": "2026-02-28T12:10:00Z"
  },
  "summary": {
    "archetype": {
      "id": "rare_allies",
      "label": "Rare Allies",
      "one_liner": "A friendship with unusual durability, ease, and shared instinct."
    },
    "scores": {
      "overall": 61,
      "social_chemistry": 72,
      "communication": 58,
      "reliability": 54,
      "emotional_boundaries": 67,
      "shared_growth": 63,
      "tension": 31
    },
    "score_meta": {
      "tension_higher_is_more": true
    },
    "strengths": [
      "aspect.a_venus_trine_b_mars",
      "aspect.a_mercury_trine_b_moon"
    ],
    "challenges": [],
    "drivers_by_domain": {
      "social_chemistry": [
        "aspect.a_venus_trine_b_mars"
      ],
      "communication": [
        "aspect.a_mercury_trine_b_moon"
      ],
      "reliability": [
        "aspect.a_mercury_trine_b_moon"
      ],
      "emotional_boundaries": [
        "aspect.a_mercury_trine_b_moon"
      ],
      "shared_growth": [
        "aspect.a_venus_trine_b_mars"
      ],
      "tension": []
    },
    "aspects_returned": 2,
    "aspects_total": 2,
    "narrative": "A Rare Allies connection with balanced energy across most dimensions.",
    "bands": {
      "rules_version": "friendship_synastry_bands_v1",
      "bond_tone": "Easy Social Rhythm",
      "core_dynamic": "Shared ease makes plans and conversations start quickly.",
      "watch_for": "Important context stays implied instead of spoken."
    },
    "domain_states": {
      "social_chemistry": "Active",
      "emotional_boundaries": "Active",
      "reliability": "Emerging",
      "communication": "Active",
      "shared_growth": "Active",
      "tension": "Charged"
    }
  },
  "aspects": [
    {
      "aspect_id": "79ff150308f5",
      "key": "aspect.a_venus_trine_b_mars",
      "label": "Venus Trine Mars",
      "rank": 1,
      "strength": 1,
      "strength_label": "very_strong",
      "polarity": "supportive",
      "polarity_score": 0.819,
      "abs_polarity": 0.819,
      "domains": [
        "social_chemistry",
        "shared_growth"
      ],
      "default_block": "supportive",
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Natural Gestures",
          "one_liner": "Physical interactions create ease.",
          "insight": "When one gives a quick pat on the back, the other responds naturally. The other welcomes the gesture without hesitation. One feels acknowledged while the other feels relaxed."
        },
        "challenging": {
          "title": "Mismatched Speed",
          "one_liner": "Quick decisions clash with careful thought.",
          "insight": "When one friend makes a rapid choice, the other struggles to keep up. The other feels hurried instead of reassured. One feels impatient while the other feels pressured."
        }
      }
    }
  ]
}