# CN Data Chinese Poetry

> CN Data Chinese Poetry is a paid API for AI agents from cn-data-x402.cn-data-x402-worker.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Returns a random classical Chinese poem as structured JSON, including a line, title, author, dynasty, tags, and full text.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/poetry?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cn-data-chinese-poetry-a6ebffed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OK9uNoIs18Jbb6kVmRXmx

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 cn-data-chinese-poetry-a6ebffed
```

Example prompt: Give me a random classical Chinese poem — I want the title, author, dynasty, a featured line, and the full text in JSON.

## When to prefer this

Choose this endpoint when you need structured, machine-readable classical Chinese poetry data without any API key or signup — ideal for agents that can handle x402 micropayments on Base. It is the right choice when you want random poem sampling with rich metadata (author, dynasty, tags, full text) rather than searching for a specific poem by title or keyword.

## Known failure modes

- HTTP 402 returned before payment is made — must pay 0.01 USDC on Base and retry
- Malformed or missing payment header causes repeated 402 responses
- Network timeouts reaching the Cloudflare Worker
- Occasionally sparse metadata if the source poem lacks tags or dynasty info

## How this service works

Chinese market and China-focused public data over the x402 protocol. No API key and no signup: call any endpoint, receive HTTP 402 with payment terms, pay the listed amount in USDC on Base and retry. Every response is JSON. Some Chinese-language sources are published only as web pages — these endpoints return them as clean, machine-readable JSON.

## Output

A JSON object with ok:true and a data field containing: a featured line (line), the poem title (title), author name (author), dynasty (dynasty), thematic tags array (tags), and the full poem text as an array of lines (fullText), plus the endpoint path.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "line": "西风酒旗市，细雨菊花天。",
   "tags": [
    "菊花",
    "秋",
    "风"
   ],
   "title": "秋怀",
   "author": "欧阳修",
   "dynasty": "宋代",
   "fullText": [
    "节物岂不好，秋怀何黯然！",
    "西风酒旗市，细雨菊花天。"
   ]
  },
  "endpoint": "/cn/poetry"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-chinese-poetry-a6ebffed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cn-data-x402.cn-data-x402-worker.workers.dev](https://www.zero.xyz/host/cn-data-x402.cn-data-x402-worker.workers.dev/llms.txt)