{"openapi":"3.1.0","info":{"title":"Convrgent API — KYH (Know Your Human) + BLAH (Be Like A Human) + KYB (Know Your Buyer)","version":"1.0.0","description":"Personality intelligence (KYH), communication intelligence (BLAH), and buyer intelligence (KYB) for AI agents. KYH analyzes humans via 11 frameworks — Western astrology, Human Design, Chinese astrology, Vedic astrology, numerology, communication style, 12 psych dimensions, socionics, 16 Personality Types, Enneagram, and cross-system convergence. BLAH tells agents how to talk to humans — adaptation, response coaching, and de-escalation. KYB turns personality data into sales intelligence — buyer profiling, pitch generation, objection prediction, price psychology, content strategy, cultural adaptation, and buying committee mapping. Pay per request with USDC on Base or Solana via x402.","contact":{"name":"Convrgent","url":"https://convrgent.ai"},"x-guidance":"3 products, pick what you need: KYH (personality analysis — start with /api/kyh/mbti for typing or /api/kyh/portrait for full profile), BLAH (communication coaching — /api/blah/adapt for tone, /api/blah/respond for reply drafts), KYB (sales intelligence — /api/kyb/profile for buyer type, /api/kyb/pitch for personalized pitch). Most agents need just 1-3 endpoints. Use /api/kyh/convergence ($5) only after running 2+ individual frameworks."},"servers":[{"url":"https://convrgent.ai"}],"paths":{"/api/kyh/communication":{"post":{"operationId":"analyzeCommStyle","summary":"Communication style profiler","description":"Analyze tone, directness, formality, persuasion triggers, trust signals, and writing style. Returns guidance on how to communicate with this person.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.05","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"string"},"minItems":1},"observations":{"type":"object"},"natal":{"type":"object"},"context":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"tone":"analytical-warm","directness":0.7,"formality":0.6,"persuasionTriggers":["data","logic","empathy"],"trustSignals":["consistency","acknowledgment"],"communicationGuidance":"Lead with data, acknowledge emotions..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/natal-chart":{"post":{"operationId":"getNatalChart","summary":"Natal chart and astrological profile","description":"Compute full natal chart from birth data — Sun/Moon/Rising signs, all planets, houses, aspects, element/modality profile, and personality interpretation.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"chart":{"sunSign":"Gemini","moonSign":"Scorpio","risingSign":"Libra"},"interpretation":{"coreIdentity":"...","emotionalLandscape":"...","communicationStyle":"..."},"agent_prompt":"# Personality Profile — New York, NY\n## Core Identity\nGemini Sun..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/psych":{"post":{"operationId":"psychProfile","summary":"12 psychological dimensions","description":"Measure 12 personality dimensions including openness, conscientiousness, risk tolerance, conflict style, and more via text analysis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"natal":{"type":"object"},"demographics":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"dimensions":{"openness":{"score":0.82,"confidence":0.75},"conscientiousness":{"score":0.71,"confidence":0.7}},"cluster":"analytical-explorer","confidence":0.72}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/socionics":{"post":{"operationId":"socionicsType","summary":"Socionics cognitive typing","description":"Determine Socionics type (16 types), cognitive function strengths, and intertype relations (dual, mirror, conflict, etc.).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"responses":{"type":"object"},"observations":{"type":"object"},"natal":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"type":"LII","confidence":0.78,"cognitiveFunctions":{"Ne":0.75,"Ti":0.85,"Se":0.3,"Fi":0.55},"intertypeRelations":{"dual":"ESE","mirror":"ILE","conflict":"SEE"}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/mbti":{"post":{"operationId":"mbtiType","summary":"16 Personality Types assessment","description":"Determine cognitive personality type from text analysis — type, cognitive functions, dichotomy scores, and confidence.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text_samples":{"type":"array","items":{"type":"string"},"minItems":1},"observations":{"type":"object"},"natal_chart":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"type":"INTJ","nickname":"The Architect","scores":{"EI":-0.72,"SN":0.81,"TF":-0.65,"JP":-0.58},"confidence":0.82,"cognitive_functions":["Ni","Te","Fi","Se"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/human-design":{"post":{"operationId":"humanDesign","summary":"Human Design bodygraph","description":"Compute Human Design chart — type, strategy, authority, profile, defined/undefined centers, channels, and gates.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"birth_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","example":"14:30","description":"Highly recommended. Defaults to 12:00 if omitted — type and profile may be inaccurate."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override"},"longitude":{"type":"number","example":-74.006,"description":"Optional override"},"timezone":{"type":"number","example":-5,"description":"Optional — auto-resolved from location"}},"required":["birth_date","location"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"type":"Generator","strategy":"Wait to Respond","authority":"Sacral","profile":"3/5"}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/numerology":{"post":{"operationId":"numerologyProfile","summary":"Numerology profile","description":"Calculate numerology profile — Life Path, Birthday Number, Personal Year/Month, Expression, Soul Urge, Personality, karmic debts. Birth date required, name(s) for full analysis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.25","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"legalName":{"type":"string","example":"John Michael Smith"},"commonName":{"type":"string","example":"John Smith"}},"required":["birth_date"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"lifePath":6,"birthdayNumber":15,"personalYear":3,"pythagorean":{"expression":7,"soulUrge":3,"personality":4}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/chinese-astrology":{"post":{"operationId":"chineseAstrology","summary":"Chinese Astrology / BaZi","description":"Calculate Chinese zodiac, Four Pillars of Destiny, Day Master, element balance, Ten Gods, animal compatibility. Birth date required, time for full BaZi.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"birth_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","example":"14:30"},"location":{"type":"string","example":"New York, NY"},"yearStart":{"type":"string","enum":["cny","lichun"]}},"required":["birth_date"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"zodiac":{"animal":"horse","element":"metal","polarity":"yang"},"fourPillars":{"dayMaster":{"element":"fire"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/vedic":{"post":{"operationId":"vedicChart","summary":"Vedic Astrology (Jyotish) chart","description":"Calculate sidereal natal chart with Nakshatras, Vimshottari Dasha periods, planetary dignities, Yogas, Vedic aspects. Requires birth date, time, and location.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"birth_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","example":"14:30"},"location":{"type":"string","example":"New York, NY"},"ayanamsa":{"type":"string","enum":["lahiri","krishnamurti","raman"]}},"required":["birth_date","birth_time","location"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"lagna":{"sign":"Tula"},"moonNakshatra":{"name":"Jyeshtha"},"dashas":{"currentMahadasha":{"planet":"Saturn"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/enneagram":{"post":{"operationId":"enneagramType","summary":"Enneagram personality typing","description":"Determine Enneagram type (1-9) with wing, tritype, integration/disintegration dynamics, and instinctual stack via multi-signal inference.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"responses":{"type":"object","description":"Questionnaire answers"},"observations":{"type":"object"},"natal":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"typing":{"primaryType":{"type":5,"name":"The Investigator","confidence":0.78}},"agentGuidance":"Respect their need for privacy..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/convergence":{"post":{"operationId":"convergenceAnalysis","summary":"Cross-system personality convergence","description":"Synthesize 2+ framework outputs into unified canonical traits, agreements, tensions, and unique insights. Optional LLM narrative synthesis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"frameworks":{"type":"object","description":"Framework outputs from other KYH endpoints (min 2)"},"summary":{"type":"boolean","description":"Include LLM-synthesized narrative"}},"required":["frameworks"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"traits":[{"id":"introversion","value":0.72,"agreementLevel":"strong"}],"coreIdentity":{"summary":"Analytical thinker with strong intuition..."}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/portrait":{"post":{"operationId":"fullPortrait","summary":"Full personality portrait (HUMAN.md)","description":"Comprehensive 11-framework personality synthesis — all available engines combined into a single portrait with HUMAN.md, agent prompt, and convergence analysis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$5.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"},"context":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"humanMd":"# HUMAN.md — Personality Portrait\n## Core Identity\n...","synthesis":"...","agentPrompt":"..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/agent-prompt":{"post":{"operationId":"agentPrompt","summary":"Agent adaptation prompt","description":"Generate a system prompt for AI agents that adapts interaction style to this person's personality, communication preferences, and cognitive patterns.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"},"context":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"systemPrompt":"You are speaking with someone who values analytical depth...","confidence":0.8,"frameworksUsed":["natal-chart","communication","psych"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/micro":{"post":{"operationId":"microQuery","summary":"Quick personality micro-query","description":"Fast single-dimension personality queries — communication style, single psych dimension, socionics dimension, trust level, autonomy preference, or cultural context.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.02","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","enum":["communication_style","single_psych_dimension","socionics_dimension","trust_level","autonomy_preference","cultural_context"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"dimension":{"type":"string"},"functions":{"type":"string"},"culture":{"type":"string"},"observations":{"type":"object"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"query":"communication_style","result":{"tone":"analytical-warm","directness":0.7,"formality":0.6},"confidence":0.75}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/compatibility":{"post":{"operationId":"compatibility","summary":"Two-person compatibility analysis","description":"Analyze compatibility between two people across communication, values, cognitive style, emotional patterns, and practical dimensions.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$5.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"humanA":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"humanB":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"relationshipType":{"type":"string","enum":["romantic","business-partners","manager-report","coworkers","friends","parent-child","client-provider"]}},"required":["humanA","humanB"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"overallScore":72,"dimensions":{"communication":80,"values":68,"cognitive":75},"strengths":["Complementary thinking styles"],"risks":["Different conflict approaches"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/bridge":{"post":{"operationId":"commBridge","summary":"Communication bridge between two people","description":"Generate scenario-specific communication guidance — how Person A should talk to Person B for delivering feedback, requesting collaboration, resolving conflict, etc.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"humanA":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"humanB":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"scenario":{"type":"string","enum":["delivering-feedback","requesting-collaboration","resolving-conflict","making-introduction","discussing-performance","negotiating-terms"]}},"required":["humanA","humanB","scenario"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"scenario":"delivering-feedback","approach":"data-first, empathetic close","framingGuide":{"openWith":"...","tone":"direct-warm","avoid":["..."]}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/conflict":{"post":{"operationId":"conflictPredict","summary":"Conflict prediction between two people","description":"Predict friction points, conflict dynamics, escalation/de-escalation patterns, and recovery approaches between two people.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"humanA":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"humanB":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"relationshipType":{"type":"string"},"stressLevel":{"type":"string","enum":["low","moderate","high"]}},"required":["humanA","humanB"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"predictedFrictionPoints":[{"trigger":"different planning styles","severity":0.7}],"overallRisk":0.45,"confidence":0.72}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/team":{"post":{"operationId":"teamDynamics","summary":"Team dynamics analysis (2-10 people)","description":"Analyze team composition — roles, strengths, cognitive gaps, pairwise highlights, decision style, and recommendations. $12 for ≤5 members, $20 for ≤10.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$6.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"}},"required":["name"]},"minItems":2,"maxItems":10},"context":{"type":"object"}},"required":["team"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"members":[{"name":"Alice","role":"Analyst"}],"dynamics":{"strengths":["..."],"gaps":["..."],"decisionStyle":"..."}}}}},"402":{"description":"Payment Required"}}}},"/api/blah/adapt":{"post":{"operationId":"blahAdapt","summary":"Communication adaptation prompt","description":"Generate a communication strategy for how an AI agent should talk to a specific human. Personality-driven when KYH data is provided (Mode 1), context-driven otherwise (Mode 2).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"context":{"type":"object","properties":{"domain":{"type":"string","example":"customer-support"},"objective":{"type":"string","example":"resolve billing complaint"},"relationship_stage":{"type":"string","enum":["new","established","strained","recovering"]},"channel":{"type":"string","enum":["chat","email","voice","in-person"]},"urgency":{"type":"string","enum":["low","medium","high"]}},"required":["domain","objective"]},"kyh_profile":{"type":"object","description":"Optional KYH personality data for personalized mode"},"agent_role":{"type":"string"}},"required":["context"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"adaptation_prompt":"When speaking with this person, lead with empathy...","tone_profile":{"warmth":0.8,"formality":0.5,"directness":0.6,"humor":0.2},"tactics":["Acknowledge frustration first","Use concrete timelines"],"avoid":["Corporate jargon","Deflecting responsibility"],"mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/respond":{"post":{"operationId":"blahRespond","summary":"Real-time response coaching","description":"Given a human message and objective, generate ranked response options with emotional state detection. Speed-optimized for live conversations.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.35","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"human_message":{"type":"string","example":"I've been waiting three days and nobody has gotten back to me."},"objective":{"type":"string","example":"resolve complaint and retain customer"},"history":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"text":{"type":"string"}}}},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"tone_override":{"type":"string"}},"required":["human_message","objective"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"options":[{"text":"You're right to be frustrated...","strategy":"validation-first","fit_score":0.92}],"detected_state":{"emotion":"frustration","intensity":0.7,"openness_to_change":0.5},"avoid":["Excuses about internal processes"],"mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/deescalate":{"post":{"operationId":"blahDeescalate","summary":"Conflict de-escalation script","description":"Step-by-step recovery script for tense situations using NVC framework. Personality-aware when KYH data is available. Escalation levels 1-5.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"situation":{"type":"string","example":"Customer received wrong order for the second time"},"escalation_level":{"type":"integer","minimum":1,"maximum":5,"example":3},"domain":{"type":"string","example":"e-commerce"},"agent_fault":{"type":"boolean"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"prior_attempts":{"type":"array","items":{"type":"string"}}},"required":["situation","escalation_level","domain"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"script":[{"step":1,"action":"Acknowledge the failure","example_phrase":"I see this is the second time...","framework":"NVC"}],"personality_notes":[],"recovery":{"immediate":"Expedited replacement","follow_up":"24h check-in","timeline":"48h resolution"},"mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/persuade":{"post":{"operationId":"blahPersuade","summary":"Persuasion strategy","description":"Generate a multi-step persuasion strategy using Cialdini principles, ELM routing, cognitive biases, and personality-specific levers. Outcome-oriented: moves a person toward a specific decision.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"objective":{"type":"string","example":"Get buy-in for migrating to our enterprise plan"},"target_action":{"type":"string","example":"Sign the annual contract"},"domain":{"type":"string","example":"enterprise-sales"},"resistance_level":{"type":"integer","minimum":1,"maximum":5,"example":3},"relationship_context":{"type":"string"},"known_objections":{"type":"array","items":{"type":"string"}},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"constraints":{"type":"array","items":{"type":"string"}}},"required":["objective","target_action","domain"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"elm_approach":"hybrid","strategies":[{"principle":"Social Proof","tactic":"Reference similar companies who switched","example_phrase":"Teams like yours at Acme and GlobalCorp saw 40% faster onboarding after switching.","timing":"Early in conversation"}],"cognitive_biases":["Loss aversion — frame as cost of NOT switching"],"personality_levers":[],"avoid":["High-pressure closing tactics","Artificial urgency"],"persuasion_arc":"Build credibility through social proof, anchor on ROI, close with commitment consistency","mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/mirror":{"post":{"operationId":"blahMirror","summary":"Linguistic style matching","description":"Analyze recent messages and return precise communication parameters (tone, formality, energy, directness, humor, pacing) plus an injectable mirror prompt for real-time style matching.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.35","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10},"channel":{"type":"string","enum":["chat","email","voice-transcript","social"]},"kyh_profile":{"type":"object","description":"Optional KYH personality data"}},"required":["messages"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"style_parameters":{"tone":"warm-professional","vocabulary_level":"moderate","sentence_length":"medium","formality":0.5,"emotional_register":"measured","energy":0.6,"directness":0.7,"humor":0.3,"punctuation_style":"standard","response_pacing":"matched"},"mirror_prompt":"Use a warm but professional tone. Keep sentences medium-length. Be moderately direct. Light humor is welcome.","detected_patterns":["Uses 'we' over 'I'","Asks questions before stating opinions","Ends messages with action items"],"convergence_tips":["Mirror their collaborative 'we' framing","Start with a question before your main point"],"divergence_warnings":["Don't use overly formal language","Avoid walls of text"],"mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/decode":{"post":{"operationId":"blahDecode","summary":"Subtext analysis","description":"Read between the lines of a human's message. Detect hidden objections, unspoken concerns, power moves, testing behavior, buying signals, and emotional undercurrent.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The human's message to decode"},"context":{"type":"object","properties":{"domain":{"type":"string"},"relationship":{"type":"string"},"stakes":{"type":"string","enum":["low","medium","high"]}},"required":["domain"]},"history":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"text":{"type":"string"}}}},"kyh_profile":{"type":"object","description":"Optional KYH personality data"}},"required":["message","context"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"literal_meaning":"They're asking about the timeline","subtext":[{"reading":"They're concerned about delays and looking for reassurance","confidence":0.85,"evidence":"The phrase 'no rush but' signals urgency being downplayed"}],"hidden_signals":{"objections":["Timeline may be too long"],"concerns":["Project may not be prioritized"],"power_moves":[],"buying_signals":["Engaged enough to follow up"],"testing_behavior":["Testing responsiveness"]},"emotional_undercurrent":"Mild anxiety masked by casual tone","recommended_interpretation":"They need timeline reassurance and want to feel the project is on track","response_considerations":["Address timeline directly","Don't match their casualness — be concrete"],"mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/negotiate":{"post":{"operationId":"blahNegotiate","summary":"Negotiation intelligence","description":"Multi-turn negotiation strategy with ZOPA/BATNA analysis, concession sequencing, anchor calibration, bluff detection, and power dynamics assessment.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$3.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agent_position":{"type":"object","properties":{"goals":{"type":"array","items":{"type":"string"}},"constraints":{"type":"array","items":{"type":"string"}},"walk_away":{"type":"string"}},"required":["goals","constraints","walk_away"]},"counterparty_position":{"type":"object","properties":{"known_goals":{"type":"array","items":{"type":"string"}},"known_constraints":{"type":"array","items":{"type":"string"}},"estimated_leverage":{"type":"integer","minimum":1,"maximum":5}},"required":["known_goals"]},"domain":{"type":"string"},"negotiation_type":{"type":"string","enum":["salary","contract","partnership","procurement","price","terms"]},"current_stage":{"type":"string","enum":["opening","mid","closing","stalled"]},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"history":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"text":{"type":"string"}}}}},"required":["agent_position","counterparty_position","domain","negotiation_type","current_stage"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"zopa_analysis":{"exists":true,"estimated_range":"15-22% discount range","confidence":0.7},"strategy":{"approach":"Collaborative with firm anchoring","opening_move":"Present value-first framing before price discussion","anchor_point":"10% discount as initial offer"},"concession_sequence":[{"concession":"Extended payment terms","trigger_condition":"If they push back on price","timing":"mid"}],"tactics":[{"tactic":"Reference market comparables","timing":"After initial anchor"}],"bluff_detection":["Watch for 'other offers' claims without specifics"],"power_dynamics":{"agent_leverage":0.6,"counterparty_leverage":0.4,"assessment":"Agent has moderate advantage due to unique offering"},"personality_adjustments":[],"avoid":["Don't concede on price without getting something back"],"mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/frame":{"post":{"operationId":"blahFrame","summary":"Information framing","description":"Frame difficult information optimally for the recipient — bad news, price increases, trade-offs, feedback, rejections, delays. Uses gain/loss, temporal, attribution, and narrative framing science.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"information":{"type":"string","description":"The information to frame"},"frame_type":{"type":"string","enum":["bad-news","price-increase","trade-off","feedback","change","rejection","delay"]},"audience_context":{"type":"string","description":"Who the audience is"},"desired_outcome":{"type":"string","description":"What you want the recipient to feel or do"},"constraints":{"type":"array","items":{"type":"string"}},"kyh_profile":{"type":"object","description":"Optional KYH personality data"}},"required":["information","frame_type","audience_context","desired_outcome"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"recommended_frame":{"opening":"I want to share an update on our pricing that reflects the expanded capabilities we've delivered this year.","body":"Starting next quarter, your plan moves to $X/month — which now includes [new features]. Based on the value your team has gotten from [specific usage], this positions you well for [outcome].","close":"I'd love to walk through the details and make sure you're set up to get the most from the new tier. When works best?"},"framing_strategy":"Value-anchored gain framing with temporal distance","frame_type_used":"Gain framing + contrast anchoring","alternative_frames":[{"framing":"Loss aversion approach","strategy":"Use if customer is risk-averse","science":"Kahneman loss framing","risk":"Can feel manipulative if overused"}],"psychological_anchors":["Reference expanded feature set first","Tie price to specific value delivered"],"timing_advice":"Deliver mid-week, avoid Mondays and Fridays","personality_adjustments":[],"avoid":["Don't apologize for the increase","Don't lead with the number"],"mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/blah/rapport":{"post":{"operationId":"blahRapport","summary":"Relationship health scoring","description":"Analyze conversation history and score rapport, trust, warmth, engagement levels. Detect rapport breaks and suggest repairs. Designed for frequent mid-conversation calls.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.25","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"history":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["human","agent"]},"text":{"type":"string"}},"required":["role","text"]},"minItems":2,"maxItems":50},"domain":{"type":"string"},"relationship_type":{"type":"string","enum":["new","established","professional","support","sales"]},"kyh_profile":{"type":"object","description":"Optional KYH personality data"}},"required":["history"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"rapport_score":0.72,"trend":"improving","trust_level":0.68,"engagement_level":0.8,"warmth_level":0.65,"signals":[{"signal":"Customer asked a follow-up question","type":"positive","turn":3,"evidence":"Can you tell me more about how that works?"},{"signal":"Response shortened after pricing mention","type":"negative","turn":5,"evidence":"Ok."}],"rapport_breaks":[{"turn":5,"description":"Engagement dropped after pricing was introduced too early","severity":"minor"}],"repair_suggestions":["Acknowledge the price concern directly","Return to value discussion before re-introducing pricing"],"trajectory_summary":"Rapport was building well through turns 1-4 with genuine curiosity. Minor dip at turn 5 when pricing was introduced — recoverable with value re-anchoring.","mode":"contextual"}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/profile":{"post":{"operationId":"kybProfile","summary":"Buyer Intelligence Profile","description":"Analyze a buyer's decision-making style, impulse and loyalty scores, price sensitivity, and persuasion map. Personality-driven when KYH data is provided, contextual otherwise.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kyh_profile":{"type":"object","description":"Optional KYH personality data for personalized mode"},"partial_data":{"type":"object","description":"Optional partial personality data (e.g., single framework output)"},"buyer_description":{"type":"string","description":"Free-text description of the buyer when no KYH data is available"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"buyer_type":"analytical-deliberate","decision_style":{"speed":"slow","driver":"data","risk_tolerance":0.3},"impulse_score":0.2,"loyalty_score":0.75,"price_sensitivity":0.6,"persuasion_map":{"primary":"social-proof","secondary":"authority","avoid":"scarcity"},"confidence":0.78,"mode":"personalized"}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/pitch":{"post":{"operationId":"kybPitch","summary":"Sales Pitch Generator","description":"Generate a personality-optimized sales pitch for a specific product and buyer. Includes hook, value props, proof points, CTA, and objection preemption.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","example":"SaaS project management tool — $49/mo"},"channel":{"type":"string","enum":["email","chat","call","landing-page","dm"],"description":"Sales channel for tone adaptation"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object","description":"Optional partial personality data"},"buyer_description":{"type":"string","description":"Free-text buyer description"}},"required":["product"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"framing":"ROI-focused with social proof","pitch":{"hook":"Teams using this ship 40% faster — here's what that looks like for you","value_props":["Time savings quantified","Integration with existing stack","No learning curve"],"proof_points":["4,200 teams onboarded","G2 rating: 4.8/5"],"cta":"Start a 14-day trial — no card required"},"objection_preemption":["Price concern addressed via ROI framing","Switching cost minimized"],"tone":"confident-consultative","avoid":["Urgency pressure","Feature dumping"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/objections":{"post":{"operationId":"kybObjections","summary":"Objection Predictor","description":"Predict likely buyer objections based on personality, product, and price point. Returns probability-ranked objections with personality drivers and handling strategies.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.25","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","description":"Product or service being sold"},"price_point":{"type":"number","description":"Price in dollars"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object","description":"Optional partial personality data"},"buyer_description":{"type":"string","description":"Free-text buyer description"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"objections":[{"objection":"I need to check with my team first","probability":0.85,"personality_driver":"consensus-seeking","handling_strategy":"Offer a team demo — frame as 'let me make it easy for you to share this'"},{"objection":"The price seems high","probability":0.6,"personality_driver":"analytical-caution","handling_strategy":"Break down per-user cost and show ROI timeline"}],"buyer_fear_profile":{"primary":"making a wrong decision","secondary":"looking uninformed to peers"}}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/pricing":{"post":{"operationId":"kybPricing","summary":"Price Psychology Strategy","description":"Optimize price presentation for a specific buyer personality. Covers framing, discount sensitivity, urgency effectiveness, preferred payment models, and anchoring strategies.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_price":{"type":"number","example":49,"description":"Base product price in dollars"},"product_description":{"type":"string","description":"What the product is"},"currency":{"type":"string","example":"USD","description":"Currency code (default: USD)"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object","description":"Optional partial personality data"},"buyer_description":{"type":"string","description":"Free-text buyer description"}},"required":["product_price"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"presentation":{"format":"$49/mo","anchor":"$149 value — yours for $49","charm_pricing":false},"discount_sensitivity":0.4,"urgency_effectiveness":0.3,"preferred_payment":"annual-prepay","framing_recommendations":["Lead with value, not price","Show per-day cost ($1.63/day)","Avoid percentage discounts — use absolute numbers"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/content":{"post":{"operationId":"kybContent","summary":"Content Strategy","description":"Generate a personality-optimized content strategy — what content types resonate, narrative style, trust-building approach, follow-up cadence, and email subject strategies.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"industry":{"type":"string","description":"Buyer's industry"},"product_category":{"type":"string","description":"Product category being marketed"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object","description":"Optional partial personality data"},"buyer_description":{"type":"string","description":"Free-text buyer description"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"content_ranking":["case-studies","data-reports","comparison-guides","webinars","testimonials"],"narrative_style":"data-driven with human stories","trust_building":{"primary":"third-party validation","secondary":"transparency","timeline":"3-5 touchpoints"},"follow_up_cadence":{"frequency":"weekly","best_day":"Tuesday","best_time":"10am","channel":"email"},"email_subject_strategy":{"style":"specific-benefit","examples":["Your team's Q2 pipeline, optimized","3 benchmarks you're probably missing"]}}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/cultural":{"post":{"operationId":"kybCultural","summary":"Cultural Adaptation","description":"Adapt sales and marketing approach for a target market's cultural context. Uses Hofstede dimensions, local buying norms, negotiation styles, taboos, and pricing psychology.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_market":{"type":"string","example":"Japan","description":"Country or region"},"product":{"type":"string","description":"Product being sold"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object","description":"Optional partial personality data"},"buyer_description":{"type":"string","description":"Free-text buyer description"}},"required":["target_market"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"hofstede_profile":{"power_distance":54,"individualism":46,"uncertainty_avoidance":92,"long_term_orientation":88},"messaging_adaptations":["Emphasize group harmony","Use indirect language","Reference established brands"],"negotiation_style":{"pace":"slow","decision_maker":"group-consensus","relationship_first":true},"taboos":["Aggressive closing","Direct price comparison","Rushing the process"],"pricing_psychology":{"charm_pricing":false,"round_numbers_preferred":true,"bundle_effectiveness":"high"}}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/committee":{"post":{"operationId":"kybCommittee","summary":"Buying Committee Mapper","description":"Map a buying committee — individual stakeholder strategies, internal dynamics, coordinated approach, and deal velocity prediction. Each stakeholder can include personality data.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$4.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","example":"Enterprise CRM — $120K/year"},"stakeholders":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","example":"VP of Sales"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object"},"buyer_description":{"type":"string"}},"required":["role"]},"minItems":2}},"required":["product","stakeholders"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"stakeholder_strategies":[{"role":"VP of Sales","buyer_type":"driver-pragmatic","approach":"ROI and pipeline impact","risk":"impatience with long demos"},{"role":"CTO","buyer_type":"analytical-skeptic","approach":"Architecture deep-dive and security audit","risk":"NIH syndrome"}],"committee_dynamics":{"champion":"VP of Sales","blocker_risk":"CTO","influencer":"Head of RevOps"},"coordinated_strategy":"Secure CTO buy-in with technical proof before VP pushes for budget approval","deal_velocity_prediction":{"estimated_cycle":"45-60 days","bottleneck":"security review"}}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/qualify":{"post":{"operationId":"kybQualify","summary":"Purchase Readiness Qualifier","description":"Score buyer purchase readiness before investing in expensive pitch/objections calls. BANT + MEDDIC + personality-driven urgency calibration.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","example":"Enterprise analytics platform — $2,500/month"},"signals":{"type":"array","items":{"type":"string"},"example":["asked about pricing","requested demo","mentioned competitor"]},"deal_context":{"type":"object","properties":{"budget_mentioned":{"type":"boolean"},"timeline":{"type":"string"},"decision_maker":{"type":"boolean"},"competitors_mentioned":{"type":"array","items":{"type":"string"}}}},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object"},"buyer_description":{"type":"string"}},"required":["product","signals"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"verdict":"qualified","readiness_score":0.78,"budget_authority":0.85,"urgency":0.65,"fit":0.72,"qualifying_signals":["asked about pricing","requested demo"],"red_flags":[],"recommended_next":"Proceed to personality-matched pitch"}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/followup":{"post":{"operationId":"kybFollowup","summary":"Follow-Up Message Generator","description":"Generate the optimal follow-up message with timing and channel recommendation for prospects who went quiet. Personality-calibrated when KYH data is available.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","example":"Marketing automation SaaS — $199/month"},"last_interaction":{"type":"string","example":"Discussed feature comparison and asked for a proposal"},"days_since":{"type":"number","example":5},"interaction_count":{"type":"number","example":3},"previous_outcome":{"type":"string","example":"showed interest but asked for time to think"},"channel":{"type":"string","enum":["email","chat","linkedin","phone"]},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object"},"buyer_description":{"type":"string"}},"required":["product","last_interaction","days_since","interaction_count"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"message":"Hi Sarah — I came across a case study that reminded me of the challenge you mentioned...","subject_line":"Quick thought on your automation workflow","timing":{"send_in_days":1,"best_day":"Tuesday","best_time":"10:00 AM","reasoning":"Mid-morning minimizes decision fatigue"},"channel_recommendation":"email","tone_strategy":"Warm, value-add approach — no direct ask"}}}},"402":{"description":"Payment Required"}}}},"/api/kyb/winloss":{"post":{"operationId":"kybWinLoss","summary":"Win/Loss Deal Analysis","description":"Post-deal retrospective analyzing what worked, what failed, and lessons for this buyer personality type. Returns turning points, personality fit score, and reengagement strategy.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","example":"Enterprise CRM — $120K annual contract"},"outcome":{"type":"string","enum":["won","lost","stalled"],"example":"lost"},"deal_value":{"type":"number","example":120000},"sales_cycle_days":{"type":"number","example":45},"conversation_summary":{"type":"string","example":"Initial demo went well, champion was VP Sales, but CTO raised security concerns that stalled the deal..."},"key_moments":{"type":"array","items":{"type":"string"}},"competitor_lost_to":{"type":"string","example":"Salesforce"},"kyh_profile":{"type":"object","description":"Optional KYH personality data"},"partial_data":{"type":"object"},"buyer_description":{"type":"string"}},"required":["product","outcome","conversation_summary"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"analysis":{"what_worked":["Strong initial demo"],"what_failed":["Didn't address CTO security concerns early"],"missed_opportunities":["Could have provided security audit doc proactively"]},"personality_fit":{"score":0.45,"assessment":"Approach was optimized for the VP (driver type) but missed the CTO's analytical decision style"},"turning_points":[{"moment":"CTO security review","impact":"negative","lesson":"Address technical stakeholders' concerns before they become blockers"}],"recommended_adjustments":["Lead with security documentation for analytical buyers"],"reengagement_strategy":"Wait 6 weeks, re-approach with completed SOC 2 report"}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/evolution":{"post":{"operationId":"relEvolution","summary":"Relationship evolution over time","description":"Track how a relationship between two people evolves — trust trajectory, inflection points, patterns, and current state assessment.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$3.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"human_a":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"human_b":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"snapshots":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string"},"trust_a_to_b":{"type":"number"},"trust_b_to_a":{"type":"number"},"emotional_tone":{"type":"string"}},"required":["timestamp"]},"minItems":2,"maxItems":20},"context":{"type":"object"}},"required":["human_a","human_b","snapshots"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"timespan":"4 months","trend":"positive-growth","pattern":"slow-build","current_state":{"trust":70,"trajectory":"ascending"}}}}},"402":{"description":"Payment Required"}}}},"/api/vault/create":{"post":{"operationId":"vaultCreate","summary":"Create a persistent human profile","description":"Create a new persistent human profile in the vault. Agent-namespaced by wallet address. Accepts initial identity, text samples, observations, and birth data.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.01","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"human_id":{"type":"string","description":"Agent-chosen unique identifier for this human"},"name":{"type":"string","example":"Alice Chen"},"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"context":{"type":"object","description":"Any additional context about this human"}},"required":["human_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"human_id":"alice-chen-001","created":true,"frameworks_computed":["natal-chart","communication"],"stored_signals":{"textSamples":3,"observations":2}}}}},"402":{"description":"Payment Required"}}}},"/api/vault/update":{"post":{"operationId":"vaultUpdate","summary":"Update an existing vault profile","description":"Update an existing vault profile with new signals — text samples, observations, birth data. Auto-merges with existing data, re-runs affected personality engines, recomputes canonical traits.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"human_id":{"type":"string","description":"Profile identifier to update"},"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"context":{"type":"object"}},"required":["human_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"human_id":"alice-chen-001","updated":true,"frameworks_recomputed":["psych","communication"],"total_signals":{"textSamples":8,"observations":5}}}}},"402":{"description":"Payment Required"}}}},"/api/vault/read":{"post":{"operationId":"vaultRead","summary":"Retrieve a vault profile","description":"Retrieve a persistent human profile from the vault with all accumulated framework outputs, canonical traits, text history, and metadata.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.25","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"human_id":{"type":"string","description":"Profile identifier to retrieve"},"include":{"type":"array","items":{"type":"string"},"description":"Optional list of framework keys to include (default: all)"}},"required":["human_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"human_id":"alice-chen-001","name":"Alice Chen","frameworks":{"natal-chart":{"sunSign":"Gemini"},"communication":{"tone":"analytical-warm"}},"canonical_traits":[{"id":"introversion","value":0.72}],"metadata":{"created":"2026-03-20T10:00:00Z","updated":"2026-03-20T14:30:00Z","signal_count":13}}}}},"402":{"description":"Payment Required"}}}},"/api/vault/list":{"post":{"operationId":"vaultList","summary":"List all vault profiles","description":"List all human profile IDs stored in the vault for this agent. Returns IDs and metadata without full profile data.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.10","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","description":"Max profiles to return (default: 50)"},"offset":{"type":"integer","description":"Pagination offset (default: 0)"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"profiles":[{"human_id":"alice-chen-001","name":"Alice Chen","created":"2026-03-20T10:00:00Z","signal_count":13},{"human_id":"bob-smith-002","name":"Bob Smith","created":"2026-03-19T08:00:00Z","signal_count":5}],"total":2}}}},"402":{"description":"Payment Required"}}}},"/api/vault/delete":{"post":{"operationId":"vaultDelete","summary":"Delete a vault profile","description":"Delete a human profile from the vault. Near-free pricing maintains consistent x402 payment flow for wallet identification.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.01","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"human_id":{"type":"string","description":"Profile identifier to delete"}},"required":["human_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"human_id":"alice-chen-001","deleted":true}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/state":{"post":{"operationId":"kyhState","summary":"Current emotional and cognitive state","description":"Current emotional and cognitive state detection from recent messages. Detects stress, confidence, withdrawal, enthusiasm across 12 emotion categories and 4 quadrants. With vault profile: baseline delta comparison.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"string"},"minItems":1,"description":"Recent messages from the human (newest last)"},"human_id":{"type":"string","description":"Optional vault profile ID for baseline comparison"},"context":{"type":"object","description":"Situational context (e.g., meeting, negotiation, casual)"}},"required":["messages"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"emotional_state":{"primary":{"emotion":"stress","intensity":0.7},"secondary":{"emotion":"determination","intensity":0.5},"quadrant":"high-arousal-negative"},"cognitive_state":{"focus":0.6,"openness":0.4,"decision_readiness":0.3},"baseline_delta":{"stress":"+0.3","confidence":"-0.2"},"recommendations":["Reduce cognitive load","Acknowledge pressure before proceeding"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/timing":{"post":{"operationId":"kyhTiming","summary":"Timing intelligence forecast","description":"Timing intelligence — predict optimal windows for interactions using planetary transits, numerology personal day, Vedic Dasha periods, and BaZi energy cycles. 7-30 day forecast with action-specific scoring.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"action":{"type":"string","description":"What you're timing for","enum":["pitch","negotiate","hire","launch","difficult-conversation","creative-work","decision","general"]},"range_days":{"type":"integer","minimum":1,"maximum":30,"description":"Forecast window in days (default: 7)"},"human_id":{"type":"string","description":"Optional vault profile ID (auto-fills birth data)"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"forecast":[{"date":"2026-03-22","score":0.85,"label":"excellent","factors":["Jupiter trine Sun","Personal Day 1","Wood energy peak"]},{"date":"2026-03-23","score":0.45,"label":"challenging","factors":["Mercury square Mars","Void of Course Moon"]}],"best_window":{"date":"2026-03-22","time_of_day":"morning","confidence":0.78},"action":"pitch"}}}},"402":{"description":"Payment Required"}}}}}}