{"endpoint":"/api/kyh/timing","method":"POST","description":"Timing intelligence — optimal windows for interactions based on cyclical pattern analysis","pricing":"$1.00 USDC via x402","input":{"birth_date":"YYYY-MM-DD (required)","birth_time":"HH:MM (optional, improves precision)","location":"string (required) — birth location","name":"string (optional) — for numerology calculations","action":"string (required) — pitch | negotiate | ask | deliver_bad_news | launch | start_project | make_decision | present | interview | have_difficult_conversation","window_days":"number (optional, default 7, max 30)","human_id":"string (optional) — vault profile reference for birth data"},"output":{"days":"Array of day-by-day ratings with transit aspects, numerology, vedic, and bazi signals","bestWindow":"Optimal consecutive days with score and reason","worstWindow":"Worst consecutive days to avoid"},"notes":["Combines 4 independent timing systems: planetary transits (40%), numerology personal day (20%), Vedic Dasha (20%), BaZi energy (20%)","Swiss Ephemeris precision for transit calculations","Mercury retrograde penalty applied to communication-heavy actions","Different actions produce different day rankings — pitch vs deliver_bad_news score differently"]}