{"uid":"cap_hCbp8pme9_j_YVFWtINO5","slug":"vietnamese-auspicious-days-finder-xem-ngay-tot-api-72666c5f","name":"Vietnamese Auspicious Days Finder (Xem Ngay Tot API)","description":"Find auspicious days (ngay hoang dao / ngay tot) in the next N days for a specific activity: wedding, moving house, opening business, signing contracts, groundbreaking, travel, renovation and more. Returns matching dates with lunar date, Can Chi and what each day is good for. The classic Vietnamese 'xem ngay tot' as an API.","url":"https://lunar-api-production-cba9.up.railway.app/v1/lunar/auspicious","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"days":{"type":"number","description":"Search window in days (default 30, max 120)"},"from":{"type":"string","description":"Start date YYYY-MM-DD (default today ICT)"},"activity":{"enum":["wedding","moving","opening","travel","contract","groundbreaking","renovation","burial","trading","worship"],"type":"string","description":"Activity to find good days for (optional: omit for all hoang dao days)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kwcz2dNTkM7cAW1L0V9MD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds auspicious Vietnamese lunar calendar days (ngày hoàng đạo / ngày tốt) within a search window for a specific activity such as wedding, moving house, or opening a business.","exampleAgentPrompt":"Can you find all the auspicious ngày tốt days for a wedding in the next 45 days starting from 2025-08-01?","exampleUseCases":null,"resultDescription":"A list of matching auspicious dates within the search window, each with the corresponding Vietnamese lunar date, Can Chi (heavenly stems and earthly branches), and which activities each day is favorable for.","failureModes":["Invalid activity enum value returns error","Days parameter exceeds max of 120 causing rejection","Invalid date format for 'from' parameter causes parse error","No auspicious days found in the given window returns empty list","Missing or malformed query parameters may return 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need to identify culturally auspicious Vietnamese lunar calendar days for a specific activity type within a date range — especially for scheduling life events like weddings, business openings, or relocations according to traditional Vietnamese practice.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:20.457Z","isFirstParty":false}