Favorable element candidates
yongshin_candidatesClassical Yongshin (用神, favorable element) candidates from five methods (Eokbu, Byeongyak, Tonggwan, Johu, Gyeokguk) with each method's pick. No final engine decision. Use for 'my favorable element candidates', '용신 후보'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loc | No | 24Plus world-city ID for births outside Korea. | |
| sex | No | Sex at birth; sets the direction of the 10-year luck cycles. Required unless legacy 'gender' is given. | |
| name | No | Optional display name. | |
| birth | Yes | Local birth date and time. ISO 8601 'YYYY-MM-DDTHH:mm' (e.g. 1990-01-15T10:30) or legacy 12 digits 'YYYYMMDDHHmm'. Use 12:30 when the time is unknown and set time_unknown. | |
| gender | No | Legacy form of sex: 0 female, 1 male. | |
| option1 | No | Legacy form of rat_hour_rule (1 = early). | |
| option2 | No | Legacy form of year_boundary (-1 = winter_solstice). | |
| calendar | No | Calendar of the birth date. Default solar. | |
| is_lunar | No | Legacy form of calendar=lunar. | |
| timezone | No | IANA time zone of the birthplace. Asia/Seoul is supported directly; for births elsewhere pass 'loc'. | |
| is_leap_year | No | Legacy form of lunar_leap_month. | |
| time_unknown | No | Birth time unknown; the hour pillar is marked as estimated. | |
| rat_hour_rule | No | Rat-hour (子時) rule: 'late' 야자시 (default) or 'early' 조자시. | |
| year_boundary | No | Year pillar boundary: 'lichun' 입춘 (default) or 'winter_solstice' 동지. | |
| lunar_leap_month | No | Lunar leap month (윤달). Only with calendar=lunar. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| tool | Yes | ||
| basis | No | Chart basis text ([기본정보]): pillars, calendar/season basis, luck-cycle start. | |
| links | Yes | ||
| engine | Yes | ||
| contract | Yes | ||
| disclaimer | Yes | ||
| input_echo | Yes |