# CN Data – A-Share Earnings Appointment Schedule

> CN Data – A-Share Earnings Appointment Schedule is a paid API for AI agents from cn-data-x402.cn-data-x402-worker.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-16).

Returns the scheduled and actual earnings report disclosure dates for Shanghai, Shenzhen, and Beijing A-share listed companies, filterable by date range, stock symbol, and reporting period.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/appointment?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cn-data-a-share-earnings-appointment-schedule-6b1b5d92
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qAaaTXm8i1lhI1CPEmkYR

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-a-share-earnings-appointment-schedule-6b1b5d92
```

Example prompt: Pull the earnings disclosure appointment calendar for A-share stocks starting from today for the next 30 days, show up to 50 results, and focus on the 2026 Q3 report period ending 2026-09-30.

## When to prefer this

Use this endpoint when you need structured, machine-readable A-share earnings report disclosure schedules that are normally only available as Chinese-language web pages on financial portals. It is ideal for building earnings calendars, monitoring when specific companies will report, or scanning the full market for upcoming reporting events without requiring an API key or signup — just pay $0.02 USDC per call via the x402 protocol.

## Known failure modes

- Invalid or non-existent 6-digit stock symbol returns empty items array
- Date range exceeding 365 days or limit outside 1-300 triggers validation error
- report period not aligned to a quarter-end date (e.g. 2026-09-30) may return no results
- x402 payment not completed results in HTTP 402 response with payment instructions before data is returned
- Source data (东方财富 RPT_PUBLIC_BS_APPOIN) may have short delay vs real-time exchange filings

## 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: a list of earnings appointment records (each with stock code, company name, board, industry, report type, quarter label, appointment date, actual publish date, days until release, and change history), plus aggregate summaries grouped by date and report type, total matching count, published vs pending counts, and source attribution.

## 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": {
      "days": {
       "type": "integer",
       "description": "往后看几天 1-365，默认 30"
      },
      "from": {
       "type": "string",
       "description": "起始日期 YYYY-MM-DD，默认今天"
      },
      "limit": {
       "type": "integer",
       "description": "返回条数 1-300，默认 50"
      },
      "report": {
       "type": "string",
       "description": "报告期 YYYY-MM-DD，如 2026-09-30 锁定三季报"
      },
      "symbol": {
       "type": "string",
       "description": "6 位股票代码，查单只公司"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "to": "2026-11-13",
   "days": 30,
   "from": "2026-10-14",
   "items": [
    {
     "code": "000655",
     "name": "金岭矿业",
     "board": "深交所主板",
     "symbol": "000655.SZ",
     "daysAway": 0,
     "industry": "冶钢原料",
     "reportType": "2026年 三季报",
     "appointDate": "2026-10-14",
     "isPublished": true,
     "quarterLabel": "2026q3",
     "reportPeriod": "2026-09-30",
     "residualDays": null,
     "thirdChangeDate": null,
     "firstAppointDate": "2026-10-14",
     "secondChangeDate": null,
     "actualPublishDate": "2026-10-14"
    }
   ],
   "byDate": [
    {
     "count": 1,
     "appointDate": "2026-10-14"
    }
   ],
   "byType": [
    {
     "count": 1,
     "reportType": "2026年 三季报"
    }
   ],
   "source": "财报预约披露时间表来自东方财富数据中心公开接口（RPT_PUBLIC_BS_APPOIN），覆盖沪深北 A 股。",
   "symbol": null,
   "returned": 1,
   "pendingCount": 0,
   "totalMatching": 5574,
   "publishedCount": 1,
   "reportPeriodFilter": null
  },
  "endpoint": "/cn/appointment"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-a-share-earnings-appointment-schedule-6b1b5d92/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)