# Madoromi Dream Interpretation API

> Madoromi Dream Interpretation API is a paid API for AI agents from madoromi.fun, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Interprets a dream text and returns a 5-axis dream profile plus a long-form research-cited report in Japanese or English

## Facts

- Endpoint: POST https://madoromi.fun/api/agent/interpret/deep
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/madoromi-dream-interpretation-api-34a5bbe0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e_X-Fp6A1xqoHCUbEnbh1

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 madoromi-dream-interpretation-api-34a5bbe0 -d '<json body>'
```

Example prompt: Can you interpret my dream? I dreamed I was swimming in a dark ocean and suddenly a giant white whale appeared and followed me to shore — I want a full deep analysis with the 5-axis profile, in English.

## When to prefer this

Choose this endpoint when you need a structured, multi-dimensional dream interpretation (5-axis profile) with research-cited depth, rather than a simple one-sentence meaning lookup. It is ideal for agents building dream journals, wellness apps, or therapy-support tools that require academically grounded analysis. Prefer the async mode for most integrations to avoid timeout issues; use sync only if your client reliably supports 60s+ timeouts. Supports both Japanese and English output, making it uniquely suited for Japanese-language applications.

## Known failure modes

- Timeout on sync mode if client does not set a 60s+ timeout — recommend async mode for reliability
- Job ID not found or expired when polling /api/agent/interpret/result/{job_id} too early or too late
- Payment failure via x402 protocol resulting in 402 response before job is created
- Malformed or empty dream text input causing validation error
- Rate limiting or server overload returning 429 or 503

## How this service works

Japanese dream-interpretation agent API. Returns a deterministic 5-axis dream profile plus a long-form research-cited report (result schema agent-dream-insight.deep.v1). Japanese or English output. Dream text is never stored or logged. Async by default: the paid POST returns a job id in seconds; fetch the result with a plain free HTTP GET (no x402 client) at /api/agent/interpret/result/{job_id} (ready in ~20s). options.sync=true for one synchronous response (10-25s; client timeout 60s+).

## Output

An async job ID (returned in seconds) that resolves in ~20 seconds to a structured result containing a 5-axis dream profile and a long-form research-cited dream interpretation report. Output can be in Japanese or English. If sync mode is enabled, the full result is returned in one response within 10–25 seconds. Dream text is never stored or logged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "dream": {
   "type": "string",
   "maxLength": 2400,
   "minLength": 4
  },
  "options": {
   "type": "object",
   "properties": {
    "sync": {
     "type": "boolean"
    },
    "include_character": {
     "type": "boolean"
    }
   }
  },
  "persona": {
   "type": "string"
  },
  "output_language": {
   "enum": [
    "ja",
    "en"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/madoromi-dream-interpretation-api-34a5bbe0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from madoromi.fun](https://www.zero.xyz/host/madoromi.fun/llms.txt)