# CN Data – Chinese Futures Market Quotes

> CN Data – Chinese Futures Market Quotes 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 real-time Chinese futures contract quotes (price, volume, open interest, change) for a given exchange, filterable by contract code.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/futures?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-futures-market-quotes-79bd159c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yj2uvvkdt1m3uIuYVjbeR

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-futures-market-quotes-79bd159c
```

Example prompt: Pull the top 30 most-traded futures contracts on the Shanghai Futures Exchange right now — I want to see prices, volume, and open interest for each, filtered to copper contracts if possible.

## When to prefer this

Choose this endpoint when you need machine-readable, real-time Chinese domestic futures quotes from any of the six major Chinese exchanges (SHFE, DCE, CZCE, INE, GFEX, CFFEX) without requiring an API key or signup. It is especially useful when the underlying Chinese-language web sources are otherwise inaccessible to automated systems. Prefer it over generic financial data APIs for China-specific commodity and index futures coverage.

## Known failure modes

- HTTP 402 returned before payment is made — agent must pay $0.02 USDC on Base and retry
- Invalid market code returns error or empty results
- Contract substring filter with no matches returns empty items array
- Exchange temporarily unavailable from upstream East Money API causing stale or missing data
- limit outside 1-200 range may be rejected or clamped

## 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 ok=true, containing an items array of futures contracts each with code, name, price, open, high, low, change, changePercent, volume, amountYuan, openInterest, and isMainContinuous flag; plus market metadata (exchange code, name, marketId), data source attribution, count of returned contracts, and total contracts available.

## 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": {
      "limit": {
       "type": "integer",
       "description": "返回条数 1-200，默认 20（按成交量从高到低）"
      },
      "market": {
       "type": "string",
       "description": "交易所：shfe（上期所，默认）/ dce（大商所）/ czce（郑商所）/ ine（能源中心）/ gfex（广期所）/ cffex（中金所），也可传中文名"
      },
      "contract": {
       "type": "string",
       "description": "按合约代码子串过滤，如 cu / rb / IC"
      }
     }
    }
   },
   "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": [
    {
     "low": 3065,
     "code": "rbm",
     "high": 3117,
     "name": "螺纹钢主连",
     "open": 3080,
     "price": 3097,
     "change": 17,
     "volume": 271754,
     "amountYuan": 84300000000,
     "openInterest": 1677048,
     "changePercent": 0.55,
     "isMainContinuous": true
    }
   ],
   "market": {
    "code": "SHFE",
    "name": "上海期货交易所",
    "marketId": 113
   },
   "source": "东方财富 期货行情（futsseapi）",
   "returned": 2,
   "totalContracts": 278
  },
  "endpoint": "/cn/futures"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-chinese-futures-market-quotes-79bd159c/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)
