# CN Data – Chinese Earnings Forecast

> CN Data – Chinese Earnings Forecast 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).

Retrieves Chinese A-share listed companies' earnings forecast (业绩预告) announcements as structured JSON, filterable by date, stock, report period, forecast type, and profit metric.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/earnings-forecast?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-chinese-earnings-forecast-b17763c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mf9F78_8BX6ZJo2jjSH71

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-earnings-forecast-b17763c2
```

Example prompt: Pull the latest Chinese A-share earnings forecast announcements from today, filtered to only 预增 (profit increase) type, sorted by change magnitude, and return up to 100 results.

## When to prefer this

Choose this endpoint when you need machine-readable Chinese A-share earnings forecast (业绩预告) data that would otherwise only be available as Chinese-language web pages on Eastmoney. It is ideal for screening across the full A-share universe by forecast type, filtering to a specific announcement date or report period, or drilling into a single stock's pre-announcement. It requires no API key — just USDC payment per call via x402.

## Known failure modes

- Invalid date format returns empty results or error
- Stock symbol not found returns empty items array
- Limit outside 1-300 range may cause validation error
- Payment not completed returns HTTP 402 with payment terms
- Unsupported forecast type string returns unfiltered or empty results
- Network timeout on the Cloudflare Worker edge

## 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

Returns a JSON object with an array of earnings forecast items, each containing the stock code, company name, forecast type (e.g. 预增/首亏), profit range in yuan (lower and upper bounds), year-over-year change percentages, announcement date, report period, previous year same-period profit, and the reason/statement text from the company. Also includes summary fields: total matching count, applied filters, metric type, and data source attribution (Eastmoney).

## 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": {
      "date": {
       "type": "string",
       "description": "公告日 YYYY-MM-DD"
      },
      "sort": {
       "type": "string",
       "description": "排序：notice（公告日倒序，默认）/ change（预告变动幅度）"
      },
      "type": {
       "type": "string",
       "description": "预告类型：预增 / 预减 / 略增 / 略减 / 扭亏 / 首亏 / 续盈 / 续亏 / 不确定"
      },
      "limit": {
       "type": "integer",
       "description": "返回条数 1-300，默认 50"
      },
      "metric": {
       "type": "string",
       "description": "口径：净利润（默认）/ all（连营业收入一起返回）"
      },
      "report": {
       "type": "string",
       "description": "报告期 YYYY-MM-DD，如 2026-09-30"
      },
      "symbol": {
       "type": "string",
       "description": "6 位股票代码，查单只股票的业绩预告，如 600519"
      }
     }
    }
   },
   "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": {
   "items": [
    {
     "code": "300505",
     "name": "川金诺",
     "type": "略减",
     "market": "深交所创业板",
     "metric": "归属于上市公司股东的净利润",
     "reason": "2026年前三季度营业收入同比上升,主要系产品销售价格上涨所致。…",
     "symbol": "300505.SZ",
     "direction": "reduction",
     "statement": "预计2026年1-9月归属于上市公司股东的净利润盈利:16,000万元至18,000万元,同比上年下降:40.87%至47.44%。",
     "noticeDate": "2026-10-10",
     "forecastYuan": 170000000,
     "reportPeriod": "2026-09-30",
     "amountLowerYuan": 160000000,
     "amountUpperYuan": 180000000,
     "changePercentLower": -47.44,
     "changePercentUpper": -40.87,
     "previousYearSamePeriodYuan": 304417700
    }
   ],
   "byType": {
    "略减": 1
   },
   "metric": "净利润",
   "source": "东方财富 数据中心（业绩预告，RPT_PUBLIC_OP_NEWPREDICT）",
   "symbol": null,
   "returned": 1,
   "noticeDate": null,
   "typeFilter": null,
   "reportPeriod": null,
   "totalMatching": 111141
  },
  "endpoint": "/cn/earnings-forecast"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-chinese-earnings-forecast-b17763c2/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)