# CN Data – Chinese A-Share Institutional Research Visits

> CN Data – Chinese A-Share Institutional Research Visits 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 structured JSON records of institutional investor site visits and Q&A sessions with A-share listed companies, sourced from East Money's public investor relations database.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/research?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-a-share-institutional-research-visits-449f7e28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6EdA74M8gCNFF0S-RV1XW

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-a-share-institutional-research-visits-449f7e28
```

Example prompt: Pull the institutional research visit records for Chinese A-share stock 002807 over the last 7 days, including the full Q&A transcripts, and return up to 10 events.

## When to prefer this

Choose this endpoint when you need structured, machine-readable data on institutional investor research visits to Chinese A-share (Shanghai, Shenzhen, Beijing) listed companies. It is the right choice when the source is Chinese-language web pages from East Money that would otherwise require scraping. Prefer it over general web search when you need clean JSON output, filterable by stock symbol, date range, and number of results, with optional Q&A text inclusion.

## Known failure modes

- HTTP 402 returned on first call — expected; pay listed USDC amount on Base and retry
- Invalid date format returns error — must use YYYY-MM-DD
- Symbol not found or no visits in window returns empty events array
- days parameter out of range (must be 1–30) may return validation error
- limit parameter out of range (must be 1–20) may return validation error
- East Money upstream data may lag by 1–2 business days for very recent announcements

## 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 containing an array of research event records, each representing one consolidated institutional visit (merged from raw records by announcement ID). Each event includes: company name and 6-digit code, full stock symbol, reception date/time, meeting location, meeting format, list of visiting institutions and individual investigators, receptionist names, Q&A transcript text (if requested), character count of Q&A, number of raw records merged, and announcement ID. Also includes metadata: total matching records in the window, number scanned, number returned, time window boundaries, and data 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": {
      "date": {
       "type": "string",
       "description": "接待日 YYYY-MM-DD，如 2026-10-14，默认最近一个工作日窗口"
      },
      "days": {
       "type": "integer",
       "description": "时间窗天数 1-30，默认 3（带 symbol 时默认 7）"
      },
      "limit": {
       "type": "integer",
       "description": "返回场次 1-20，默认 10"
      },
      "symbol": {
       "type": "string",
       "description": "6 位股票代码，查单只公司，如 002807"
      },
      "content": {
       "type": "integer",
       "description": "是否带问答原文：1（默认）带、0 不带"
      }
     }
    }
   },
   "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": {
   "note": "一行原始记录＝一家机构的一次到访；同一个公告编号下的多行已合并成一场调研。一次最多扫描 50 条原始记录。",
   "events": [
    {
     "qa": "主要就江阴银行相关经营情况进行了交流,以下为本次调研问询及简要回复情况记录: 投资者关系活动主要内容介绍 问:1.江阴是\"制造业第一县\",请问制造业贷款的结构与增长指引? 答:……",
     "way": "特定对象调研",
     "code": "002807",
     "name": "江阴银行",
     "place": "江阴市澄江中路1号银信大厦2楼会议室",
     "symbol": "002807.SZ",
     "qaChars": 665,
     "noticeDate": "2026-10-15",
     "receiveDate": "2026-10-14",
     "receiveTime": "2026年10月14日14:00-15:30",
     "recordCount": 6,
     "institutions": [
      "中泰证券",
      "中金资管",
      "中庚基金",
      "泰康基金",
      "汇添富"
     ],
     "receptionist": "董事会秘书 邓宝国,计划财务部总经理 赵静怡,董办工作人员",
     "investigators": [
      "邓美君",
      "徐榕",
      "杨雪",
      "季怡轩"
     ],
     "announcementId": "AN202610151830482357",
     "attachmentType": "pdf",
     "objectTypeCodes": [
      "001"
     ],
     "institutionCount": 6
    }
   ],
   "source": "机构调研记录来自东方财富数据中心公开接口（RPT_ORG_SURVEY，投资者关系活动记录表），覆盖沪深北 A 股。",
   "symbol": null,
   "window": {
    "to": "2026-10-15",
    "days": 3,
    "from": "2026-10-13"
   },
   "returnedEvents": 1,
   "scannedRecords": 50,
   "contentIncluded": true,
   "totalMatchingRecords": 404
  },
  "endpoint": "/cn/research"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-chinese-a-share-institutional-research-visits-449f7e28/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)
