{"uid":"cap_MyW1abriPPnu8SkSDa3yR","slug":"convrgent-ai-e5963edd","name":"Convrgent AI Timing Intelligence","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.","url":"https://convrgent.ai/api/kyh/timing","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"properties":{"action":{"enum":["pitch","negotiate","hire","launch","difficult-conversation","creative-work","decision","general"],"type":"string"},"human_id":{"type":"string","description":"Optional vault profile ID"},"birthData":{"type":"object","required":["year","month","day","location"],"properties":{"day":{"type":"integer"},"hour":{"type":"integer","description":"Highly recommended. Defaults to 12 if omitted."},"year":{"type":"integer"},"month":{"type":"integer"},"minute":{"type":"integer","description":"Defaults to 0 if omitted."},"latitude":{"type":"number","description":"Optional override"},"location":{"type":"string","description":"City and country. Coordinates auto-resolved."},"timezone":{"type":"number","description":"Optional — auto-resolved from location"},"longitude":{"type":"number","description":"Optional override"}}},"range_days":{"type":"integer","description":"Forecast window in days (default: 7)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"action":"pitch","forecast":[{"date":"2026-03-22","label":"excellent","score":0.85,"factors":["Jupiter trine Sun","Personal Day 1","Wood energy peak"]},{"date":"2026-03-23","label":"challenging","score":0.45,"factors":["Mercury square Mars","Void of Course Moon"]}],"best_window":{"date":"2026-03-22","confidence":0.78,"time_of_day":"morning"}}},"example":{"request":{"action":"pitch","location":"San Francisco, USA","birth_date":"1985-06-20","birth_time":"10:30","range_days":14},"response":{"days":[{"bazi":{"dayEnergy":"Metal Yin Goat","dayMasterHarmony":0.5},"date":"2026-04-17","vedic":{"bhukti":"Rahu","alignment":0.5,"currentDasha":"Ketu"},"rating":"neutral","summary":"2026-04-17: neutral for pitch (57/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Square, Sun Opposition. Personal day 3: Communication, creativity, expression.","transits":{"score":51,"activeAspects":[{"orb":1.83,"aspect":"Sextile","nature":"harmonious","affinity":0.39,"natalPlanet":"Sun","transitingPlanet":"Sun"},{"orb":1.86,"aspect":"Square","nature":"challenging","affinity":-0.29,"natalPlanet":"Moon","transitingPlanet":"Sun"},{"orb":4.83,"aspect":"Trine","nature":"harmonious","affinity":0.3,"natalPlanet":"Neptune","transitingPlanet":"Sun"},{"orb":4.56,"aspect":"Opposition","nature":"challenging","affinity":-0.22,"natalPlanet":"Pluto","transitingPlanet":"Sun"},{"orb":1.75,"aspect":"Sextile","nature":"harmonious","affinity":0.2,"natalPlanet":"Sun","transitingPlanet":"Moon"}],"mercuryRetrograde":false},"numerology":{"meaning":"Communication, creativity, expression","alignment":0.85,"personalDay":3},"overallScore":57},{"bazi":{"dayEnergy":"Water Yang Monkey","dayMasterHarmony":0.5},"date":"2026-04-18","vedic":{"bhukti":"Rahu","alignment":0.5,"currentDasha":"Ketu"},"rating":"neutral","summary":"2026-04-18: neutral for pitch (49/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Square, Sun Opposition. Personal day 4: Building, planning, discipline.","transits":{"score":52,"activeAspects":[{"orb":0.85,"aspect":"Sextile","nature":"harmonious","affinity":0.45,"natalPlanet":"Sun","transitingPlanet":"Sun"},{"orb":2.83,"aspect":"Square","nature":"challenging","affinity":-0.25,"natalPlanet":"Moon","transitingPlanet":"Sun"},{"orb":3.86,"aspect":"Trine","nature":"harmonious","affinity":0.34,"natalPlanet":"Neptune","transitingPlanet":"Sun"},{"orb":3.59,"aspect":"Opposition","nature":"challenging","affinity":-0.25,"natalPlanet":"Pluto","transitingPlanet":"Sun"},{"orb":1.86,"aspect":"Sextile","nature":"harmonious","affinity":0.31,"natalPlanet":"Mercury","transitingPlanet":"Moon"}],"mercuryRetrograde":false},"numerology":{"meaning":"Building, planning, discipline","alignment":0.4,"personalDay":4},"overallScore":49},{"bazi":{"dayEnergy":"Water Yin Rooster","dayMasterHarmony":0.5},"date":"2026-04-19","vedic":{"bhukti":"Rahu","alignment":0.5,"currentDasha":"Ketu"},"rating":"neutral","summary":"2026-04-19: neutral for pitch (58/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Square, Sun Opposition. Personal day 5: Change, adaptability, movement.","transits":{"score":53,"activeAspects":[{"orb":0.13,"aspect":"Sextile","nature":"harmonious","affinity":0.49,"natalPlanet":"Sun","transitingPlanet":"Sun"},{"orb":3.81,"aspect":"Square","nature":"challenging","affinity":-0.22,"natalPlanet":"Moon","transitingPlanet":"Sun"},{"orb":2.88,"aspect":"Trine","nature":"harmonious","affinity":0.38,"natalPlanet":"Neptune","transitingPlanet":"Sun"},{"orb":2.61,"aspect":"Opposition","nature":"challenging","affinity":-0.27,"natalPlanet":"Pluto","transitingPlanet":"Sun"},{"orb":1.69,"aspect":"Sextile","nature":"harmonious","affinity":0,"natalPlanet":"Moon","transitingPlanet":"Moon"}],"mercuryRetrograde":false},"numerology":{"meaning":"Change, adaptability, movement","alignment":0.85,"personalDay":5},"overallScore":58},{"bazi":{"dayEnergy":"Wood Yang Dog","dayMasterHarmony":0.5},"date":"2026-04-20","vedic":{"bhukti":"Rahu","alignment":0.5,"currentDasha":"Ketu"},"rating":"neutral","summary":"2026-04-20: neutral for pitch (50/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Square, Sun Opposition. Personal day 6: Responsibility, service, care.","transits":{"score":55,"activeAspects":[{"orb":1.11,"aspect":"Sextile","nature":"harmonious","affinity":0.43,"natalPlanet":"Sun","transitingPlanet":"Sun"},{"orb":4.79,"aspect":"Square","nature":"challenging","affinity":-0.18,"natalPlanet":"Moon","transitingPlanet":"Sun"},{"orb":1.9,"aspect":"Trine","nature":"harmonious","affinity":0.42,"natalPlanet":"Neptune","transitingPlanet":"Sun"},{"orb":1.63,"aspect":"Opposition","nature":"challenging","affinity":-0.3,"natalPlanet":"Pluto","transitingPlanet":"Sun"},{"orb":4.34,"aspect":"Trine","nature":"harmonious","affinity":0.22,"natalPlanet":"Jupiter","transitingPlanet":"Moon"}],"mercuryRetrograde":false},"numerology":{"meaning":"Responsibility, service, care","alignment":0.4,"personalDay":6},"overallScore":50},{"bazi":{"dayEnergy":"Wood Yin Pig","dayMasterHarmony":0.5},"date":"2026-04-21","vedic":{"bhukti":"Rahu","alignment":0.5,"currentDasha":"Ketu"},"rating":"neutral","summary":"2026-04-21: neutral for pitch (50/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Opposition, Moon Opposition. Personal day 7: Reflection, analysis, inner work.","transits":{"score":55,"activeAspects":[{"orb":2.08,"aspect":"Sextile","nature":"harmonious","affinity":0.37,"natalPlanet":"Sun","transitingPlanet":"Sun"},{"orb":0.93,"aspect":"Trine","nature":"harmonious","affinity":0.46,"natalPlanet":"Neptune","transitingPlanet":"Sun"},{"orb":0.66,"aspect":"Opposition","nature":"challenging","affinity":-0.33,"natalPlanet":"Pluto","transitingPlanet":"Sun"},{"orb":2.35,"aspect":"Conjunction","nature":"neutral","affinity":0.06,"natalPlanet":"Sun","transitingPlanet":"Moon"},{"orb":5.36,"aspect":"Opposition","nature":"challenging","affinity":0,"natalPlanet":"Neptune","transitingPlanet":"Moon"}],"mercuryRetrograde":false},"numerology":{"meaning":"Reflection, analysis, inner work","alignment":0.4,"personalDay":7},"overallScore":50},{"bazi":{"dayEnergy":"Fire Yang Rat","dayMasterHarmony":0.5},"date":"2026-04-22","vedic":{"bhukti":"Rahu","alignment":0.5,"currentDasha":"Ketu"},"rating":"neutral","summary":"2026-04-22: neutral for pitch (50/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Opposition, Mercury Square. Personal day 8: Power, authority, achievement.","transits":{"score":55,"activeAspects":[{"orb":3.06,"aspect":"Sextile","nature":"harmonious","affinity":0.31,"natalPlanet":"Sun","transitingPlanet":"Sun"},{"orb":0.05,"aspect":"Trine","nature":"harmonious","affinity":0.5,"natalPlanet":"Neptune","transitingPlanet":"Sun"},{"orb":0.32,"aspect":"Opposition","nature":"challenging","affinity":-0.34,"natalPlanet":"Pluto","transitingPlanet":"Sun"},{"orb":2.83,"aspect":"Conjunction","nature":"neutral","affinity":0.09,"natalPlanet":"Mercury","transitingPlanet":"Moon"},{"orb":2.36,"aspect":"Sextile","nature":"harmonious","affinity":0.32,"natalPlanet":"Venus","transitingPlanet":"Moon"}],"mercuryRetrograde":false},"numerology":{"meaning":"Power, authority, achievement","alignment":0.4,"personalDay":8},"overallScore":50},{"bazi":{"dayEnergy":"Fire Yin Ox","dayMasterHarmony":0.5},"date":"2026-04-23","vedic":{"bhukti":"Rahu","alignment":0.5,"currentDasha":"Ketu"},"rating":"neutral","summary":"2026-04-23: neutral for pitch (50/100). Supporting: Sun Trine, Moon Trine. Challenging: Sun Opposition, Mercury Square. Personal day 9: Completion, release, culmination.","transits":{"score":56,"activeAspects":[{"orb":1.03,"aspect":"Trine","nature":"harmonious","affinity":0.46,"natalPlanet":"Neptune","transitingPlanet":"Sun"},{"orb":1.3,"aspect":"Opposition","nature":"challenging","affinity":-0.31,"natalPlanet":"Pluto","transitingPlanet":"Sun"},{"orb":0.08,"aspect":"Conjunction","nature":"neutral","affinity":0,"natalPlanet":"Moon","transitingPlanet":"Moon"},{"orb":3.13,"aspect":"Trine","nature":"harmonious","affinity":0,"natalPlanet":"Saturn","transitingPlanet":"Moon"},{"orb":1.46,"aspect":"Square","nature":"challenging","affinity":-0.48,"natalPlanet":"Mercury","transitingPlanet":"Mercury"}],"mercuryRetrograde":false},"numerology":{"meaning":"Completion, release, culmination","alignment":0.4,"personalDay":9},"overallScore":50}],"action":"pitch","status":"success","timestamp":"2026-04-17T20:29:11.658Z","windowEnd":"2026-04-23","bestWindow":{"end":"2026-04-19","score":58,"start":"2026-04-19","reason":"2026-04-19: neutral for pitch (58/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Square, Sun Opposition. Personal day 5: Change, adaptability, movement."},"agentPrompt":"Timing intelligence for \"pitch\" based on cyclical pattern analysis. Best window: 2026-04-19 (score: 58/100). 0/7 days rated good or excellent.","windowStart":"2026-04-17","worstWindow":{"end":"2026-04-18","score":49,"start":"2026-04-18","reason":"2026-04-18: neutral for pitch (49/100). Supporting: Sun Sextile, Sun Trine. Challenging: Sun Square, Sun Opposition. Personal day 4: Building, planning, discipline."}}},"exampleRequest":{"action":"pitch","location":"San Francisco, USA","birth_date":"1985-06-20","birth_time":"10:30","range_days":14},"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HM79Xm8rSRK_UyzLr46Y7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Predicts optimal timing windows for specific actions over a 7-30 day forecast using planetary transits, numerology personal day, Vedic Dasha periods, and BaZi energy cycles with action-specific scoring.","exampleAgentPrompt":"Using my birth data — March 15, 1988, 7:42am, New York — give me a 14-day timing forecast scored specifically for contract signing and negotiation actions starting from today.","exampleUseCases":null,"resultDescription":"Returns a structured 7-30 day forecast with scored timing windows for the requested action type, incorporating planetary transit analysis, numerology personal day numbers, Vedic Vimshottari Dasha period assessments, and BaZi energy cycle ratings — each day or window annotated with an action-specific score and supporting rationale.","failureModes":["Missing or invalid birth data (date, time, location) causes computation failure","Unsupported action type returns no scoring","Forecast window outside 7-30 day range may be rejected","Malformed profile ID returns profile-not-found error","Payment failure via x402 protocol blocks the call"],"whenToPreferThis":"Choose this endpoint when you need multi-system astrological and numerological timing intelligence synthesized into a single forecast — specifically when the user wants day-by-day or window-by-window scoring for a specific type of action (negotiation, signing, launch, communication) rather than a static natal chart or personality profile. Prefer over general calendar tools when esoteric timing frameworks (Vedic Dasha, BaZi, planetary transits) are desired.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:06.451Z","isFirstParty":false}