# Vietnamese Auspicious Days Finder (Xem Ngay Tot API)

> Vietnamese Auspicious Days Finder (Xem Ngay Tot API) is a paid API for AI agents from lunar-api-production-cba9.up.railway.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://lunar-api-production-cba9.up.railway.app/v1/lunar/auspicious
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vietnamese-auspicious-days-finder-xem-ngay-tot-api-72666c5f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hCbp8pme9_j_YVFWtINO5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vietnamese-auspicious-days-finder-xem-ngay-tot-api-72666c5f
```

Example prompt: Can you find all the auspicious ngày tốt days for a wedding in the next 45 days starting from 2025-08-01?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vietnamese-auspicious-days-finder-xem-ngay-tot-api-72666c5f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lunar-api-production-cba9.up.railway.app](https://www.zero.xyz/host/lunar-api-production-cba9.up.railway.app/llms.txt)