{"uid":"cap_2JRHhe8IEZQoJs4kAWoyv","slug":"api-cn402-com-5adf4f7b","name":"Flying Stars (Xuan Kong Fei Xing) Chart Calculator","description":"Flying Stars, 玄空飞星, Xuan Kong Fei Xing, period 9 flying stars, 三元九运, Feng Shui period 1-9, 9-grid star chart, annual monthly flying stars, Chinese space-time Feng Shui. Compute the Flying Stars (9-grid) chart for a given year and house orientation (sitting direction).","url":"https://api.cn402.com/fengshui/feixing","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"year":{"type":"string","description":"Year (required)"},"month":{"type":"string","description":"Month (optional)"}}},"responseSchema":null,"example":{"request":{"year":2025,"period":9,"sitting_direction":"north"},"response":{"meta":{"source":"玄空飞星(九宫紫白)"},"year":2025,"_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","year_chart":{"palaces":{"东":{"star":3,"palace":"东","star_info":{"num":3,"name":"三碧禄存","color":"碧","domain":"是非/官非/口舌","nature":"凶","palace":"震","element":"木"},"palace_num":3},"中":{"star":5,"palace":"中","star_info":{"num":5,"name":"五黄廉贞","color":"黄","domain":"灾祸/疾病","nature":"大凶","palace":"中","element":"土"},"palace_num":5},"北":{"star":1,"palace":"北","star_info":{"num":1,"name":"一白贪狼","color":"白","domain":"事业/官运/桃花","nature":"吉","palace":"坎","element":"水"},"palace_num":1},"南":{"star":9,"palace":"南","star_info":{"num":9,"name":"九紫右弼","color":"紫","domain":"喜庆/桃花","nature":"吉","palace":"离","element":"火"},"palace_num":9},"西":{"star":7,"palace":"西","star_info":{"num":7,"name":"七赤破军","color":"赤","domain":"破财/官非","nature":"凶","palace":"兑","element":"金"},"palace_num":7},"东北":{"star":8,"palace":"东北","star_info":{"num":8,"name":"八白左辅","color":"白","domain":"财运/进财","nature":"大吉","palace":"艮","element":"土"},"palace_num":8},"东南":{"star":4,"palace":"东南","star_info":{"num":4,"name":"四绿文曲","color":"绿","domain":"文昌/学业/姻缘","nature":"吉","palace":"巽","element":"木"},"palace_num":4},"西北":{"star":6,"palace":"西北","star_info":{"num":6,"name":"六白武曲","color":"白","domain":"权力/驿马/贵人","nature":"吉","palace":"乾","element":"金"},"palace_num":6},"西南":{"star":2,"palace":"西南","star_info":{"num":2,"name":"二黑巨门","color":"黑","domain":"病符/疾病","nature":"凶","palace":"坤","element":"土"},"palace_num":2}},"center_star":5,"center_star_info":{"num":5,"name":"五黄廉贞","color":"黄","domain":"灾祸/疾病","nature":"大凶","palace":"中","element":"土"}},"current_period":{"name":"九运","note":"九运(2024-2043)由九紫右弼火星当令,主火、文化、AI、媒体、能源","element":"火","end_year":2043,"start_year":2024,"ruling_star":9}}},"exampleRequest":{"year":2025,"period":9,"sitting_direction":"north"},"tags":["x402"],"displayCostAmount":"0.08","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":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Sr3mcWc1SpFiHsDB9GRRS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the 9-grid Flying Stars Feng Shui chart for a given year and house sitting direction, covering Period 1–9 and annual/monthly star distributions.","exampleAgentPrompt":"Can you generate the Flying Stars (Xuan Kong Fei Xing) 9-grid chart for the year 2025 for a house sitting north and facing south, using Period 9?","exampleUseCases":null,"resultDescription":"Returns a 9-palace grid (3×3 matrix) showing the flying star numbers assigned to each sector of the house for the given year and sitting direction, including period stars, annual stars, and possibly monthly stars — used in traditional Feng Shui analysis to assess energy distribution across a property.","failureModes":["Invalid or unsupported sitting direction — returns error indicating unrecognized orientation value","Year out of supported range — returns error or empty result","Missing required parameters (year or sitting direction) — returns 400-level validation error","Unrecognized period number — returns error if period is outside 1–9","Payment not confirmed — returns 402 Payment Required if x402 payment not processed"],"whenToPreferThis":"Use this endpoint when you need a traditional Chinese Xuan Kong Fei Xing flying stars computation for a specific year and house orientation. Prefer this over generic feng shui information sources when you need a structured, computed 9-grid chart with actual star numbers for period-based feng shui analysis. Ideal for apps serving Chinese metaphysics practitioners, feng shui consultants, or users planning home energy assessments based on the San Yuan (三元九运) system.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:00.515Z","isFirstParty":false}