ApocData · A-Share AI Data Skill

English | 简体中文

> Zero-auth, zero-dependency. Use `curl` to call 45+ A-share data endpoints > (quotes / financials / fund flows / factors / announcements / macro). > Compatible with Claude, ChatGPT, Qwen, Kimi, DeepSeek and any AI agent > that supports tool calling.

The SKILL.md in this repository is a capability card that can be loaded directly into AI agents, letting LLMs query A-share market data and complete research tasks without any SDK.

---

Quick Try

Copy-paste and run, no config needed:

curl -s "https://www.apocdata.com/api/blade-dataplatform/open/data/quote?symbol=600519"

Click to expand sample response

{
  "code": 200, "success": true,
  "data": {
    "symbol": "600519", "name": "Kweichow Moutai",
    "close": 1528.00, "pct_chg": -0.52,
    "volume": 2856321, "delayed_minutes": 15
  }
}

Actual response has more fields; above is a simplified example.

---

Why ApocData?

	ApocData	tushare	akshare	iFinD
Auth	None	Paid token	Python env + install	Application approval
Setup steps	0	3+ (register → token → config)	2+ (pip + deps)	Manual review
AI Agent native	Skill + MCP	Plugin (legacy)	Not supported	Not supported
curl one-liner	Direct	Need SDK	Need SDK	Need SDK
A-share endpoints	45	100+ (paywalled)	100+ (free)	200+ (paid)
MCP support	46 tools	None	None	None

Comparison based on publicly available info as of 2026-08.

---

Table of Contents

• Overview
• Data Service Platform
• Installation
• Project Structure
• Basic Usage
• Endpoint Overview
• Editions & Capabilities
• Notes & Compliance

---

Overview

ApocData focuses on AI-native access to China's A-share market, designed for AI agents, quantitative research, investment content, and institutional applications. We provide unified endpoints for quotes, financials, fund flows, dragon-tiger boards, quantitative factors, macro indicators, and more.

---

Data Service Platform

Platform URL: https://www.apocdata.com

The data service platform is the unified entry point for ApocData. It provides:

• Open API (no auth) — This is what the Skill connects to. No registration, no token required. Ideal for quick experiments and lightweight usage.
• OpenAPI documentation & SDKs — Python / TypeScript supported.
• Platform editions (with API key) — Higher quotas, deeper history, lower latency, and richer data fields. See Editions & Capabilities.

The base URL used by this Skill: https://www.apocdata.com/api/blade-dataplatform/open/data

---

Installation

Quick Install (recommended)

mkdir -p ~/.claude/skills/apocdata
curl -sL https://github.com/ApocData/ApocData-skill/archive/refs/tags/v2.0.0.tar.gz \
  | tar xz -C ~/.claude/skills/apocdata --strip-components=1

Restart Claude Code and the skill will be auto-detected.

MCP Install (Claude Desktop / Cursor / ChatGPT)

{
  "mcpServers": {
    "apocdata": {
      "command": "npx",
      "args": ["-y", "@apocdata/mcp-server"]
    }
  }
}

OpenAPI Import (GPT Actions / Dify / Coze / n8n)

https://www.apocdata.com/api/blade-dataplatform/open/data/openapi.json

Import and use — no auth required.

Alternative: install script

curl -sL https://raw.githubusercontent.com/ApocData/ApocData-skill/v2.0.0/scripts/install.sh | bash

---

Project Structure

This Skill uses a multi-file structure for progressive loading — the entry SKILL.md is a slim router (~180 lines), and detailed endpoint specs are loaded on demand from the references/ directory:

├── SKILL.md                  # Entry point (slim router, ~180 lines)
├── README.md                 # This file (human-facing docs)
├── CHANGELOG.md              # Version history
├── references/               # On-demand reference docs (loaded per topic)
│   ├── boundaries.md         # Interface boundaries, headers, error codes, cache, freshness
│   ├── group-a-quote.md      # A. Quotes & Valuation (10 endpoints)
│   ├── group-b-financial.md  # B. Financials & Fundamentals (8 endpoints)
│   ├── group-c-capital.md    # C. Capital Flow (7 endpoints)
│   ├── group-d-limitup.md    # D. Limit-up & Sentiment (4 endpoints)
│   ├── group-e-events.md     # E. Events & Information (3 endpoints)
│   ├── group-f-sector.md     # F. Sectors & Concepts (4 endpoints)
│   ├── group-g-convertible.md # G. Convertible Bonds (2 endpoints)
│   ├── group-h-quant.md      # H. Quant & Technical (2 endpoints)
│   ├── group-i-macro.md      # I. Macro (3 endpoints)
│   ├── group-j-tools.md      # J. Tools (1 endpoint)
│   ├── group-k-agent.md      # K. Agent Enhanced (2 endpoints)
│   ├── examples.md           # Multi-endpoint analysis examples (5 scenarios)
│   └── safety-rules.md       # Financial output safety constraints (6 rules)
└── scripts/
    └── install.sh            # One-line install script

Why multi-file? A simple query like "what's the price of Moutai" only needs the entry SKILL.md + one reference file (~4K tokens), instead of loading the entire 47KB monolith (~15K tokens). This reduces token consumption by 70%+.

---

Basic Usage

All endpoints are HTTP GET, called with curl:

BASE="https://www.apocdata.com/api/blade-dataplatform/open/data"

# Get real-time quote
curl -s "$BASE/quote?symbol=000001"

# Get stock info (PE/PB/market cap)
curl -s "$BASE/stock?symbol=000001"

# Get comprehensive profile (8 dimensions in one call)
curl -s "$BASE/profile/full?symbol=688017"

---

Endpoint Overview

Group	Topic	Endpoints
A	Quotes & Valuation	10
B	Financials & Fundamentals	8
C	Capital Flow	7
D	Limit-up & Sentiment	4
E	Events & Information	2 (+ 1 deprecated)
F	Sectors & Concepts	4
G	Convertible Bonds	2
H	Quant & Technical	2
I	Macro	3
J	Tools	1
K	Agent Enhanced	2
Total		45 active (+ 1 deprecated)

---

Editions & Capabilities

ApocData is organized into four editions to match different use cases. All editions share the same API contract; capabilities are filtered by edition whitelist. This Skill defaults to the no-auth open endpoints. Upgrade to a platform edition with API key for higher quotas and deeper data.

Edition Lineup

SKU	Edition	Target Users
FREE	Free	Individuals / AI agent demos
PRO	Professional	Investment research / content creators
QUANT	Quant	Quantitative research teams
ENT	Enterprise	Institutional embedding / private deployment

Capability Comparison (selected)

Capability	Free	Pro	Quant	Enterprise
Daily calls	2,000	50,000	300,000	Custom
QPS limit	2	10	30	Custom
Snapshot latency	15 min	1 min	≤ 30s	Custom (≤ 10s)
Daily K depth	30 days	5 yrs + adj.	Full	Full
Quant factors	—	20	Full	Full + custom
MCP Tools	8	14	18	18+ custom
Availability SLO	best-effort	99.0%	99.5%	99.9% (contract)
Support	Community	Email 48h	Email 24h	Dedicated channel + phone

---

Endpoint Verification

Last verified: 2026-08-12 12:21 CST

Check	Result
Core endpoints tested	12/12 -> HTTP 200
Total active endpoints	45 (across 11 groups)
Avg latency	~217ms
Deprecated	/news (HTTP 410, documented in group-e)

Verified endpoints: quote, stock, daily, financial, moneyflow, hsgt, limit-list, announcements, concepts, macro/latest, calendar, profile/full. Full 45-endpoint coverage is validated via the scenario quick-reference table in SKILL.md.

---

Notes & Compliance

• All endpoints are read-only, no auth required
• Data source: ApocData Cloud (天启云), synced with A-share market data
• Free tier quotes have 15-minute delay (see delayed_minutes in response)
• Announcements: T+0 at 08:00; Northbound capital: 20:00
• This Skill is for research assistance only — not investment advice
• Financial output safety constraints are enforced via references/safety-rules.md

---

License

See LICENSE for details.