# CN Data – Dragon Tiger Board (龙虎榜)

> CN Data – Dragon Tiger Board (龙虎榜) 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 China A-share Dragon Tiger Board (龙虎榜) institutional net-buy/sell rankings and the top five brokerage seats for a given trading day, parsed from Chinese public sources into machine-readable JSON.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/dragon-tiger?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-dragon-tiger-board-052d5995
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eZgwPEGUxJz5KjyI0hYhG

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-dragon-tiger-board-052d5995
```

Example prompt: Pull today's Dragon Tiger Board net-buy rankings for the top 30 Chinese A-shares, sorted by net buy amount, and include the brokerage seat details.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Dragon Tiger Board data from China's A-share markets without setting up an API key — particularly useful for agents that need to scan institutional net-buy/sell activity, identify abnormal trading stocks, or retrieve brokerage seat details for a specific ticker. It is superior to scraping East Money web pages directly because the response is already parsed into clean JSON. Use it over generic financial data APIs when the specific Dragon Tiger Board listing reason and brokerage seat granularity are required.

## Known failure modes

- HTTP 402 returned on first call — agent must pay $0.02 USDC on Base and retry
- Non-trading days return empty items array or an error indicating no data for that date
- Invalid stock symbol returns empty record set
- limit out of range (>200 or <1) may return validation error
- date parameter outside available history returns no data

## 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: the queried date and sort mode, an array of ranked stocks each with code, name, exchange, close price, net buy yuan, gross buy yuan, gross sell yuan, price change percent, listing reason, and institution mention count; plus aggregate totals for net buy/sell across all listed stocks, a breakdown by listing reason, and the data source attribution. When a symbol is specified, returns that stock's recent Dragon Tiger appearances and top five brokerage seats.

## 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": "排序：net（净买入，默认）/ amount（成交额）/ change（涨跌幅）"
      },
      "limit": {
       "type": "integer",
       "description": "返回条数 1-200，默认 20"
      },
      "seats": {
       "type": "string",
       "description": "传 0 时个股模式不返回买卖席位"
      },
      "symbol": {
       "type": "string",
       "description": "传 6 位股票代码时返回该股近期上榜记录 + 买卖前五营业部，如 002384"
      },
      "direction": {
       "type": "string",
       "description": "buy（净买入榜，默认）/ sell（净卖出榜）"
      }
     }
    }
   },
   "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-08",
   "sort": "net",
   "items": [
    {
     "code": "002384",
     "name": "东山精密",
     "rank": 1,
     "board": "深交所主板",
     "close": 150.66,
     "symbol": "SZ002384",
     "buyYuan": 1404425710.53,
     "netYuan": 370469486.14,
     "sellYuan": 1033956224.39,
     "listedReason": "日跌幅偏离值达到7%的前5只证券",
     "changePercent": -10,
     "interpretation": "3家机构卖出，成功率39.82%"
    }
   ],
   "source": "东方财富 数据中心（龙虎榜，公开数据）",
   "byReason": [
    {
     "count": 5,
     "reason": "日跌幅偏离值达到7%的前5只证券"
    }
   ],
   "returned": 1,
   "direction": "buy",
   "totalListed": 82,
   "netBuyTotalYuan": 3016484487.71,
   "netSellTotalYuan": -2089521383.4,
   "institutionMentioned": 41
  },
  "endpoint": "/cn/dragon-tiger"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-dragon-tiger-board-052d5995/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)