# RitMEX Bitcoin Calendar (黄历)

> RitMEX Bitcoin Calendar (黄历) is a paid API for AI agents from www.ritmex.one, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Returns a Bitcoin-themed traditional Chinese almanac (黄历/huangli) calendar entry, providing auspicious/inauspicious day guidance framed around crypto trading.

## Facts

- Endpoint: GET https://www.ritmex.one/x402/calendar
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ritmex-bitcoin-calendar-79286cce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K3IbWj0DFI5lR3huZSGBq

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 ritmex-bitcoin-calendar-79286cce
```

Example prompt: What does the RitMEX Bitcoin 黄历 calendar say for today — is it an auspicious day for crypto trading?

## When to prefer this

Use this endpoint when you need novelty or culturally-flavored daily Bitcoin/crypto trading guidance in the style of a traditional Chinese almanac (黄历). It is not a standard financial data feed — prefer it for entertainment, cultural crypto content, or when a user specifically asks about the Bitcoin calendar or 黄历.

## Known failure modes

- Payment not received (402 Payment Required) — x402 micropayment of $0.01 USDC must be sent before data is returned
- Service unavailable or endpoint returns error if the RitMEX backend is down
- Empty or malformed response if no calendar entry exists for the current date
- Network timeout if the host www.ritmex.one is unreachable

## How this service works

Access to calendar | 获取比特币黄历

## Output

Returns a Bitcoin-themed Chinese almanac (黄历) entry, likely including auspicious/inauspicious indicators, trading guidance phrases, and day-specific notes framed around Bitcoin or crypto market activity.

## Example request

```json
{
 "period": "monthly",
 "calendar_type": "bitcoin"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ritmex-bitcoin-calendar-79286cce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.ritmex.one](https://www.zero.xyz/host/www.ritmex.one/llms.txt)