# CN Data – China A-Share Block Trade Data

> CN Data – China A-Share Block Trade Data 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 machine-readable block trade (大宗交易) records for Chinese A-share stocks, including deal price, premium/discount, buyer/seller seats, and volume, for a given trading date.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/block-trade?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-china-a-share-block-trade-data-44a386a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m_zydPAEYurvn2hL_cLmd

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-china-a-share-block-trade-data-44a386a6
```

Example prompt: Pull today's block trade data for Chinese A-shares, sorted by trade amount, and show me the top 20 deals including the buyer/seller seats and whether each traded at a premium or discount.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Chinese A-share block trade data including buyer/seller brokerage seat details, premium/discount ratios, and daily rankings — especially when the source is only available as a Chinese-language web page. Prefer it over manual scraping or generic financial data APIs that don't cover China's block trade market or don't expose seat-level detail.

## Known failure modes

- Invalid date format returns an error or empty dataset
- Stock symbol not found returns empty items array
- Date falls on a non-trading day resulting in no data
- Limit parameter outside 1-300 range may be clamped or rejected
- HTTP 402 returned on first call requiring USDC payment on Base before retry
- Upstream East Money data source temporarily unavailable

## 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 an 'ok' status flag and a 'data' field containing: the query date, sort field, and an array of block trade items each with stock code, name, symbol, buyer seat, seller seat, deal price, close price, trade amount in CNY, volume in shares, daily rank, change percent, turnover percent, premium ratio percent, and discount ratio percent. Also includes aggregate counts of premium vs discount trades and total matching records.

## 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": "排序：amount（成交额，默认）/ volume（成交量）/ premium（溢价率）"
      },
      "limit": {
       "type": "integer",
       "description": "返回条数 1-300，默认 50"
      },
      "symbol": {
       "type": "string",
       "description": "6 位股票代码，传了就只返回该股的大宗交易"
      },
      "direction": {
       "type": "string",
       "description": "默认 desc 从高到低，传 asc 反向"
      }
     }
    }
   },
   "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": {
   "date": "2026-10-09",
   "sort": "amount",
   "items": [
    {
     "code": "920415",
     "name": "恒拓开源",
     "symbol": "920415.BJ",
     "buyerSeat": "中信建投证券股份有限公司北京玉泉路证券营业部",
     "dailyRank": 1,
     "dealPrice": 5.98,
     "tradeDate": "2026-10-09",
     "amountYuan": 897000,
     "closePrice": 8.8,
     "sellerSeat": "中信建投证券股份有限公司北京京西分公司",
     "volumeShares": 150000,
     "changePercent": 3.0445,
     "turnoverPercent": 0.095107783367,
     "premiumRatioPercent": -0.320454545455,
     "discountRatioPercent": -29.976580796253
    }
   ],
   "source": "东方财富 数据中心（大宗交易，RPT_DATA_BLOCKTRADE）",
   "symbol": null,
   "returned": 1,
   "premiumCount": 20,
   "discountCount": 96,
   "totalMatching": 318,
   "returnedAmountYuan": 897000
  },
  "endpoint": "/cn/block-trade"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-china-a-share-block-trade-data-44a386a6/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)