# Vietnamese Lunar Calendar Today

> Vietnamese Lunar Calendar Today is a paid API for AI agents from lunar-api-production-cba9.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns today's Vietnamese lunar calendar data including lunar date, Can Chi, day quality (hoang dao/hac dao), auspicious/inauspicious activities, lucky hours, and solar term for Asia/Ho_Chi_Minh timezone.

## Facts

- Endpoint: GET https://lunar-api-production-cba9.up.railway.app/v1/lunar/today
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vietnamese-lunar-calendar-today-2ead2039
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2yw3wEbTNcPUUj60-tthD

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-lunar-calendar-today-2ead2039
```

Example prompt: What does today's Vietnamese lunar calendar say — is it a hoang dao or hac dao day, what are the lucky hours, and what activities like moving or opening a business should I avoid?

## When to prefer this

Use this endpoint when you need the current day's Vietnamese lunar calendar data automatically without needing to supply a date. Ideal for daily briefing bots, push notifications, horoscope agents, or any workflow that runs once per day and needs today's lunar information in Vietnamese cultural context. If you need data for a specific past or future date, use the sibling endpoint for arbitrary solar dates instead.

## Known failure modes

- Timezone miscalculation if server clock drifts — result may reflect wrong date near midnight boundaries
- No parameters accepted; cannot override the 'today' date — use the /date endpoint for arbitrary dates
- 503 or timeout if Railway.app hosting is temporarily unavailable
- Response schema may vary slightly if the underlying calendar data source has gaps for an unusual date

## How this service works

Vietnamese lunar calendar for TODAY (Asia/Ho_Chi_Minh): lunar date, Can Chi (heavenly stems & earthly branches in Vietnamese), hoang dao / hac dao day quality, activities the day is good for and bad for (wedding, moving, opening business...), auspicious hours (gio hoang dao) and solar term. Changes every day — perfect for daily briefing bots and horoscope agents serving Vietnamese users.

## Output

Returns today's full Vietnamese lunar calendar entry including: the lunar date (day, month, year), Can Chi for day/month/year in Vietnamese, day quality classification (hoang dao = auspicious / hac dao = inauspicious), a list of activities that are good to do today (e.g. wedding, moving, opening business), a list of activities to avoid, the auspicious hours (gio hoang dao) with their time ranges, and the current solar term — all anchored to today in the Asia/Ho_Chi_Minh timezone.

## 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",
     "properties": {}
    }
   },
   "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-lunar-calendar-today-2ead2039/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)