Documentation Agent HTTPGenerate composite tool

Generate composite tool

POST/agent/v1/tools/generate-composite-chartAgent HTTPFrom Free

Generate relationship data for two people.

An agent-focused composite operation with a stable request shape and versioned response envelope. Valid execution that reaches calculation uses exactly one unit; pre-calculation validation and access failures use zero.

Authentication

Use Authorization: Bearer YOUR_API_KEY or X-Api-Key. Query-key authentication is deprecated compatibility behavior on supported REST routes and is rejected on Agent HTTP and MCP surfaces. Never put credentials in URLs, request bodies, or browser code.

Parameters

Name	In	Required	Description
`Idempotency-Key`	header	No	Strongly recommended stable 8–160 character key for consuming operations. Reuse it only when retrying the same request; without it, the API cannot deduplicate a lost-response retry. `hdai-example-19900515`
`Authorization`	header	Yes	Bearer API key. X-Api-Key is also supported. `Bearer YOUR_API_KEY`
`personA`	body	Yes	First birth record; birthDateTime is a local wall clock time with no Z or offset. `{"birthDateTime":"1990-05-15T14:30:00","timezone":"America/New_York"}`
`personB`	body	Yes	Second birth record; birthDateTime is a local wall clock time with no Z or offset. `{"birthDateTime":"1992-08-20T09:15:00","timezone":"Europe/London"}`

Birth times are local wall clock times.
Send the birth date and time exactly as it read on the clock where the person was born, with no Z and no UTC offset. Give the zone separately as an IANA identifier. Date=1990-05-15T14:30:00 with Timezone=America/New_York means half past two in the afternoon in New York.

Deprecated: Values ending in Z or a numeric offset are deprecated. They are still accepted for now: the API reads them as UTC and calculates from that, and the response carries Deprecation: true along with a Warning header naming this rule. They will stop being accepted, and the date will be announced in advance. Read the full rule.

Quota effect

A valid authorized execution uses exactly 1 calculation unit immediately before the calculation provider is reached. Invalid input, unresolved references, unsupported detail levels, and denied tiers use 0 units.

Errors

Expect 400 for invalid input, 401 for a missing or malformed key, 403 when the active plan does not include this operation, and 429 when the monthly allowance is exhausted.

Related operations

RequestcURL

curl -X POST "https://api.humandesign.ai/agent/v1/tools/generate-composite-chart" \
  -H "Idempotency-Key: hdai-example-19900515" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "personA": {
    "birthDateTime": "1990-05-15T14:30:00",
    "timezone": "America/New_York"
  },
  "personB": {
    "birthDateTime": "1992-08-20T09:15:00",
    "timezone": "Europe/London"
  }
}'

Verified response examplecURL

{
  "version": "v1",
  "tool": "generate_composite_chart",
  "data": {
    "person1Chart": {
      "properties": {
        "birthDateLocal": "15th May 1990 @ 14:30",
        "birthDateLocal12": "15th May 1990 @ 02:30 PM",
        "birthDateUtc": "15th May 1990 @ 18:30",
        "birthDateUtc12": "15th May 1990 @ 06:30 PM",
        "age": 36,
        "designDateUtc": "15th February 1990 @ 14:44",
        "designDateUtc12": "15th February 1990 @ 02:44 PM",
        "type": {
          "name": "Type",
          "id": "projector",
          "option": "projector",
          "description": "",
          "link": ""
        },
        "strategy": {
          "name": "Strategy",
          "id": "wait_for_the_invitation",
          "option": "wait_for_the_invitation",
          "description": "",
          "link": ""
        },
        "innerAuthority": {
          "name": "Inner Authority",
          "id": "emotional___solar_plexus",
          "option": "emotional___solar_plexus",
          "description": "",
          "link": ""
        },
        "definition": {
          "name": "Definition",
          "id": "triple_split",
          "option": "triple_split",
          "description": "",
          "link": ""
        },
        "profile": {
          "name": "Profile",
          "id": "1_3",
          "option": "1_3",
          "description": "",
          "link": ""
        }
      },
      "chartUrl": "humandesign.ai",
      "personality": {
        "sun": {
          "gate": 8,
          "line": 1,
          "color": 2,
          "tone": 1,
          "base": 1,
          "fixingState": "none",
          "sign": "gemini",
          "isRetrograde": false,
          "iChingName": "Holding Together (Pi)",
          "geneKeys": {
            "shadow": "Mediocrity",
            "gift": "Style",
            "siddhi": "Exquisiteness"
          },
          "gateKeynote": "The Gate of Contribution",
          "lineDescription": "Honesty: Contributing through authentic expression"
        },
        "earth": {
          "gate": 14,
          "line": 1,
          "color": 2,
          "tone": 1,
          "base": 1,
          "fixingState": "none",
          "sign": "scorpio",
          "isRetrograde": false,
          "iChingName": "Great Possession (Ta Yu)",
          "geneKeys": {
            "shadow": "Compromise",
            "gift": "Competence",
            "siddhi": "Bounteousness"
          },
          "gateKeynote": "The Gate of Power Skills",
          "lineDescription": "Money Isn't Everything: Values beyond material wealth"
        },
        "northNode": {
          "gate": 19,
          "line": 3,
          "color": 5,
          "tone": 5,
          "base": 4,
          "fixingState": "none",
          "sign": "aquarius",
          "isRetrograde": true,
          "iChingName": "Approach (Lin)",
          "geneKeys": {
            "shadow": "Co-Dependence",
            "gift": "Sensitivity",
            "siddhi": "Sacrifice"
          },
          "gateKeynote": "The Gate of Wanting",
          "lineDescription": "Dedication: Committed approach"
        },
        "southNode": {
          "gate": 33,
          "line": 3,
          "color": 5,
          "tone": 5,
          "base": 4,
          "fixingState": "none",
          "sign": "leo",
          "isRetrograde": true,
          "iChingName": "Retreat (Tun)",
          "geneKeys": {
            "shadow": "Forgetting",
            "gift": "Mindfulness",
            "siddhi": "Revelation"
          },
          "gateKeynote": "The Gate of Privacy",
          "lineDescription": "Spirit: Retreating with dignity"
        },
        "moon": {
          "gate": 60,
          "line": 5,
          "color": 3,
          "tone": 4,
          "base": 1,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": false,
          "iChingName": "Limitation (Chieh)",
          "geneKeys": {
            "shadow": "Limitation",
            "gift": "Realism",
            "siddhi": "Justice"
          },
          "gateKeynote": "The Gate of Acceptance",
          "lineDescription": "Leadership: Leading through limits"
        },
        "mercury": {
          "gate": 24,
          "line": 1,
          "color": 3,
          "tone": 2,
          "base": 4,
          "fixingState": "none",
          "sign": "taurus",
          "isRetrograde": true,
          "iChingName": "Return (Fu)",
          "geneKeys": {
            "shadow": "Addiction",
            "gift": "Invention",
            "siddhi": "Silence"
          },
          "gateKeynote": "The Gate of Rationalization",
          "lineDescription": "The Sin of Omission: What's left unsaid"
        },
        "uranus": {
          "gate": 58,
          "line": 6,
          "color": 4,
          "tone": 6,
          "base": 4,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": true,
          "iChingName": "The Joyous (Tui)",
          "geneKeys": {
            "shadow": "Dissatisfaction",
            "gift": "Vitality",
            "siddhi": "Bliss"
          },
          "gateKeynote": "The Gate of Vitality",
          "lineDescription": "Carried Away: Excessive joy"
        },
        "venus": {
          "gate": 21,
          "line": 4,
          "color": 6,
          "tone": 2,
          "base": 2,
          "fixingState": "none",
          "sign": "aries",
          "isRetrograde": false,
          "iChingName": "Biting Through (Shih Ho)",
          "geneKeys": {
            "shadow": "Control",
            "gift": "Authority",
            "siddhi": "Valour"
          },
          "gateKeynote": "The Gate of the Hunter/Huntress",
          "lineDescription": "Strategy: Planned control"
        },
        "mars": {
          "gate": 22,
          "line": 2,
          "color": 4,
          "tone": 5,
          "base": 5,
          "fixingState": "none",
          "sign": "pisces",
          "isRetrograde": false,
          "iChingName": "Grace (Pi)",
          "geneKeys": {
            "shadow": "Dishonour",
            "gift": "Graciousness",
            "siddhi": "Grace"
          },
          "gateKeynote": "The Gate of Openness",
          "lineDescription": "Charm School: Learned grace"
        },
        "neptune": {
          "gate": 38,
          "line": 6,
          "color": 2,
          "tone": 1,
          "base": 1,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": true,
          "iChingName": "Opposition (K'uei)",
          "geneKeys": {
            "shadow": "Struggle",
            "gift": "Perseverance",
            "siddhi": "Honour"
          },
          "gateKeynote": "The Gate of the Fighter",
          "lineDescription": "Misunderstanding: Fighting without cause"
        },
        "saturn": {
          "gate": 61,
          "line": 5,
          "color": 5,
          "tone": 5,
          "base": 4,
          "fixingState": "exalted",
          "sign": "capricorn",
          "isRetrograde": true,
          "iChingName": "Inner Truth (Chung Fu)",
          "geneKeys": {
            "shadow": "Psychosis",
            "gift": "Inspiration",
            "siddhi": "Sanctity"
          },
          "gateKeynote": "The Gate of Mystery",
          "lineDescription": "Influence: Spreading inner truth"
        },
        "jupiter": {
          "gate": 39,
          "line": 1,
          "color": 1,
          "tone": 4,
          "base": 3,
          "fixingState": "none",
          "sign": "cancer",
          "isRetrograde": false,
          "iChingName": "Obstruction (Chien)",
          "geneKeys": {
            "shadow": "Provocation",
            "gift": "Dynamism",
            "siddhi": "Liberation"
          },
          "gateKeynote": "The Gate of Provocation",
          "lineDescription": "Disengagement: Strategic withdrawal"
        }
      },
      "design": {
        "sun": {
          "gate": 30,
          "line": 3,
          "color": 2,
          "tone": 5,
          "base": 5,
          "fixingState": "none",
          "sign": "aquarius",
          "isRetrograde": false,
          "iChingName": "Clinging Fire (Li)",
          "geneKeys": {
            "shadow": "Desire",
            "gift": "Lightness",
            "siddhi": "Rapture"
          },
          "gateKeynote": "The Gate of Feelings",
          "lineDescription": "Resignation: Accepting feelings"
        },
        "earth": {
          "gate": 29,
          "line": 3,
          "color": 2,
          "tone": 5,
          "base": 5,
          "fixingState": "none",
          "sign": "leo",
          "isRetrograde": false,
          "iChingName": "The Abysmal (K'an)",
          "geneKeys": {
            "shadow": "Half-Heartedness",
            "gift": "Commitment",
            "siddhi": "Devotion"
          },
          "gateKeynote": "The Gate of Saying Yes",
          "lineDescription": "Evaluation: Ongoing assessment"
        },
        "northNode": {
          "gate": 13,
          "line": 4,
          "color": 3,
          "tone": 2,
          "base": 3,
          "fixingState": "none",
          "sign": "aquarius",
          "isRetrograde": true,
          "iChingName": "Fellowship with Men (T'ung Jen)",
          "geneKeys": {
            "shadow": "Discord",
            "gift": "Discernment",
            "siddhi": "Empathy"
          },
          "gateKeynote": "The Gate of the Listener",
          "lineDescription": "Fatigue: Exhaustion from listening"
        },
        "southNode": {
          "gate": 7,
          "line": 4,
          "color": 3,
          "tone": 2,
          "base": 3,
          "fixingState": "none",
          "sign": "leo",
          "isRetrograde": true,
          "iChingName": "The Army (Shih)",
          "geneKeys": {
            "shadow": "Division",
            "gift": "Guidance",
            "siddhi": "Virtue"
          },
          "gateKeynote": "The Gate of the Role of the Self",
          "lineDescription": "The Abdicator: Stepping aside from leadership"
        },
        "moon": {
          "gate": 28,
          "line": 2,
          "color": 1,
          "tone": 5,
          "base": 5,
          "fixingState": "none",
          "sign": "scorpio",
          "isRetrograde": false,
          "iChingName": "Great Excess (Ta Kuo)",
          "geneKeys": {
            "shadow": "Purposelessness",
            "gift": "Totality",
            "siddhi": "Immortality"
          },
          "gateKeynote": "The Gate of the Game Player",
          "lineDescription": "Shaking Hands with the Devil: Confronting fear"
        },
        "mercury": {
          "gate": 41,
          "line": 4,
          "color": 1,
          "tone": 5,
          "base": 4,
          "fixingState": "none",
          "sign": "aquarius",
          "isRetrograde": false,
          "iChingName": "Decrease (Sun)",
          "geneKeys": {
            "shadow": "Fantasy",
            "gift": "Anticipation",
            "siddhi": "Emanation"
          },
          "gateKeynote": "The Gate of Contraction",
          "lineDescription": "Correction: Adjusting expectations"
        },
        "uranus": {
          "gate": 58,
          "line": 5,
          "color": 4,
          "tone": 6,
          "base": 3,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": false,
          "iChingName": "The Joyous (Tui)",
          "geneKeys": {
            "shadow": "Dissatisfaction",
            "gift": "Vitality",
            "siddhi": "Bliss"
          },
          "gateKeynote": "The Gate of Vitality",
          "lineDescription": "Defense: Protecting vitality"
        },
        "venus": {
          "gate": 61,
          "line": 2,
          "color": 2,
          "tone": 4,
          "base": 3,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": false,
          "iChingName": "Inner Truth (Chung Fu)",
          "geneKeys": {
            "shadow": "Psychosis",
            "gift": "Inspiration",
            "siddhi": "Sanctity"
          },
          "gateKeynote": "The Gate of Mystery",
          "lineDescription": "Natural Brilliance: Innate knowing"
        },
        "mars": {
          "gate": 38,
          "line": 4,
          "color": 1,
          "tone": 1,
          "base": 5,
          "fixingState": "detriment",
          "sign": "capricorn",
          "isRetrograde": false,
          "iChingName": "Opposition (K'uei)",
          "geneKeys": {
            "shadow": "Struggle",
            "gift": "Perseverance",
            "siddhi": "Honour"
          },
          "gateKeynote": "The Gate of the Fighter",
          "lineDescription": "Investigation: Understanding opposition"
        },
        "neptune": {
          "gate": 38,
          "line": 5,
          "color": 3,
          "tone": 3,
          "base": 3,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": false,
          "iChingName": "Opposition (K'uei)",
          "geneKeys": {
            "shadow": "Struggle",
            "gift": "Perseverance",
            "siddhi": "Honour"
          },
          "gateKeynote": "The Gate of the Fighter",
          "lineDescription": "Alienation: Standing alone"
        },
        "saturn": {
          "gate": 61,
          "line": 1,
          "color": 1,
          "tone": 3,
          "base": 1,
          "fixingState": "detriment",
          "sign": "capricorn",
          "isRetrograde": false,
          "iChingName": "Inner Truth (Chung Fu)",
          "geneKeys": {
            "shadow": "Psychosis",
            "gift": "Inspiration",
            "siddhi": "Sanctity"
          },
          "gateKeynote": "The Gate of Mystery",
          "lineDescription": "Occult Knowledge: Hidden truths"
        },
        "jupiter": {
          "gate": 15,
          "line": 3,
          "color": 6,
          "tone": 2,
          "base": 4,
          "fixingState": "none",
          "sign": "cancer",
          "isRetrograde": true,
          "iChingName": "Modesty (Ch'ien)",
          "geneKeys": {
            "shadow": "Dullness",
            "gift": "Magnetism",
            "siddhi": "Florescence"
          },
          "gateKeynote": "The Gate of Extremes",
          "lineDescription": "Self-Inflation: False modesty"
        }
      },
      "definedCenters": [
        "root",
        "solar_plexus"
      ],
      "openCenters": [
        "sacral",
        "heart"
      ],
      "channels": [
        "1-8",
        "13-33"
      ],
      "gates": [
        1,
        7
      ],
      "gatesByCategory": {
        "definedGates": [
          1,
          8
        ],
        "hangingOpen": [
          14,
          21
        ],
        "hangingClosed": [
          7,
          15
        ],
        "openGates": [
          2,
          3
        ]
      },
      "planets": [
        {
          "id": "Sun",
          "option": "Sun",
          "description": ""
        },
        {
          "id": "Moon",
          "option": "Moon",
          "description": ""
        }
      ],
      "variables": {
        "digestion": "right",
        "environment": "left",
        "awareness": "left",
        "perspective": "right"
      },
      "tooltips": {
        "centers": [
          {
            "id": "Root",
            "option": "Root",
            "description": ""
          },
          {
            "id": "Sacral",
            "option": "Sacral",
            "description": ""
          }
        ],
        "channels": [
          {
            "id": "1 - 8",
            "option": "1 - 8",
            "description": ""
          },
          {
            "id": "2 - 14",
            "option": "2 - 14",
            "description": ""
          }
        ]
      }
    },
    "person2Chart": {
      "properties": {
        "birthDateLocal": "20th August 1992 @ 09:15",
        "birthDateLocal12": "20th August 1992 @ 09:15 AM",
        "birthDateUtc": "20th August 1992 @ 08:15",
        "birthDateUtc12": "20th August 1992 @ 08:15 AM",
        "age": 33,
        "designDateUtc": "20th May 1992 @ 08:05",
        "designDateUtc12": "20th May 1992 @ 08:05 AM",
        "type": {
          "name": "Type",
          "id": "manifesting_generator",
          "option": "manifesting_generator",
          "description": "",
          "link": ""
        },
        "strategy": {
          "name": "Strategy",
          "id": "to_respond_&_inform",
          "option": "to_respond_&_inform",
          "description": "",
          "link": ""
        },
        "innerAuthority": {
          "name": "Inner Authority",
          "id": "sacral",
          "option": "sacral",
          "description": "",
          "link": ""
        },
        "definition": {
          "name": "Definition",
          "id": "single_definition",
          "option": "single_definition",
          "description": "",
          "link": ""
        },
        "profile": {
          "name": "Profile",
          "id": "4_6",
          "option": "4_6",
          "description": "",
          "link": ""
        }
      },
      "chartUrl": "humandesign.ai",
      "personality": {
        "sun": {
          "gate": 29,
          "line": 4,
          "color": 2,
          "tone": 4,
          "base": 2,
          "fixingState": "none",
          "sign": "leo",
          "isRetrograde": false,
          "iChingName": "The Abysmal (K'an)",
          "geneKeys": {
            "shadow": "Half-Heartedness",
            "gift": "Commitment",
            "siddhi": "Devotion"
          },
          "gateKeynote": "The Gate of Saying Yes",
          "lineDescription": "Directness: Clear commitment"
        },
        "earth": {
          "gate": 30,
          "line": 4,
          "color": 2,
          "tone": 4,
          "base": 2,
          "fixingState": "none",
          "sign": "aquarius",
          "isRetrograde": false,
          "iChingName": "Clinging Fire (Li)",
          "geneKeys": {
            "shadow": "Desire",
            "gift": "Lightness",
            "siddhi": "Rapture"
          },
          "gateKeynote": "The Gate of Feelings",
          "lineDescription": "Burnout: Emotional exhaustion"
        },
        "northNode": {
          "gate": 10,
          "line": 1,
          "color": 3,
          "tone": 6,
          "base": 2,
          "fixingState": "none",
          "sign": "sagittarius",
          "isRetrograde": true,
          "iChingName": "Treading (Lu)",
          "geneKeys": {
            "shadow": "Self-Obsession",
            "gift": "Naturalness",
            "siddhi": "Being"
          },
          "gateKeynote": "The Gate of the Behavior of the Self",
          "lineDescription": "Modesty: Humble self-expression"
        },
        "southNode": {
          "gate": 15,
          "line": 1,
          "color": 3,
          "tone": 6,
          "base": 2,
          "fixingState": "none",
          "sign": "cancer",
          "isRetrograde": true,
          "iChingName": "Modesty (Ch'ien)",
          "geneKeys": {
            "shadow": "Dullness",
            "gift": "Magnetism",
            "siddhi": "Florescence"
          },
          "gateKeynote": "The Gate of Extremes",
          "lineDescription": "Duty: Humble service"
        },
        "moon": {
          "gate": 2,
          "line": 2,
          "color": 4,
          "tone": 3,
          "base": 4,
          "fixingState": "none",
          "sign": "taurus",
          "isRetrograde": false,
          "iChingName": "The Receptive (K'un)",
          "geneKeys": {
            "shadow": "Dislocation",
            "gift": "Orientation",
            "siddhi": "Unity"
          },
          "gateKeynote": "The Gate of the Direction of the Self",
          "lineDescription": "Genius: Natural receptivity that attracts resources"
        },
        "mercury": {
          "gate": 33,
          "line": 2,
          "color": 4,
          "tone": 4,
          "base": 1,
          "fixingState": "none",
          "sign": "leo",
          "isRetrograde": false,
          "iChingName": "Retreat (Tun)",
          "geneKeys": {
            "shadow": "Forgetting",
            "gift": "Mindfulness",
            "siddhi": "Revelation"
          },
          "gateKeynote": "The Gate of Privacy",
          "lineDescription": "Surrender: Accepting retreat"
        },
        "uranus": {
          "gate": 38,
          "line": 6,
          "color": 2,
          "tone": 6,
          "base": 5,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": true,
          "iChingName": "Opposition (K'uei)",
          "geneKeys": {
            "shadow": "Struggle",
            "gift": "Perseverance",
            "siddhi": "Honour"
          },
          "gateKeynote": "The Gate of the Fighter",
          "lineDescription": "Misunderstanding: Fighting without cause"
        },
        "venus": {
          "gate": 64,
          "line": 6,
          "color": 1,
          "tone": 1,
          "base": 4,
          "fixingState": "detriment",
          "sign": "virgo",
          "isRetrograde": false,
          "iChingName": "Before Completion (Wei Chi)",
          "geneKeys": {
            "shadow": "Confusion",
            "gift": "Imagination",
            "siddhi": "Illumination"
          },
          "gateKeynote": "The Gate of Confusion",
          "lineDescription": "Victory: Overcoming confusion"
        },
        "mars": {
          "gate": 35,
          "line": 6,
          "color": 1,
          "tone": 5,
          "base": 1,
          "fixingState": "detriment",
          "sign": "gemini",
          "isRetrograde": false,
          "iChingName": "Progress (Chin)",
          "geneKeys": {
            "shadow": "Hunger",
            "gift": "Adventure",
            "siddhi": "Boundlessness"
          },
          "gateKeynote": "The Gate of Change",
          "lineDescription": "Rectification: Correcting course"
        },
        "neptune": {
          "gate": 54,
          "line": 2,
          "color": 4,
          "tone": 2,
          "base": 1,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": true,
          "iChingName": "The Marrying Maiden (Kuei Mei)",
          "geneKeys": {
            "shadow": "Greed",
            "gift": "Aspiration",
            "siddhi": "Ascension"
          },
          "gateKeynote": "The Gate of Ambition",
          "lineDescription": "Discretion: Strategic ambition"
        },
        "saturn": {
          "gate": 13,
          "line": 1,
          "color": 6,
          "tone": 6,
          "base": 5,
          "fixingState": "none",
          "sign": "aquarius",
          "isRetrograde": true,
          "iChingName": "Fellowship with Men (T'ung Jen)",
          "geneKeys": {
            "shadow": "Discord",
            "gift": "Discernment",
            "siddhi": "Empathy"
          },
          "gateKeynote": "The Gate of the Listener",
          "lineDescription": "Empathy: Listening with understanding"
        },
        "jupiter": {
          "gate": 47,
          "line": 3,
          "color": 2,
          "tone": 1,
          "base": 1,
          "fixingState": "exalted",
          "sign": "virgo",
          "isRetrograde": false,
          "iChingName": "Oppression (K'un)",
          "geneKeys": {
            "shadow": "Oppression",
            "gift": "Transmutation",
            "siddhi": "Transfiguration"
          },
          "gateKeynote": "The Gate of Realization",
          "lineDescription": "Self-Oppression: Mental burden"
        }
      },
      "design": {
        "sun": {
          "gate": 8,
          "line": 6,
          "color": 3,
          "tone": 3,
          "base": 1,
          "fixingState": "none",
          "sign": "gemini",
          "isRetrograde": false,
          "iChingName": "Holding Together (Pi)",
          "geneKeys": {
            "shadow": "Mediocrity",
            "gift": "Style",
            "siddhi": "Exquisiteness"
          },
          "gateKeynote": "The Gate of Contribution",
          "lineDescription": "Communion: Contributing through connection"
        },
        "earth": {
          "gate": 14,
          "line": 6,
          "color": 3,
          "tone": 3,
          "base": 1,
          "fixingState": "detriment",
          "sign": "scorpio",
          "isRetrograde": false,
          "iChingName": "Great Possession (Ta Yu)",
          "geneKeys": {
            "shadow": "Compromise",
            "gift": "Competence",
            "siddhi": "Bounteousness"
          },
          "gateKeynote": "The Gate of Power Skills",
          "lineDescription": "Humility: Power through modesty"
        },
        "northNode": {
          "gate": 10,
          "line": 3,
          "color": 5,
          "tone": 6,
          "base": 5,
          "fixingState": "none",
          "sign": "sagittarius",
          "isRetrograde": true,
          "iChingName": "Treading (Lu)",
          "geneKeys": {
            "shadow": "Self-Obsession",
            "gift": "Naturalness",
            "siddhi": "Being"
          },
          "gateKeynote": "The Gate of the Behavior of the Self",
          "lineDescription": "The Martyr: Self-sacrifice"
        },
        "southNode": {
          "gate": 15,
          "line": 3,
          "color": 5,
          "tone": 6,
          "base": 5,
          "fixingState": "none",
          "sign": "cancer",
          "isRetrograde": true,
          "iChingName": "Modesty (Ch'ien)",
          "geneKeys": {
            "shadow": "Dullness",
            "gift": "Magnetism",
            "siddhi": "Florescence"
          },
          "gateKeynote": "The Gate of Extremes",
          "lineDescription": "Self-Inflation: False modesty"
        },
        "moon": {
          "gate": 38,
          "line": 3,
          "color": 6,
          "tone": 1,
          "base": 4,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": false,
          "iChingName": "Opposition (K'uei)",
          "geneKeys": {
            "shadow": "Struggle",
            "gift": "Perseverance",
            "siddhi": "Honour"
          },
          "gateKeynote": "The Gate of the Fighter",
          "lineDescription": "Alliance: Fighting together"
        },
        "mercury": {
          "gate": 2,
          "line": 4,
          "color": 4,
          "tone": 1,
          "base": 2,
          "fixingState": "none",
          "sign": "taurus",
          "isRetrograde": false,
          "iChingName": "The Receptive (K'un)",
          "geneKeys": {
            "shadow": "Dislocation",
            "gift": "Orientation",
            "siddhi": "Unity"
          },
          "gateKeynote": "The Gate of the Direction of the Self",
          "lineDescription": "Secretiveness: Protecting received wisdom until timing is right"
        },
        "uranus": {
          "gate": 54,
          "line": 3,
          "color": 5,
          "tone": 3,
          "base": 3,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": true,
          "iChingName": "The Marrying Maiden (Kuei Mei)",
          "geneKeys": {
            "shadow": "Greed",
            "gift": "Aspiration",
            "siddhi": "Ascension"
          },
          "gateKeynote": "The Gate of Ambition",
          "lineDescription": "Covert Operations: Hidden ambition"
        },
        "venus": {
          "gate": 23,
          "line": 5,
          "color": 3,
          "tone": 2,
          "base": 3,
          "fixingState": "none",
          "sign": "taurus",
          "isRetrograde": false,
          "iChingName": "Splitting Apart (Po)",
          "geneKeys": {
            "shadow": "Complexity",
            "gift": "Simplicity",
            "siddhi": "Quintessence"
          },
          "gateKeynote": "The Gate of Assimilation",
          "lineDescription": "Assimilation: Integrating insights"
        },
        "mars": {
          "gate": 21,
          "line": 2,
          "color": 4,
          "tone": 5,
          "base": 3,
          "fixingState": "exalted",
          "sign": "aries",
          "isRetrograde": false,
          "iChingName": "Biting Through (Shih Ho)",
          "geneKeys": {
            "shadow": "Control",
            "gift": "Authority",
            "siddhi": "Valour"
          },
          "gateKeynote": "The Gate of the Hunter/Huntress",
          "lineDescription": "Might is Right: Forceful control"
        },
        "neptune": {
          "gate": 54,
          "line": 4,
          "color": 6,
          "tone": 1,
          "base": 1,
          "fixingState": "none",
          "sign": "capricorn",
          "isRetrograde": true,
          "iChingName": "The Marrying Maiden (Kuei Mei)",
          "geneKeys": {
            "shadow": "Greed",
            "gift": "Aspiration",
            "siddhi": "Ascension"
          },
          "gateKeynote": "The Gate of Ambition",
          "lineDescription": "Enlightenment/Endarkenment: Ambition's dual nature"
        },
        "saturn": {
          "gate": 13,
          "line": 6,
          "color": 4,
          "tone": 2,
          "base": 1,
          "fixingState": "detriment",
          "sign": "aquarius",
          "isRetrograde": false,
          "iChingName": "Fellowship with Men (T'ung Jen)",
          "geneKeys": {
            "shadow": "Discord",
            "gift": "Discernment",
            "siddhi": "Empathy"
          },
          "gateKeynote": "The Gate of the Listener",
          "lineDescription": "The Optimist: Listening for the positive"
        },
        "jupiter": {
          "gate": 59,
          "line": 6,
          "color": 3,
          "tone": 4,
          "base": 1,
          "fixingState": "none",
          "sign": "virgo",
          "isRetrograde": false,
          "iChingName": "Dispersion (Huan)",
          "geneKeys": {
            "shadow": "Dishonesty",
            "gift": "Intimacy",
            "siddhi": "Transparency"
          },
          "gateKeynote": "The Gate of Sexuality",
          "lineDescription": "The One Night Stand: Brief intimacy"
        }
      },
      "definedCenters": [
        "sacral",
        "g"
      ],
      "openCenters": [
        "root",
        "solar_plexus"
      ],
      "channels": [
        "2-14",
        "13-33"
      ],
      "gates": [
        2,
        8
      ],
      "gatesByCategory": {
        "definedGates": [
          2,
          13
        ],
        "hangingOpen": [
          21,
          30
        ],
        "hangingClosed": [
          8,
          10
        ],
        "openGates": [
          1,
          3
        ]
      },
      "planets": [
        {
          "id": "Sun",
          "option": "Sun",
          "description": ""
        },
        {
          "id": "Moon",
          "option": "Moon",
          "description": ""
        }
      ],
      "variables": {
        "digestion": "left",
        "environment": "right",
        "awareness": "right",
        "perspective": "right"
      },
      "tooltips": {
        "centers": [
          {
            "id": "Root",
            "option": "Root",
            "description": ""
          },
          {
            "id": "Sacral",
            "option": "Sacral",
            "description": ""
          }
        ],
        "channels": [
          {
            "id": "1 - 8",
            "option": "1 - 8",
            "description": ""
          },
          {
            "id": "2 - 14",
            "option": "2 - 14",
            "description": ""
          }
        ]
      }
    },
    "compositeChart": {
      "definedCenters": [
        "Root center",
        "Sacral center"
      ],
      "openCenters": [
        "Heart center"
      ],
      "consciousCenters": [],
      "unconsciousCenters": [],
      "definition": {
        "name": "Definition",
        "id": "Split Definition",
        "option": "Split Definition",
        "description": "",
        "link": ""
      },
      "connectionTheme": {
        "themeDescription": "With 8 defined centers and 1 open center, this is a very stable and self-contained connection. The one open center creates a specific area where growth and learning can occur together. Balance independence with focused sharing around this open center.",
        "definedCount": 8,
        "openCount": 1,
        "name": "Connection Theme",
        "id": "8 - 1, Almost Complete",
        "option": "8 - 1, Almost Complete",
        "description": "",
        "link": ""
      }
    },
    "relationshipAnalysis": {
      "electromagneticChannels": {
        "name": "Electromagnetic Channels",
        "id": "electromagnetic",
        "description": "The strongest attraction - each person contributes one gate to complete the channel",
        "count": 0,
        "channels": []
      },
      "companionshipChannels": {
        "name": "Companionship Channels",
        "id": "companionship",
        "description": "Shared definition - both people have both gates, creating familiarity and comfort",
        "count": 1,
        "channels": [
          {
            "channelName": "Channel of The Prodigal",
            "description": "The prodigal returning with wisdom",
            "gate1": 13,
            "gate2": 33,
            "gate1ActivatedBy": "Both",
            "gate2ActivatedBy": "Both",
            "activationType": "Companion",
            "center1": "G",
            "center2": "Throat"
          }
        ]
      },
      "dominanceChannels": {
        "name": "Dominance Channels",
        "id": "dominance",
        "description": "One person's full channel meets the other's partial activation - potential power dynamics",
        "count": 3,
        "channels": [
          {
            "channelName": "Channel of Structuring",
            "description": "Insight expressed as structure",
            "gate1": 23,
            "gate2": 43,
            "gate1ActivatedBy": "Person2",
            "gate2ActivatedBy": "Person2",
            "activationType": "SecondDominating",
            "center1": "Throat",
            "center2": "Ajna"
          },
          {
            "channelName": "Channel of Awareness",
            "description": "Awareness through mental pressure",
            "gate1": 24,
            "gate2": 61,
            "gate1ActivatedBy": "Person1",
            "gate2ActivatedBy": "Person1",
            "activationType": "FirstDominating",
            "center1": "Ajna",
            "center2": "Head"
          }
        ]
      },
      "compromiseChannels": {
        "name": "Compromise Channels",
        "id": "compromise",
        "description": "Both have activation but neither dominates - requires conscious negotiation",
        "count": 4,
        "channels": [
          {
            "channelName": "Channel of Inspiration",
            "description": "Creative self-expression and individual contribution",
            "gate1": 1,
            "gate2": 8,
            "gate1ActivatedBy": "Person1",
            "gate2ActivatedBy": "Both",
            "activationType": "CompromiseFirstDominating",
            "center1": "G",
            "center2": "Throat"
          },
          {
            "channelName": "Channel of The Beat",
            "description": "Direction and empowerment through response",
            "gate1": 2,
            "gate2": 14,
            "gate1ActivatedBy": "Person2",
            "gate2ActivatedBy": "Both",
            "activationType": "CompromiseSecondDominating",
            "center1": "G",
            "center2": "Sacral"
          }
        ]
      },
      "gateComparison": {
        "sharedGates": [
          8,
          13
        ],
        "person1UniqueGates": [
          1,
          7
        ],
        "person2UniqueGates": [
          2,
          10
        ],
        "complementaryPairs": []
      }
    },
    "chemistry": {
      "overallScore": 25,
      "attractionScore": 10,
      "stabilityScore": 30,
      "challengeScore": 0,
      "growthScore": 60,
      "strengths": [
        "Deep familiarity and comfort from 1 shared channel(s)",
        "Strong resonance with 9 shared gates"
      ],
      "challenges": [
        "Potential power dynamics from 3 dominance channel(s) - awareness needed",
        "4 compromise channel(s) require conscious negotiation"
      ],
      "growthOpportunities": [
        "Rich growth potential through 20 unique gates between you"
      ]
    }
  },
  "meta": {
    "surface": "agent_http",
    "operation": "generate_composite_chart",
    "requiredTier": "creator",
    "tool": {
      "chartVersion": "v2"
    }
  },
  "error": null
}

Captured from the live API on 6 August 2026. 43/43 live checks passed. Secrets and account-specific usage are removed; large payloads show a truthful excerpt.

Free includes 100 calls every month.
Free members can use every operation labelled “From Free,” including the core Agent HTTP and MCP tools.